如何在NodeJS（含TypeScript）中访问未全局暴露的FetchError类？

访问FetchError类的可行方案（兼容TypeScript） #

方案1：从捕获的错误实例中提取构造函数 #

这是最稳妥且不依赖内部API的方式，通过首次捕获FetchError实例时保存其构造函数，后续即可用instanceof检查：

// 声明变量存储FetchError构造函数
let FetchErrorConstructor: new (...args: any[]) => Error | undefined;

async function fetchResource(url: string) {
  try {
    await fetch(url);
  } catch (err) {
    // 首次捕获时确认并保存构造函数
    if (!FetchErrorConstructor && err instanceof Error && err.name === 'FetchError') {
      FetchErrorConstructor = err.constructor as new (...args: any[]) => Error;
    }

    // 后续使用instanceof判断
    if (FetchErrorConstructor && err instanceof FetchErrorConstructor) {
      console.log('处理FetchError逻辑:', err.message);
    }
  }
}

方案2：使用Node.js内部模块（不推荐） #

FetchError实际定义在Node.js的内部node:internal/errors模块中，你可以直接导入，但依赖内部API存在风险——未来版本可能随时修改或移除该导出，不建议在生产环境使用：

// 添加@ts-ignore跳过TypeScript的内部模块检查
// @ts-ignore
import { FetchError } from 'node:internal/errors';

async function testFetch() {
  try {
    await fetch('https://invalid.example.com');
  } catch (err) {
    if (err instanceof FetchError) {
      console.log('捕获到FetchError:', err.code);
    }
  }
}

FetchError未被全局暴露的原因 #

1. 实验性API的稳定性考量
   Node.js 18中的fetch处于实验性阶段，意味着整个API的设计（包括错误类型）都可能在后续版本中发生重大变更。不暴露FetchError构造函数，是为了避免开发者依赖这个未稳定的实现，防止未来版本迭代时出现兼容性断裂。

2. 对齐浏览器API规范
   浏览器环境中的fetch只会抛出普通Error或TypeError，不存在专门的FetchError类型。Node.js刻意不暴露该构造函数，是为了尽量对齐浏览器的API行为，降低跨环境代码的适配成本。

3. 内部实现的封装性
   FetchError是Node.js内部用于细分fetch流程中各类错误的实现细节，对外只需要通过错误的name、message、code等属性即可识别错误类型，无需暴露构造函数给上层业务代码。

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