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 Browser-Konsolen wird die Ausgabe als hierarchische Liste mit Aufklappdreiecken dargestellt, über die Sie die Inhalte von Kinderobjekten einsehen können.

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

Ein Screenshot der Firefox-Konsole, in dem 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 abhängig von ihrem Typ gestylt. Standardmäßig true.

depth Nicht standardisiert Optional

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

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
Console
# dir

Browser-Kompatibilität

Siehe auch