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

顺亿

2026-10-12 • 👁 0人浏览过

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免费学习笔记（深入） ”； Comet AI 浏览器下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。下载如果你写的是跨平台库，不要依赖它；如果是纯 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

才触发解析，延迟可能影响错误收集时机。

相关文章