最近參與的專案有一個特殊結構:管理介面的外框固定不重新整理,點選新頁面時只換掉一個 div 的內容,而且裡面不是 iframe,而是用 Ajax 把 HTML 塞進去。這帶來一個副作用——那些隨頁面一起被非同步載入的 JS 檔,在瀏覽器開發者工具的 Sources 面板裡完全看不到,自然無從中斷點。
只要在要除錯的 JS 檔最上面加上:
//@ sourceURL=msgprompt.js
一個要注意的細節:@ 與 sourceURL 之間必須有空格,中間不能緊貼。加上這行之後,該檔會以你指定的名稱出現在來源清單中,可以正常設中斷點、看呼叫堆疊。
Chrome 下的效果如下,檔案名稱就是註解裡寫的那個:

Firefox 同樣吃這套寫法,行為一致。相較於用 debugger 硬停在半路,sourceURL 的好處是不干擾程式流程,也不需要在程式碼裡留下除錯用的中斷敘述,加完記得在上線前移除即可。
補充一個相關技巧:若同一個檔案被載入多次而難以分辨,可以在 sourceURL 後面帶上版本或時間戳,例如 //@ sourceURL=msgprompt.js?v=3,來源清單裡就會各自獨立顯示。