从TypeScript调用JavaScript函数时，如何覆盖错误的类型推断？

问题背景 #

现有第三方JavaScript库提供以下类实现：

class SomeApi {
  async getData(signal = null) {
    const resp = await fetch(url, {signal});
    return resp.json()
  }
}
export default SomeApi()

用TypeScript调用时，传入AbortSignal实例会触发编译错误：

Argument of type 'AbortSignal' is not assignable to parameter of type 'null | undefined'

调用代码如下：

import api from '...'

const abortController = new AbortController();
api.getData(abortController.signal).then(data => console.log);

TypeScript错误推断了getData的参数类型，实际合法类型应为AbortSignal | null，且无法修改库源码，不想用as any这种粗暴的类型绕过方式。

最优解决方案 #

1. 编写自定义类型声明文件（推荐） #

在项目中创建对应库的类型声明文件（比如some-api.d.ts），手动修正类型定义：

declare class SomeApi {
  getData(signal?: AbortSignal | null): Promise<unknown>;
}

declare const api: SomeApi;
export default api;

将该文件放在TypeScript能识别的目录（比如src/types，并在tsconfig.json的include字段中配置该目录），TypeScript会优先使用这个手动声明的类型，而非自动推断的错误类型。

2. 精确类型断言 #

不用as any，改用更精确的断言明确告知TS参数符合预期类型：

api.getData(abortController.signal as AbortSignal | null).then(data => console.log);

相比as any，这种方式保留了部分类型安全，不会完全绕过TS的类型检查机制。

3. 封装类型安全的包装函数 #

如果需要多次调用该方法，可以封装一个包装函数统一处理类型：

const safeGetData = (signal?: AbortSignal | null) => {
  return api.getData(signal as AbortSignal | null);
};

// 调用示例
safeGetData(abortController.signal).then(data => console.log);

内容的提问来源于stack exchange，提问作者Brian H.