前端開發者都知道 JavaScript 具備基本的異常處理能力:我們可以 throw new Error(),瀏覽器也會在呼叫 API 出錯時拋出例外。但絕大多數人從沒想過要把這些例外資訊收集起來。
過去這種心態說得通——腳本出錯就重新整理,使用者自己按 F5 就好了,瀏覽器不會崩潰,頁面重新載入後一切歸零。但在單頁應用(SPA)普及之後,這個假設不再成立:使用者可能填了十幾分鐘的表單、翻過幾十頁內容才走到當前狀態,一句「請重新整理」等於讓他全部重來。因此主動捕獲、上報並分析前端異常,已經是品質工程的必要環節。
自己寫的 throw new Error() 很好捕獲,因為位置我們一清二楚。真正麻煩的是瀏覽器 API 丟出的例外:有些在規格裡就明定會拋出,有些則是特定瀏覽器的實作差異或缺陷所致。前者能用 try-catch 攔住,後者只能靠全域監聽。
規格明確會拋例外的 API,就該包進 try-catch,避免整個程式進入非法狀態。window.localStorage 是典型例子——寫入資料超過容量上限會拋出 QuotaExceededError,Safari 的隱私模式底下 likewise 會失敗。
try {
localStorage.setItem('date', Date.now());
} catch (error) {
reportError(error);
}
另一個高頻場景是回呼函數。回呼的內容不受我們控制,品質良窳難料,裡面還可能呼叫其他會拋例外的 API。若不隔離,一個出錯的回呼會讓後續所有依賴它的程式碼一併停擺。
listeners.forEach(function (listener) {
try {
listener();
} catch (error) {
reportError(error);
}
});
window.onerror = function (errorMessage, scriptURI, lineNumber) {
reportError({ message: errorMessage, script: scriptURI, line: lineNumber });
};
這裡有個實務提醒:不要為了「更標準」而改用 window.addEventListener('error', ...) 或 IE 的 attachEvent。多數瀏覽器只實作了 window.onerror 這條路徑,規格草案定義的也是它,直接指定屬性最保險。
假設我們有一個 reportError 函數,負責把捕獲到的異常批次送到伺服器保存以便查詢。我們想收集的是:錯誤型別(name)、錯誤訊息(message)、腳本位址(script)、行號(line)、列號(column)、堆疊追蹤(stack)。
如果是 try-catch 捕到的,這些資訊都掛在 Error 物件上(主流瀏覽器皆支援),沒問題。但透過 window.onerror 捕獲時,傳統簽名只給三個參數,其餘資訊全部丟失。
如果 Error 物件是我們自己建立的,error.message 的內容就完全由我們掌控。把關注的屬性用 JSON.stringify 序列化後塞進 message,在 window.onerror 的第一個參數讀出來再反序列化即可(瀏覽器通常只會加上 "Uncaught Error: " 之類的前綴)。這招僅適用於自製的 Error。
瀏覽器廠商也知道這個限制,於是逐步擴充了簽名。IE 先把列號放在第四個參數(只有行號沒有列號總感覺不太對稱),Firefox 一度考慮把堆疊放在第五位,最後 Chrome 30 直接把整個 Error 物件放在第五個參數——想讀什麼屬性、甚至自訂屬性都可以。由於 Chrome 動作最快落地,規格草案也就跟著這樣定義了。
window.onerror = function (errorMessage, scriptURI, lineNumber, columnNumber, error) {
if (error) {
reportError(error);
} else {
reportError({
message: errorMessage,
script: scriptURI,
line: lineNumber,
column: columnNumber
});
}
};
前面提到的屬性名稱是以 Chrome 的命名為基準,但各家瀏覽器並不一致——同一個「腳本位址」,Chrome 叫 script,Firefox 叫 filename。因此還需要一層正規化函式,把不同名稱映射到統一欄位。
堆疊追蹤字串(stack)同樣如此:它是純文字,各家格式各異,需要維護一份正則對照表,從文字中逐幀抽出函式名(identifier)、檔案(script)、行號(line)與列號(column)。這份對照表需要人工維護,但隨著瀏覽器實作趨於穩定,成本並不高。
如果你見過訊息只有 Script error. 的錯誤,就知道問題所在。這是瀏覽器對跨來源(cross-origin)腳本的安全限制。
原因不難理解:假設某家網銀對已登入使用者回傳的 HTML 與匿名使用者不同,第三方網站就能把該網銀的網址塞進 script.src。HTML 無法被當成 JavaScript 解析,瀏覽器必然拋出例外,而這個第三方網站只要解析例外發生的位置與行號,就能推斷使用者是否已登入——這是一種側信道攻擊。
為了堵住這個漏洞,瀏覽器對跨來源腳本拋出的例外一律過濾,只留下不變的 Script error.,其他屬性全部抹除。諷刺的是,對稍有規模的網站而言,腳本放在 CDN 上、甚至直接引用公共 CDN 的 jQuery、Backbone,本就是常態,於是收集到的例外資訊大量失效。
繞過限制的正確做法是讓腳本回到同源狀態:為 <script> 加上 crossorigin="anonymous" 屬性,並由 CDN 回傳適當的 Access-Control-Allow-Origin 標頭。這樣瀏覽器就會認定該腳本符合 CORS 規範,例外資訊不再被過濾,完整的 message、行號、列號與堆疊都能取得。
若因歷史原因無法修改標頭,另一條路是自行用 XMLHttpRequest(同樣需要 CORS)把腳本內容取回,再動態建立 script 標籤執行。這種做法要注意兩件事:一是腳本之間若存在依賴關係,執行順序必須自行保證;二是原本以非同步方式載入的下一步驟,可能需要人為插入等待邏輯,避免它在依賴完成前就先跑起來。此外,若採用「多個腳本拼接後統一回報行號」的策略,記得在 reportError 中做一次行號反查,把回報的行號還原成實際檔案與行號。
前端異常處理的價值不在於語法,而在於形成閉環:try-catch 守住已知風險點、window.onerror 撈網全場、屬性正規化讓跨瀏覽器資料可比、CORS 讓資訊不再被安全機制吞掉,最後把資料送到能被查詢分析的地方。唯有具備這條鏈路,才能在使用者抱怨之前先發現問題。