瀏覽器控制台的 console 物件提供了一整套除錯與效能分析工具,以下逐一說明常用方法。
在控制台輸出一段訊息。傳入多個參數時,輸出會以空格分隔。
第一個參數可以是含格式化占位符的字串,例如:
console.log("The %s jumped over %d tall buildings", animal, count);
也可以完全不用占位符,寫成下面這樣,兩種方式並且可以混用:
console.log(" The ", animal, " jumped over ", count, " tall buildings");
若使用了占位符但參數個數多於占位符數量,多餘的參數會以空格分隔附加在字串後面,例如:
console.log(" I am %s and I have: ", myName, thing1, thing2, thing3);
如果參數是一個 JavaScript 物件,控制台輸出的就不是純文字,而是一個可互動的超連結,點擊可查看該物件的 HTML、CSS、Script 與 DOM 資訊,也可以用 %o 來代替物件:
console.log(" Body tag is %o ", document.body);
常用格式化字串:
%s — 字串
%d、%i — 整數(數字型暫不支援)
%f — 浮點數(數字型暫不支援)
%o — 連結物件
輸出一段訊息,並附帶指向程式碼呼叫位置的超連結。如果直接在控制台輸入這行命令,不會出現連結,行為與 console.log() 相同。
輸出一段帶有「資訊」圖示的訊息,並附一個指向呼叫位置的連結。
輸出一段帶有「警告」圖示的訊息,並附一個指向呼叫位置的連結。
輸出一段帶有「錯誤」圖示的訊息,並附一個指向呼叫位置的連結。
測試表達式是否為真。若不為真,會在控制台寫入一條訊息並拋出異常。
以列表形式列出物件的所有屬性,效果有點類似查看 DOM 面板。
輸出一個 HTML 或 XML 元素的 XML 原始碼,畫面與 HTML 面板中看到的相近。
印出呼叫當下的 JavaScript 執行堆疊,內容具互動性。堆疊會列出各層函式以及傳入每個函式的引數值:點擊函式可跳到 Script 面板中的原始碼位置,點擊引數值則可在 DOM 或 HTML 面板中檢視。
輸出一段訊息並開啟一個嵌套區塊,區塊內的內容會縮排顯示,以 console.groupEnd() 結束。這個方法可以巢狀使用。
關閉最近一次由 console.group 開啟的區塊。
建立一個名為 name 的計時器。
停止同名計時器並印出所耗時間(毫秒)。
開啟 JavaScript 效能分析。若提供 title,該標題會顯示在分析報告開頭。
關閉效能分析並輸出報告。
印出該行程式被執行的次數。若提供 title,訊息中會一併顯示該標題,方便在多處呼叫時區分。
實務上,console.log 系列負責日常輸出,group 與 time 系列適合整理輸出結構與量測耗時,而 profile 則留給真正需要追效能瓶頸的場合。