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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
dir() static method
options.colors parameter
ExperimentalNon-standard
options.depth parameter
ExperimentalNon-standard
options.showHidden parameter
ExperimentalNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.

Siehe auch