TypeScript中如何处理浏览器API可选参数？以Error构造函数为例

这个问题我之前也碰到过！TypeScript默认的Error类型定义确实没有包含fileName和lineNumber这两个参数，但实际上JavaScript引擎是支持这两个可选参数的，所以才会出现类型检查和实际API不匹配的报错。下面给你几种靠谱的解决办法：

方法1：使用类型断言快速绕过检查 #

如果你只是临时需要用这两个参数，不想写太多额外代码，可以用类型断言把Error转为any类型，让TS跳过类型检查：

const myError = new (Error as any)('Something went wrong', 'my-file.ts', 42);

这种方法简单直接，但缺点是丢失了类型安全性，TS不会再校验参数类型，适合临时场景。

方法2：自定义支持多参数的Error子类 #

如果需要长期使用且保证类型安全，最好自定义一个扩展Error的子类，手动处理fileName和lineNumber参数：

class DetailedError extends Error {
  constructor(message?: string, fileName?: string, lineNumber?: number) {
    super(message);
    // 修复ES6子类继承Error时的原型链问题
    Object.setPrototypeOf(this, DetailedError.prototype);
    
    // 手动设置fileName和lineNumber属性
    if (fileName) {
      this.fileName = fileName;
    }
    if (lineNumber !== undefined) {
      this.lineNumber = lineNumber;
    }
  }
}

// 使用时TS不会报错，类型完全安全
const error = new DetailedError('Invalid input', 'utils.ts', 15);

这种方法的好处是类型严格，而且能兼容那些不原生支持fileName/lineNumber的环境（比如部分旧浏览器），因为我们是手动给实例添加属性的。

方法3：扩展全局Error类型定义 #

如果你的整个项目都需要用到这两个参数，不想每次都写自定义类，可以修改全局的Error类型定义，让TS默认支持这两个参数。

在项目根目录创建一个global.d.ts文件，添加以下内容：

interface ErrorConstructor {
  new(message?: string, fileName?: string, lineNumber?: number): Error;
}

declare var Error: ErrorConstructor;

保存后，TS编译器就会识别Error构造函数的三个参数，直接使用也不会报错了：

const error = new Error('Network failed', 'api.ts', 30); // 完全合法！

注意：这种方法会影响整个项目的全局类型，适合团队统一需要这个特性的场景。

额外注意事项 #

虽然JS规范里定义了fileName和lineNumber参数，但并不是所有JavaScript环境都完全支持（比如某些Node.js版本或旧浏览器）。如果需要兼容这些环境，自定义子类的方法会更可靠，因为它不依赖环境原生支持这两个属性。

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