如何在TypeScript中实现适配单值与数组的map函数抽象类?
报错根因
TypeScript 目前无法将运行时的类型检查逻辑和泛型条件类型的推导做关联,你代码中定义的返回类型、函数参数类型都依赖T的条件判断结果,但TS在执行Array.isArray(this.value)的类型收窄时,只会收窄this.value的类型,不会同步推导泛型T对应的条件类型结果,因此会抛出三类类型不匹配错误。
优雅解决方案
推荐使用方法重载实现,对外暴露严格的类型签名保证调用侧的类型安全,内部实现使用宽松的类型规避TS无法自动推导的问题,全程无需使用any:
export class Container<T> { value: T; constructor(value: T) { this.value = value; } // 对外暴露的严格类型签名,和你原始的类型定义完全一致 map<U>(f: (x: T extends Array<infer R> ? R : T) => U): Container<T extends Array<any> ? Array<U> : U> // 内部实现用宽松的类型签名,绕过TS的自动推导限制 map(f: (x: unknown) => unknown) { if (Array.isArray(this.value)) { return new Container(this.value.map(f)); } return new Container(f(this.value)); } unwrap(): T { return this.value; } } // 示例调用,类型推导完全正常 const sayHello = (name: string) => `Hello ${name}`; const shout = (str: string) => str.toUpperCase(); // a 推导为 string 类型,值为 HELLO TOTO const a = new Container("Toto").map(sayHello).map(shout).unwrap() // b 推导为 string[] 类型,值为 ["HELLO HARRY", "HELLO RON", "HELLO HERMIONE"] const b = new Container(["Harry", "Ron", "Hermione"]).map(sayHello).map(shout).unwrap()
方案优势
- 调用侧类型检查完全符合预期,单值和数组场景的类型推导都准确无误
- 内部实现没有冗余的类型断言,代码整洁
- 全程没有使用
any,类型安全得到保障
内容的提问来源于stack exchange,提问作者Varkal
相关产品推荐
相关产品推荐

