調試能力在任何技術領域都是必備技能。掌握足夠的手段,就能快速定位問題、降低故障機率、釐清邏輯錯誤。在這個前端佔比越來越重的時代,如何降低開發成本、提升效率,很大程度取決於你會用幾種調試方法。以下依時代演進與功能別,把常用的 JS 調試技巧完整梳理一遍。
回到互聯網剛起步的年代,網頁以前端展示為主,瀏覽器腳本只能提供一些簡單的輔助功能,主流環境是 IE6,開發者工具幾乎不存在,唯一可用的手段就是 window.alert。

(上圖呈現的是較高版本 IE 中的效果,當年並沒有這麼完善的環境。)這種方式雖然原始,卻有它不可磨滅的價值,直到今天在某些場合仍然管用。
隨著 JS 在頁面中能承擔的事情越來越多,alert 的局限也越來越明顯:彈出的視窗樣式醜、會遮擋頁面內容、必須在程式邏輯裡插入 alert(xxx) 才能運作,而且它會阻斷頁面後續的渲染。這代表除錯完還得手動把這些程式碼清乾淨。
於是 Firefox、Chrome 乃至 IE 都相繼提供了 JS 調試控制台,可以用 console.log(xxx) 在控制台輸出資訊而不影響頁面顯示。

以 Chrome 為首的新一代瀏覽器更把 Console 擴充到相當豐富的程度。


那 console 的除錯程式碼需要清掉嗎?如果在呼叫前先做一次存在性判斷,留著其實不會破壞商業邏輯;但為了程式碼整潔,除錯完仍建議盡量移除這類與邏輯無關的語句。
斷點是調試器的核心功能之一,可以讓程式執行中斷在需要的地方以便分析。設定好斷點後,下次只要讓程式自動執行到該處就會停下來,省下大量反覆操作的時間。
JS 斷點調試就是在開發者工具中為程式碼標記位置,讓執行流停下來,方便檢視該段程式碼的狀態。以下用一段簡單的程式示範:定義一個函數,傳入兩個數,各自加上一個隨機整數後回傳總和。

從 console 的輸出看起來程式正常執行了,但由於其中掺了隨機數,我們其實無法確定過程是否如預期。若想驗證傳入的兩個數、被加的隨機數與最終總和,有兩種作法。
方法一,用 alert 或 console 把變數印出來:

這樣確實能看到整個計算過程,但缺點很明顯——得往程式碼裡塞好幾行與邏輯無關的語句。
方法二,改用斷點:

流程是:按 F12(或 Ctrl + Shift + I)開啟開發者工具 → 切到 Sources → 在左側檔案樹找到目標檔案 → 點擊行號。設定好之後重新整理頁面,程式跑到斷點會停下,此時 Sources 面板會列出當前作用域中所有變數與其值。
不過仔細看會發現,斷點停下的位置,a 與 b 已經完成加法運算了,我們看不到函數被呼叫時初始傳入的 10 與 20。要解決這個問題,得先認識 Sources 面板上那排功能鍵:

由左至右分別是:
有了這排按鈕,就能一行一行往下走,觀察每次執行後各變數的變化。

如上圖,a 與 b 從初始值、加上隨機值,到計算總和並輸出,整個過程一目了然。

補充幾點實務細節:直接在程式碼區顯示變數值是較新版本 Chrome 才有的功能,舊版可把游標移到變數名上短暫停留,或選取變數名後按右鍵選「Add to watch」在 Watch 面板查看,表達式也適用;另外也可以切到 Console 直接輸入變數名後按 Enter。
直接在程式碼中寫入 debugger;,執行到該句時就會自動中斷,後續操作與 Sources 斷點幾乎一致,只是除錯完記得把這行刪掉。
它存在的意義在於處理一種常見場景:非同步載入的 HTML 片段中掺有內嵌 JS,這段程式碼在 Sources 的檔案樹中找不到,無法直接下斷點,此時 debugger; 就派上用場。

DOM 斷點顧名思義是設在 DOM 元素上,而觸發後最終仍會落到 JS 邏輯裡。現代頁面的 JS 越寫越多,DOM 操作四處分布,當你已經能從 Elements 面板鎖定目標節點、卻不知道是哪段程式改動它時,DOM 斷點就特別有價值。

上圖示範了對 ul 的子節點做新增、刪除與排序交換時觸發斷點。要注意的是,修改子節點的屬性或內容不會觸發這個斷點。
很多時候我們會把暫存資料放在 DOM 元素的屬性上,HTML5 對自定義屬性(如 dataset、data-*)的支援更讓這種作法變得普遍,因此 Chrome 也提供了屬性變化斷點。

同樣要注意,操作子節點的屬性不會觸發父節點本身的斷點。
這個斷點的觸發條件很明確——節點被刪除,通常是執行 parentNode.removeChild(childNode) 的當下,實務上使用頻率不高。
除了上述幾種,開發者工具還提供更多斷點類型:

Ajax 驅動的富應用與單頁應用已是常態,而這一切背後都离不开 XMLHttpRequest。「XHR Breakpoints」正是為非同步請求而生的斷點功能。

點擊右側的「+」可以設定斷點條件,當非同步請求的 URL 符合條件時,程式碼會自動中斷,中斷位置在 xhr.send() 那一行。上圖之所以看不出效果,是因為示範用的是 jQuery 封裝過且已壓縮的 ajax 方法。
這個功能最強的地方在於能自訂規則,針對某一批、某一個乃至所有非同步請求下斷點。不過實務上使用比例不高,原因有兩個:一是這類需求本身不多;二是專案多已基於框架開發,Ajax 早被封裝良好,加上部署時通常使用壓縮後的程式碼,追蹤起來相對困難。
事件監聽器斷點依事件名稱中斷,觸發時會停在事件綁定的位置。它列出了頁面與腳本中所有事件類型,包含滑鼠、鍵盤、動畫、計時器、XHR 等,大幅降低了事件相關邏輯的除錯難度。

上圖示範了 click 事件被觸發時,以及 setTimeout 被設定時的斷點效果。勾選 click 之後,兩個按鈕被點擊都會中斷;勾選 Set Timer 後,設定計時器的當下即中斷。
調試不只幫我們快速定位問題,也直接影響開發時間。熟練掌握這些手段,對職涯的幫助不言可喻。但工具這麼多,關鍵在於依當前場景選對方法——這需要經驗,也需要在不斷嘗試中累積判斷力。