javascript错误对象是什么_怎样自定义错误类型？

夜晨 2026-01-04 00:00:00 次阅读

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。

如果你写的是跨平台库，不要依赖它；如果是纯 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) 输出不可读，且破坏与现有监控工具的兼容性。

需要扩展输出时，新增方法即可，例如：