Node.js 應用運行時可能遇到多種類型的錯誤。理解這些錯誤的來源與捕獲方式,是我們做好錯誤處理與異常恢復的基礎。本文對 Node.js 中的錯誤類型做一個系統梳理。
Node.js 是一個 JavaScript 運行時平台,其應用中發生的錯誤本質上都是 Error 實例或其子類實例,主要分為四類:
EvalError、SyntaxError、RangeError、ReferenceError、TypeError、URIError 等,分別對應不同原因的語法或用戶 API 誤用。assert 模塊觸發。標準 JavaScript 錯誤由語言本身提供,表示語法錯誤或不當的 API 使用。自定義錯誤則可通過構造函數創建實例並用 throw 拋出:
throw new Error('出錯了,這是錯誤信息');
// Error: 出錯了,這是錯誤信息
// at repl:1:7 ...
錯誤對象通常包含兩個核心屬性:error.message 為錯誤信息,error.stack 為錯誤堆棧追蹤。除此之外,還可以掛上自定義屬性,例如給錯誤對象添加一個 status:
var error = new Error('您訪問的頁面不存在');
error.status = 404;
系統錯誤是對 JavaScript Error 對象的擴展,表示程序能夠處理的操作級錯誤。除 Error 的通用屬性外,它還包含:
error.syscall:記錄失敗的系統調用信息的字符串。error.errno:一個整數形式的錯誤碼。error.code:表示錯誤的字符串,通常以大寫字母 E 開頭。Node.js 採用事件驅動、異步編程機制,這意味著 try / catch 無法捕獲異步處理中發生的錯誤。針對這種情況,通常有以下兩種方式。
1. Node.js 式回調函數中的異常捕獲
Node.js 的眾多異步 API 通過回調函數進行後續處理。若發生錯誤,第一個參數會包含一個 Error 對象;若無錯誤則為 null:
const fs = require('fs');
fs.readFile('一個不存在的文件', (err, data) => {
if (err) {
console.error('讀取文件錯誤', err);
return;
}
// 其它處理
});
2. 基於事件的錯誤處理
如果對象是 EventEmitter,可以通過監聽其 'error' 事件來捕獲並處理錯誤:
const net = require('net');
const connection = net.connect('localhost');
// 為 stream 添加 'error' 事件處理器
connection.on('error', (err) => {
// 連接被重置或無法連接到服務器時,錯誤會傳到這裡
console.error(err);
});
connection.pipe(process.stdout);
以上就是對 Node.js 中幾類常見錯誤的梳理。理解標準錯誤、系統錯誤、自定義錯誤與斷言錯誤的差異,並掌握回調函數與事件兩種異步錯誤捕獲方式,才能寫出健壯可靠的 Node.js 應用。