JavaScript 错误处理进阶：自定义 Error 类与扩展 Error

最新推荐文章于 2025-06-10 09:17:27 发布

强海寒

最新推荐文章于 2025-06-10 09:17:27 发布

阅读量312

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00507/article/details/148416521

JavaScript 错误处理进阶：自定义 Error 类与扩展 Error

引言

在 JavaScript 开发中，错误处理是构建健壮应用程序的关键部分。虽然 JavaScript 提供了内置的 Error 类，但在实际开发中，我们经常需要创建特定于应用程序的自定义错误类型。本文将深入探讨如何创建和使用自定义 Error 类，以及如何构建错误层次结构来更好地管理应用程序中的各种错误情况。

为什么需要自定义 Error 类

JavaScript 的内置 Error 类提供了基本的错误处理能力，但在复杂应用中，我们通常需要：

区分不同类型的错误（如网络错误、数据库错误、验证错误等）
为特定错误类型添加额外的属性（如 HTTP 状态码、错误字段名等）
构建清晰的错误处理层次结构
提供更具体的错误信息和上下文

基础：扩展 Error 类

让我们从一个简单的例子开始，创建一个基本的自定义错误类：

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

这个简单的 ValidationError 类继承了 JavaScript 内置的 Error 类，并做了以下工作：

通过 super(message) 调用父类构造函数设置错误消息
设置 name 属性为 "ValidationError"，便于识别错误类型
自动继承了 stack 属性（包含调用堆栈信息）

实际应用示例

假设我们有一个读取用户数据的函数 readUser(json)，它需要处理两种主要错误：

JSON 语法错误（使用内置的 SyntaxError）
数据验证错误（使用我们的 ValidationError）

function readUser(json) {
  let user = JSON.parse(json);  // 可能抛出 SyntaxError
  
  if (!user.age) {
    throw new ValidationError("No field: age");
  }
  if (!user.name) {
    throw new ValidationError("No field: name");
  }
  
  return user;
}

使用时，我们可以这样处理错误：

try {
  let user = readUser('{ "age": 25 }');
} catch (err) {
  if (err instanceof ValidationError) {
    console.log("Invalid data:", err.message);
  } else if (err instanceof SyntaxError) {
    console.log("JSON Syntax Error:", err.message);
  } else {
    throw err;  // 重新抛出未知错误
  }
}

构建错误层次结构

随着应用复杂度的增加，我们可以构建更精细的错误层次结构。例如：

Error
├── ValidationError
│   ├── PropertyRequiredError
│   └── FormatError
├── HttpError
│   ├── HttpTimeoutError
│   └── HttpNotFoundError
└── DatabaseError
    ├── ConnectionError
    └── QueryError

让我们实现一个更具体的 PropertyRequiredError：

class PropertyRequiredError extends ValidationError {
  constructor(property) {
    super("No property: " + property);
    this.name = "PropertyRequiredError";
    this.property = property;  // 添加额外属性
  }
}

这种层次结构的好处是：

可以使用 instanceof 检查来捕获一类错误
可以添加特定于错误类型的额外信息
代码组织更清晰，维护更方便

高级技巧：避免重复设置 name

在每个错误类中手动设置 this.name 可能会很繁琐。我们可以创建一个基础错误类来自动完成这项工作：

class MyError extends Error {
  constructor(message) {
    super(message);
    this.name = this.constructor.name;  // 自动设置类名
  }
}

// 现在派生类不需要手动设置 name
class ValidationError extends MyError {}
class PropertyRequiredError extends ValidationError {
  constructor(property) {
    super("No property: " + property);
    this.property = property;
  }
}

包装异常模式

在处理复杂操作时，可能会遇到多种不同类型的错误。为了简化错误处理，可以使用"包装异常"模式：

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

function readUser(json) {
  try {
    // 可能抛出 SyntaxError
    let user = JSON.parse(json);
    
    // 可能抛出 ValidationError
    validateUser(user);
  } catch (err) {
    if (err instanceof SyntaxError || err instanceof ValidationError) {
      throw new ReadError("Failed to read user", err);
    } else {
      throw err;  // 重新抛出未知错误
    }
  }
}

这种模式的好处是：