萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JS 高級調試技巧:捕獲與分析 JavaScript 錯誤全方位指南

單頁應用 (SPA) 運行時間長、狀態複雜,使用者刷新頁面意味著操作重做。捕獲、分析運行時錯誤已成為前端工程必修課。本文系統梳理 try-catch、window.onerror、unhandledrejection 三大捕獲通道,深入解析錯誤物件屬性正規化、堆疊追蹤解析、跨域腳本 Script error. 限制與 CORS 繞過、Source Map 反向映射等進階主題。

錯誤捕獲三大通道

1. try-catch:已知風險點防護

// 適用場景:已知可能拋錯的 API、回調函數防護
try {
  localStorage.setItem('key', largeData); // 配額超限拋錯
} catch (error) {
  reportError(error);
}

// 回調防護:防止回調錯誤阻斷後續邏輯
listeners.forEach(listener => {
  try { listener(); } 
  catch (error) { reportError(error); }
});

2. window.onerror:全域同步錯誤捕獲

// 標準簽名(HTML Living Standard)
window.onerror = function(message, source, lineno, colno, error) {
  if (error) {
    reportError(error); // 現代瀏覽器提供完整 Error 物件(第5參數)
  } else {
    reportError({ message, source, lineno, colno }); // 舊瀏覽器降級
  }
  return true; // 防止瀏覽器預設處理(部分瀏覽器)
};

⚠️ 不要用 addEventListener('error', ...) 監聽 window.onerror,標準只定義 onerror 屬性。

3. unhandledrejection:Promise 拒絕捕獲

window.addEventListener('unhandledrejection', function(event) {
  reportError(event.reason); // reason 通常是 Error 物件
  event.preventDefault(); // 防止瀏覽器預設警告
});

錯誤物件屬性正規化

各瀏覽器 Error 物件屬性命名不一致:

標準屬性ChromeFirefoxSafariEdge/IE
messagemessagemessagemessagemessage
namenamenamenamename
stackstackstackstackstack
檔案/腳本script / filenamefileName / sourceURLsourceURLscript
行號line / linenolineNumber / linenolineline
列號column / colnocolumnNumber / colnocolumncolumn

正規化工具函數

function normalizeError(error) {
  const normalized = {
    name: error.name || 'Error',
    message: error.message || String(error),
    stack: error.stack || '',
  };
  
  // 檔案路徑正規化
  normalized.file = error.fileName || error.sourceURL || error.script || '';
  normalized.line = error.lineNumber || error.lineno || error.line || 0;
  normalized.column = error.columnNumber || error.colno || error.column || 0;
  
  return normalized;
}

堆疊追蹤解析:統一幀格式

各瀏覽器 stack 字串格式不同:

  • V8 (Chrome/Node): at FunctionName (file:line:col)
  • SpiderMonkey (Firefox): FunctionName@file:line:col
  • JavaScriptCore (Safari): FunctionName@file:line
// 簡易解析器範例
const STACK_FRAME_REGEX = {
  chrome: /at\s+(.+?)\s+\((?:(.+?):(\d+):(\d+)|(.+?):(\d+):(\d+))\)/,
  firefox: /(.+)@(.+):(\d+):(\d+)/,
  safari: /(.+)@(.+):(\d+)/
};

function parseStack(stack) {
  // 實作省略:需維護正則映射表,提取 function、file、line、column
  return frames; // [{function, file, line, column}, ...]
}

跨域腳本限制:Script error. 之謎

原因:瀏覽器安全策略,不同源腳本拋出的錯誤被過濾,只剩 Script error.,堆疊、檔案、行號全丟失。

解決方案:CORS + crossorigin

  1. CDN 伺服器回應 Header:Access-Control-Allow-Origin: * (或特定域名)
  2. 腳本標籤加屬性:<script src="https://cdn.example.com/app.js" crossorigin="anonymous"></script>

滿足兩條件後,跨域錯誤將包含完整資訊。

Source Map 反向映射:還原原始碼位置

生產環境代碼經壓縮、混淆、打包,行號失真。Source Map 映射 (生成碼行, 生成碼列) → (源碼行, 源碼列, 源檔案)。

行號反查原理(簡化版)

// 假設打包時每檔案分配 1000 行區間
// step1.js: 1-1000, step2.js: 1001-2000, step3.js: 2001-3000

function mapLineToSource(bundleLine) {
  if (bundleLine <= 1000) return { file: 'step1.js', line: bundleLine };
  if (bundleLine <= 2000) return { file: 'step2.js', line: bundleLine - 1000 };
  if (bundleLine <= 3000) return { file: 'step3.js', line: bundleLine - 2000 };
  return { file: 'unknown', line: bundleLine };
}

// 實際專案用 source-map 庫
const sourceMap = require('source-map');
const consumer = await new sourceMap.SourceMapConsumer(rawSourceMap);
const original = consumer.originalPositionFor({ line: bundleLine, column: bundleColumn });
// original: { source: 'src/step3.js', line: 5, column: 10, name: 'handler' }

錯誤上報系統架構建議

// 1. 統一入口
function reportError(error) {
  const normalized = normalizeError(error);
  const enriched = enrichContext(normalized); // 加入用戶、版本、URL、UserAgent
  const parsed = parseStack(enriched.stack);  // 解析堆疊
  const mapped = mapToSource(parsed);         // Source Map 映射
  sendToServer(mapped);                       // 批量上報
}

// 2. 批量發送,避免阻塞
const queue = [];
setInterval(() => {
  if (queue.length) {
    navigator.sendBeacon('/api/errors', JSON.stringify(queue.splice(0)));
  }
}, 5000);

總結:前端錯誤監控清單

  1. ✅ 部署 window.onerror + unhandledrejection
  2. ✅ 關鍵路徑加 try-catch 防護
  3. ✅ CDN 腳本啟用 CORS + crossorigin
  4. ✅ 建置產出 Source Map,上報時反向映射
  5. ✅ 錯誤去重、採樣、敏感資訊過濾
  6. ✅ 告警閾值、儀表板、版本對比

建立完善的錯誤觀測體系,是前端工程化邁向成熟的關鍵一步。

copyright © 萬盛學電腦網 all rights reserved