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 Aufklappdreiecken präsentiert, die es Ihnen ermöglichen, die Inhalte von Kind-Objekten einzusehen.

Anders als andere Protokollierungsmethoden versucht console.dir() nicht, das Objekt formatiert darzustellen. Wenn Sie zum Beispiel ein DOM-Element an console.dir() übergeben, wird es nicht wie im Element-Inspektor 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 von Eigenschaften. Wenn die Eigenschaft eine Funktion oder ein Objekt ist, wird ein Aufklappdreieck vorangestellt.

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

Syntax

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

Parameter

object

Ein JavaScript-Objekt, dessen Eigenschaften ausgegeben 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 stilisiert. Standardmäßig true.

depth Nicht standardisiert Optional

Eine Zahl, die die Anzahl der Verschachtelungsebenen repräsentiert, die gedruckt werden, 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 aufzählbaren und Symbol-Eigenschaften des Objekts angezeigt. Standardmäßig false.

Rückgabewert

Keine (undefined).

Spezifikationen

Specification
Console Standard
# dir

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch