JavaScript 自定义错误处理：从 Error 类继承与扩展

JavaScript 自定义错误处理：从 Error 类继承与扩展

ru.javascript.info Современный учебник JavaScript 项目地址: https://gitcode.com/gh_mirrors/ru/ru.javascript.info

在 JavaScript 开发中，错误处理是构建健壮应用程序的关键部分。本文将深入探讨如何创建自定义错误类，以及如何通过继承 Error 类来构建复杂的错误处理体系。

为什么需要自定义错误类

在开发复杂应用时，内置的 Error 类往往不能满足我们的需求。不同的业务场景需要不同类型的错误：

• 网络请求失败需要 HttpError
• 数据库操作异常需要 DbError
• 资源未找到需要 NotFoundError

自定义错误类不仅能携带标准错误属性（message、name、stack），还能添加特定业务属性，如 HTTP 状态码等。

基础错误类继承

让我们从一个简单的验证错误开始：

class ValidationError extends Error {
  constructor(message) {
    super(message);  // 调用父类构造函数
    this.name = "ValidationError";  // 设置错误名称
  }
}

关键点：

1. 必须调用 super() 来初始化父类
2. 重写 name 属性以标识错误类型
3. 自动获得 stack 属性记录调用栈

构建错误层次结构

随着应用复杂度增加，我们可以建立多层次的错误体系：

class ValidationError extends Error {
  constructor(message) {
    super(message);
    this.name = "ValidationError";
  }
}

class PropertyRequiredError extends ValidationError {
  constructor(property) {
    super(`缺少必要属性: ${property}`);
    this.name = "PropertyRequiredError";
    this.property = property;  // 添加自定义属性
  }
}

这种层次结构让错误处理更加精确，同时保持代码的可维护性。

错误处理最佳实践

在实际应用中，我们推荐以下处理模式：

try {
  // 可能抛出错误的代码
} catch (err) {
  if (err instanceof ValidationError) {
    // 处理验证错误
  } else if (err instanceof SyntaxError) {
    // 处理语法错误
  } else {
    throw err;  // 重新抛出未知错误
  }
}

使用 instanceof 比检查 err.name 更可靠，因为它能正确处理继承关系。

错误包装模式

对于复杂的应用，可以使用错误包装模式：

class ReadError extends Error {
  constructor(message, cause) {
    super(message);
    this.cause = cause;  // 保存原始错误
    this.name = 'ReadError';
  }
}

function readUser(json) {
  try {
    // 解析逻辑
  } catch (err) {
    if (err instanceof SyntaxError) {
      throw new ReadError("语法错误", err);
    }
    // 其他错误处理
  }
}

这种模式的优势：

1. 隐藏底层细节，提供统一接口
2. 保留原始错误信息
3. 简化外部代码的错误处理

实用技巧

1. 自动设置错误名称：可以创建基础错误类自动设置 name：

class MyError extends Error {
  constructor(message) {
    super(message);
    this.name = this.constructor.name;
  }
}

2. 错误信息格式化：为常见错误场景提供标准化的错误消息模板

3. 错误代码：为每种错误类型定义唯一代码，便于日志分析和监控

总结

1. 自定义错误类应继承自 Error 类
2. 确保正确设置 name 属性并调用 super()
3. 使用 instanceof 进行类型检查更可靠
4. 错误包装模式可以简化复杂系统的错误处理
5. 构建合理的错误层次结构提高代码可维护性

通过合理设计错误处理体系，可以显著提高 JavaScript 应用的健壮性和可维护性。自定义错误类不仅能更好地表达业务逻辑中的异常情况，还能为错误处理和日志记录提供更丰富的信息。

ru.javascript.info Современный учебник JavaScript 项目地址: https://gitcode.com/gh_mirrors/ru/ru.javascript.info