TypeScript中带cause字段的抽象错误类创建报错问题求助

初始代码失效原因 #

1. 类型定义版本不兼容：Error构造函数的第二个options参数（包含cause属性）是ES2022才引入的特性，如果你的TypeScript编译配置（tsconfig.json）没有启用ES2022及以上的支持，TypeScript的类型定义会判定Error构造函数仅接受0或1个参数（仅message），传入第二个参数会触发类型不匹配错误。
2. 抽象类的严格校验：抽象类的构造函数会被TypeScript进行更严格的参数类型校验，而移除abstract后的普通类校验会相对宽松，这也是移除关键字后代码能运行的原因，但属于类型检查的“漏洞”，并非规范实现。

可行修复方案 #

方案一：升级编译配置，使用官方ErrorOptions类型 #

修改tsconfig.json启用ES2022及以上语言支持，同时使用TypeScript内置的ErrorOptions类型替代自定义参数类型：

tsconfig.json

{
  "compilerOptions": {
    "target": "ES2022",
    "lib": ["ES2022", "DOM"],
    "strict": true
  }
}

修复后的代码

abstract class CustomError extends Error {
  constructor(message: string, options: ErrorOptions) {
    super(message, options);
    // 修复原型链，确保自定义错误的instanceof判断正常
    Object.setPrototypeOf(this, new.target.prototype);
  }
}

class NewError extends CustomError {
  constructor(message: string) {
    super(message, { cause: "helloworld" });
  }
}

const a = new NewError("helloworld");
console.log("a", a, "a.cause", a.cause); // 正常输出a.cause: helloworld

方案二：兼容低ES版本，手动设置cause属性 #

如果无法升级ES版本，可以手动在自定义错误类中声明cause属性，绕过TypeScript的类型限制：

abstract class CustomError extends Error {
  // 显式声明cause属性，让类型系统识别
  cause: any;

  constructor(message: string, options: { cause: any }) {
    super(message);
    Object.setPrototypeOf(this, new.target.prototype);
    this.cause = options.cause;
  }
}

class NewError extends CustomError {
  constructor(message: string) {
    super(message, { cause: "helloworld" });
  }
}

const a = new NewError("helloworld");
console.log("a", a, "a.cause", a.cause);

这种方式无需修改编译配置，既保留抽象类特性，又能让类型系统正确识别cause属性。

内容的提问来源于stack exchange，提问作者John Long