隨著單頁應用(SPA)普及,前端異常捕獲已成保障用戶體驗的必修課。本文系統梳理異常捕獲方式、信息收集策略、跨域腳本限制繞過方案,構建完整前端監控體系。
適用於明確可能拋錯的 API 調用、第三方回調執行:
// localStorage 寫入超額/隱私模式拋錯
try {
localStorage.setItem('date', Date.now());
} catch (error) {
reportError(error);
}
// 回調執行隔離:防止單個回調錯誤阻塞後續邏輯
listeners.forEach(function(listener) {
try {
listener();
} catch (error) {
reportError(error);
}
});
window.onerror = function(errorMessage, scriptURI, lineNumber, columnNumber, error) {
if (error) {
// 現代瀏覽器提供完整 Error 對象(第5參數)
reportError(error);
} else {
// 舊瀏覽器只有前3參數
reportError({
message: errorMessage,
script: scriptURI,
line: lineNumber,
column: columnNumber
});
}
};
關鍵點:
window.onerror,勿用 addEventListener('error')(標準草案定義的是 onerror)error 為完整 Error 對象(Chrome 30+、Firefox、Edge 支持),包含堆棧、自定義屬性name:錯誤類型(TypeError、ReferenceError 等)message:錯誤描述script/filename:腳本 URLline/lineno、column/colno:行列號stack:堆棧跟蹤字符串function normalizeError(err) {
return {
name: err.name,
message: err.message,
script: err.script || err.filename || err.sourceURL,
line: err.line || err.lineno,
column: err.column || err.colno,
stack: err.stack
};
}
需維護瀏覽器差異映射表,定期更新。
各瀏覽器 stack 格式不同,需編寫正則提取每幀:
可參考 stacktrace.js 等成熟庫。
window.onerror 早期僅 3 參數,屬性易丟失。技巧:自定義 Error 時將關鍵信息 JSON.stringify 進 message:
throw new Error(JSON.stringify({
type: 'API_ERROR',
code: 4001,
detail: { url: '/api/user', params: {id: 1} }
}));
// onerror 中反序列化
window.onerror = function(msg, ...args) {
try {
var parsed = JSON.parse(msg);
if (parsed.type) reportError(parsed);
} catch (e) {
// 非結構化錯誤,走常規上報
}
};
僅限主動拋出的 Error 生效。
CDN 腳本拋錯時,onerror 只收到 "Script error.",無堆棧、無行號。瀏覽器同源策略過濾了異源腳本詳情。
// 原始加載順序需保證
//
//
//
// 改造為調度器模式
function scheduleRemoteScript(url) { /* 下載 -> 內聯 script 標籤注入 */ }
function scheduleInlineScript(fn) { /* 存入隊列,等待依賴就緒後執行 */ }
// 頁面寫法
<script> scheduleRemoteScript('https://cdn.com/step1.js'); </script>
<script> scheduleInlineScript(function code() { step2(); }); </script>
<script> scheduleRemoteScript('https://cdn.com/step3.js'); </script>
實現要點:
XMLHttpRequest + CORS 獲取內容<script> 為同源,錯誤信息完整保留| 方案 | 優點 | 缺點 |
|---|---|---|
| CORS + 內聯注入 | 完整錯誤信息、保持 CDN 加速 | 需改造構建流程、調度器複雜 |
| 腳本同源部署 | 零改造 | 失去 CDN 加速、增加源站壓力 |
crossorigin="anonymous" + CORS 響應頭 |
標準化、瀏覽器原生支持 | 需 CDN 配置 CORS 頭、舊瀏覽器不支持 |
推薦:現代項目優先使用 <script crossorigin="anonymous"> + 服務端配置 Access-Control-Allow-Origin: *,簡單標準。
前端異常捕獲已從「有無」進入「精準定位、快速復現、關聯業務」的深水區。掌握 try-catch、window.onerror、unhandledrejection 三層防線,配合 Source Map、CORS、調度器等工程化手段,構建可觀測的前端質量體系。