除錯是前端開發的日常,而 console 物件就是我們與瀏覽器溝通最直接的一座橋樑。多數人只會用 console.log(),其實這個物件底下還藏著十來個方法,用對了能讓除錯效率翻倍。以下把常用方法逐一梳理清楚。
語法為 console.log(object[, object, ...]),在控制台印出一段訊息。若傳入多個參數,它們會以空格分隔串接。
第一個參數可以是帶有格式化占位符的字串:
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 | 連結物件(可展開檢視) |
輸出訊息,並附上一個指向呼叫位置的連結。如果直接在控制台手動輸入這行指令,就不會出現連結——行為與 log() 相同。
輸出帶有「資訊」圖示的訊息,同樣附帶呼叫位置的連結,適合標示流程中的關鍵節點。
輸出帶有「警告」圖示的訊息。它不會中斷程式,但能在訊息列表中醒目地標示出潛在風險。
輸出帶有「錯誤」圖示的訊息,是四個層級中最嚴重的一種,通常搭配例外處理使用。
語法為 console.assert(expression[, object, ...])。它會測試 expression 是否為真;若為假,就在控制台寫入一條訊息並拋出異常。這比寫 if 判斷再印訊息來得乾淨。
以樹狀列表的形式列出物件的所有屬性,呈現方式與檢視 DOM 面板相當接近,特別適合探查複雜的巢狀結構。
印出 HTML 或 XML 節點的標記原始碼,效果等同在 Elements 面板中看到的樣子。
印出呼叫當下的互動式呼叫堆疊。它會列出堆疊上的每一層函式,以及傳入各函式的引數值;點擊函式可跳到對應的原始碼位置,點擊引數值則能進一步檢視其內容。追蹤「這個函式到底是誰叫的」時非常好用。
console.group(object[, object, ...]) 會輸出一條訊息並開啟一個可嵌套的區塊,區塊內的內容自動縮排;呼叫 console.groupEnd() 關閉最近開啟的那個區塊。大量日誌需要分組歸類時,這個組合能讓輸出層次分明。
console.time(name) 建立一個名為 name 的計時器;console.timeEnd(name) 停止計時並印出耗時(毫秒)。想量化一段程式碼的執行成本,這是比手動記錄 Date.now() 更直覺的做法。
console.time("loop");
for (var i = 0; i < 100000; i++) { /* ... */ }
console.timeEnd("loop");
熟練掌握這些方法,能讓你在不額外引入除錯工具的情況下,就完成大部分問題的定位。建議依訊息性質挑選層級:一般流程用 log、可疑之處用 warn、確定異常用 error,並善用 group 與 time 讓輸出保持可讀。