萬盛學電腦網

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

JavaScript 異常處理完整指南:try-catch、throw、onerror 與 Error 物件深度解析

為什麼需要異常處理?

JavaScript 執行錯誤會中斷腳本執行,導致後續代碼失效、用戶介面凍結、白屏。妥善的異常處理能:優雅降級、記錄錯誤供除錯、提供用戶友善提示、防止敏感資訊洩露。

核心機制:try-catch-finally

try {
    // 可能拋出異常的代碼
    highRiskOperation();
} catch (error) {
    // 捕獲並處理異常
    console.error('操作失敗:', error.message);
    showUserFriendlyMessage('操作暫時不可用,請稍後再試');
} finally {
    // 無論是否異常都會執行(清理資源、關閉 loading 等)
    hideLoadingSpinner();
}

六大內建錯誤類型

錯誤類型觸發場景繼承自
EvalErroreval() 執行錯誤Error
RangeError數值超出有效範圍(如陣列長度為負)
ReferenceError引用未宣告變數
SyntaxError解析代碼語法錯誤(eval/Function 建構子)
TypeError型別不符(如 null.foo、非函數呼叫)
URIErrorencodeURI()/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同 messageIE

跨瀏覽器統一錯誤資訊提取


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);
        });
    });

生產環境最佳實踐清單

  1. 錯誤邊界:React `ErrorBoundary`、Vue `errorCaptured`、Angular `ErrorHandler`
  2. 錯誤上報:Sentry、LogRocket、Rollbar、自建 ELK
  3. 用戶體驗:友善提示、重試按鈕、離線檢測、自動恢復
  4. 來源映射:部署 Source Map 讓堆疊追蹤定位到原始碼
  5. 敏感資訊過濾:移除 stack 中的 token、密碼、PII
  6. 錯誤分級:Critical/Error/Warning/Info,不同級別不同處理流程
copyright © 萬盛學電腦網 all rights reserved