console: dir() statische Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die statische Methode console.dir() zeigt eine Liste der Eigenschaften des angegebenen JavaScript-Objekts an. In Browserkonsolen wird die Ausgabe als hierarchische Liste mit Aufklapppfeilen dargestellt, die es Ihnen ermöglichen, den Inhalt von untergeordneten Objekten anzuzeigen.

Im Gegensatz zu anderen Logging-Methoden versucht console.dir() nicht, das Objekt ansprechend zu formatieren. Wenn Sie beispielsweise ein DOM-Element an console.dir() übergeben, wird es nicht wie im Elementinspektor angezeigt, sondern es wird eine Liste der Eigenschaften gezeigt.

Ein Screenshot der Firefox-Konsole, in der console.dir(document.location) ausgeführt wird. Wir sehen die URL der Seite, gefolgt von einem Block mit Eigenschaften. Wenn die Eigenschaft eine Funktion oder ein Objekt ist, wird ein Aufklapppfeil vorangestellt.

In Laufzeitumgebungen wie Node und Deno, wo die Konsolenausgabe im Terminal erfolgt und daher nicht interaktiv ist, bietet der Parameter options eine Möglichkeit, die Darstellung des Objekts anzupassen.

Syntax

js
console.dir(object)
console.dir(object, options)

Parameter

object

Ein JavaScript-Objekt, dessen Eigenschaften gedruckt werden sollen.

options Optional

Ein Objekt mit den folgenden Eigenschaften, alle optional:

colors Nicht standardisiert Optional

Ein boolescher Wert: Wenn true, werden die Eigenschaften des Objekts entsprechend ihrem Typ gestaltet. Standardmäßig true.

depth Nicht standardisiert Optional

Eine Zahl, die die Anzahl der Ausführungsstufen angibt, wenn ein Objekt andere Objekte oder Arrays enthält. Der Wert null bedeutet: alle Ebenen drucken. Standardmäßig 2.

showHidden Nicht standardisiert Optional

Ein boolescher Wert: Wenn true, werden die nicht enumerierbaren und symbolischen Eigenschaften des Objekts gedruckt. Standardmäßig false.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
Console
# dir

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch