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 console.dir() statische Methode zeigt eine Liste der Eigenschaften des angegebenen JavaScript-Objekts an. In Browserkonsolen wird die Ausgabe als hierarchische Liste mit aufklappbaren Dreiecken präsentiert, die es Ihnen ermöglichen, die Inhalte von Kindobjekten zu sehen.

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

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 aufklappbares Dreieck vorangestellt.

In Laufzeiten wie Node und Deno, bei denen die Konsolenausgabe auf 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 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 formatiert. Standardwert ist true.

depth Nicht standardisiert Optional

Eine Zahl, die die Anzahl der Nested Levels angibt, die gedruckt werden sollen, wenn ein Objekt andere Objekte oder Arrays enthält. Der Wert null bedeutet: alle Ebenen drucken. Standardwert ist 2.

showHidden Nicht standardisiert Optional

Ein boolescher Wert: wenn true, werden auch nicht aufzählbare und Symbol-Eigenschaften des Objekts gedruckt. Standardwert ist false.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
Console Standard
# dir

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch