JavaScript自定义错误类型详解

JavaScript中的错误处理远不止简单抛出字符串或数字，真正健壮、可调试、与工具链兼容的错误必须是继承自原生Error的实例——只有这样才能完整保留堆栈跟踪、类型标识和标准化接口；文章深入剖析了正确创建自定义错误的核心实践：始终使用class继承Error、务必调用super(message)以确保stack生成、合理设置name和扩展属性（如code、field），同时警示常见陷阱——避免throw非Error值导致调试信息丢失、禁用重写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) 输出不可读，且破坏与现有监控工具的兼容性。

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

• 加 toJSON() 用于序列化上报
• 加 getDetails() 返回结构化诊断信息
• 不要重写 toString() 或 message setter

复杂点在于：很多团队会把自定义错误当“数据载体”塞一堆字段，结果忘了 stack 是惰性生成的——在某些打包配置（如 Webpack 的 eval-source-map）下，首次访问 stack 才触发解析，延迟可能影响错误收集时机。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《JavaScript自定义错误类型详解》文章吧，也可关注golang学习网公众号了解相关技术文章。