為什麼需要異常處理?
JavaScript 執行錯誤會中斷腳本執行,導致後續代碼失效、用戶介面凍結、白屏。妥善的異常處理能:優雅降級、記錄錯誤供除錯、提供用戶友善提示、防止敏感資訊洩露。
核心機制:try-catch-finally
try {
// 可能拋出異常的代碼
highRiskOperation();
} catch (error) {
// 捕獲並處理異常
console.error('操作失敗:', error.message);
showUserFriendlyMessage('操作暫時不可用,請稍後再試');
} finally {
// 無論是否異常都會執行(清理資源、關閉 loading 等)
hideLoadingSpinner();
}
六大內建錯誤類型
| 錯誤類型 | 觸發場景 | 繼承自 |
EvalError | eval() 執行錯誤 | Error |
RangeError | 數值超出有效範圍(如陣列長度為負) |
ReferenceError | 引用未宣告變數 |
SyntaxError | 解析代碼語法錯誤(eval/Function 建構子) |
TypeError | 型別不符(如 null.foo、非函數呼叫) |
URIError | encodeURI()/decodeURI() 參數無效 |
手動拋出異常
// 拋出內建錯誤類型
function validateAge(age) {
if (typeof age !== 'number') throw new TypeError('年齡必須是數字');
if (age < 0) throw new RangeError('年齡不能為負數');
if (age > 150) throw new RangeError('年齡超出合理範圍');
return true;
}
// 拋出自訂錯誤(ES2015+ class extends Error)
class ValidationError extends Error {
constructor(message, field) {
super(message);
this.name = 'ValidationError';
this.field = field;
// 保持堆疊追蹤 (V8/現代引擎)
if (Error.captureStackTrace) Error.captureStackTrace(this, ValidationError);
}
}
function validateForm(data) {
if (!data.email) throw new ValidationError('Email 為必填', 'email');
if (!/^\S+@\S+\.\S+$/.test(data.email)) throw new ValidationError('Email 格式錯誤', 'email');
}
捕獲時判斷錯誤類型
try {
validateForm(formData);
} catch (e) {
if (e instanceof ValidationError) {
// 業務邏輯驗證錯誤:顯示欄位提示
highlightField(e.field, e.message);
} else if (e instanceof TypeError || e instanceof RangeError) {
// 程式邏輯錯誤:記錄供開發者除錯
logError(e);
showGenericError('資料格式有誤');
} else {
// 未預期錯誤:上報錯誤追蹤系統
reportToSentry(e);
showGenericError('系統錯誤,請聯繫客服');
}
}
全域錯誤捕獲:window.onerror / window.addEventListener('error')
// 老式寫法(回傳 true 防止預設錯誤提示)
window.onerror = function(message, source, lineno, colno, error) {
logError({ message, source, lineno, colno, stack: error?.stack });
return true; // 阻止瀏覽器預設行為
};
// 現代標準寫法(捕獲未處理的 Promise rejection 另需 unhandledrejection)
window.addEventListener('error', function(event) {
// event: ErrorEvent { message, filename, lineno, colno, error }
logError(event.error);
});
// 未捕獲的 Promise 拒絕
window.addEventListener('unhandledrejection', function(event) {
// event: PromiseRejectionEvent { promise, reason }
logError(event.reason);
event.preventDefault(); // 防止瀏覽器在控制台顯示警告
});
Error 物件屬性完整對照
| 屬性 | 說明 | 支援環境 |
name | 錯誤類型名稱 (TypeError, ReferenceError...) | 所有 |
message | 錯誤描述字串 | 所有 |
stack | 堆疊追蹤字串(含檔案、行號、函數) | V8/SpiderMonkey/JavaScriptCore (現代瀏覽器/Node) |
fileName | 發生錯誤的檔案名 | Firefox (SpiderMonkey) |
lineNumber | 發生錯誤的行號 | Firefox |
columnNumber | 發生錯誤的欄號 | Firefox |
number | 錯誤代碼 (HRESULT) | IE (舊版) |
description | 同 message | IE |
跨瀏覽器統一錯誤資訊提取
function extractErrorInfo(error) {
if (!error) return { message: 'Unknown error' };
var info = {
name: error.name || 'Error',
message: error.message || String(error),
stack: error.stack || ''
};
// Firefox 專有屬性
if (error.fileName) info.fileName = error.fileName;
if (error.lineNumber) info.lineNumber = error.lineNumber;
if (error.columnNumber) info.columnNumber = error.columnNumber;
// IE 專有
if (error.number) info.number = error.number & 0xFFFF;
if (error.description) info.description = error.description;
return info;
}
// 使用
try { risky(); }
catch (e) {
console.log(extractErrorInfo(e));
sendToLoggingServer(extractErrorInfo(e));
}
異步代碼異常處理
// Promise 鏈
fetchData()
.then(process)
.catch(handleError); // 捕獲前者任何環節的拒絕
// async/await (try-catch 同步寫法)
async function handleUserAction() {
try {
var data = await fetchData();
await process(data);
} catch (error) {
handleError(error);
}
}
// 並行任務:任一失敗即停止
Promise.all([task1(), task2(), task3()])
.then(results => { /* 全部成功 */ })
.catch(handleError); // 任一失敗
// 並行任務:等待全部完成(成功或失敗)
Promise.allSettled([task1(), task2(), task3()])
.then(results => {
results.forEach((r, i) => {
if (r.status === 'fulfilled') console.log('Task', i, 'ok:', r.value);
else console.error('Task', i, 'failed:', r.reason);
});
});
生產環境最佳實踐清單
- 錯誤邊界:React `ErrorBoundary`、Vue `errorCaptured`、Angular `ErrorHandler`
- 錯誤上報:Sentry、LogRocket、Rollbar、自建 ELK
- 用戶體驗:友善提示、重試按鈕、離線檢測、自動恢復
- 來源映射:部署 Source Map 讓堆疊追蹤定位到原始碼
- 敏感資訊過濾:移除 stack 中的 token、密碼、PII
- 錯誤分級:Critical/Error/Warning/Info,不同級別不同處理流程