console: dir() 靜態方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用。

console.dir() 靜態方法會顯示指定 JavaScript 物件的屬性列表。在瀏覽器控制檯中,輸出以分層列表的形式呈現,帶有展開三角形,可以讓你檢視子物件的內容。

與其他日誌記錄方法不同,console.dir() 不會嘗試美化列印物件。例如,如果你將一個 DOM 元素傳遞給 console.dir(),它不會像在元素檢查器中那樣顯示,而是會顯示屬性列表。

A screenshot of the Firefox console where console.dir(document.location) is run. We can see the URL of the page, followed by a block of properties. If the property is a function or an object, a disclosure triangle is prepended.

NodeDeno 等執行時環境中,控制檯輸出會進入終端,因此不是互動式的,options 引數提供了一種自定義物件顯示方式的方法。

語法

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

引數

object

一個屬性應該被列印的 JavaScript 物件。

options 可選

一個具有以下屬性的物件,所有屬性都是可選的

colors 非標準 可選

一個布林值:如果為 true,則根據物件的型別為其屬性著色。預設為 true

depth 非標準 可選

一個數字,表示當物件包含其他物件或陣列時要列印的巢狀級別數。值為 null 表示:列印所有級別。預設為 2。

showHidden 非標準 可選

一個布林值:如果為 true,則列印物件的非列舉屬性和符號屬性。預設為 false

返回值

無(undefined)。

規範

規範
控制檯
# dir

瀏覽器相容性

另見