JavaScript 错误对象必须是 Error 实例,非实例会导致堆栈丢失、工具链无法识别;推荐用 class 继承 Error 并调用 super(message),正确设置 name 和扩展属性;避免重写 toString(),Node.js 可选 Error.captureStackTrace 但不跨平台。

JavaScript 错误对象是 Error 实例,不是字符串或普通对象
当你写 throw "oops" 或 throw 42,虽然语法合法,但丢失了堆栈、类型标识和标准化接口。真正可被 catch 合理处理的错误,必须是继承自 Error 构造函数的实例。浏览器和 Node.js 的异常捕获机制(包括 try/catch、window.onerror、process.on("uncaughtException"))都依赖 instanceof Error 判断。
常见误区:以为只要 throw 出去就是“错误”。实际中,非 Error 值会让调试信息缺失,工具链(如 Sentry、Chrome DevTools)无法正确归类或展开堆栈。
用 class 继承 Error 自定义错误类型最可靠
ES6 起推荐用 class 语法继承 Error,它能正确保留 stack 和 name,且兼容所有环境(包括 TypeScript 编译输出)。不要用函数构造 + Object.setPrototypeOf 手动模拟,容易漏掉 stack 初始化。
-
super(message)必须调用,否则this.stack不会生成 - 手动设置
this.name = "MyError",否则默认为"Error" - 若需额外属性(如
code、status),在super()后赋值
class ValidationError extends Error {
constructor(message, field) {
super(message);
this.name = "ValidationError";
this.field = field;
this.code = "VALIDATION_FAILED";
}
}
// 使用
throw new ValidationError("Email is required", "email");
Error.captureStackTrace 是 Node.js 特有优化,浏览器不支持
Node.js 提供 Error.captureStackTrace(targetObject, Constructor),用于定制 stack 的起始位置(比如隐藏内部辅助函数)。但它只在 V8 环境有效,浏览器中调用会报 TypeError: Error.captureStackTrace is not a function。
立即学习“Java免费学习笔记(深入)”;
如果你写的是跨平台库,不要依赖它;如果是纯 Node.js 服务,可用它精简堆栈:
class DatabaseError extends Error {
constructor(message) {
super(message);
this.name = "DatabaseError";
// 只在 Node.js 中生效
if (typeof Error.captureStackTrace === "function") {
Error.captureStackTrace(this, DatabaseError);
}
}
}
自定义错误要避免覆盖原生行为,尤其是 toString()
原生 Error.prototype.toString() 返回 "${name}: ${message}",这是控制台打印和日志系统默认依赖的格式。如果重写它返回纯消息或 JSON 字符串,会导致 console.error(myError) 输出不可读,且破坏与现有监控工具的兼容性。
需要扩展输出时,新增方法即可,例如:
- 加
toJSON()用于序列化上报 - 加
getDetails()返回结构化诊断信息 - 不要重写
toString()或messagesetter
复杂点在于:很多团队会把自定义错误当“数据载体”塞一堆字段,结果忘了 stack 是惰性生成的——在某些打包配置(如 Webpack 的 eval-source-map)下,首次访问 stack 才触发解析,延迟可能影响错误收集时机。











