TypeScript基于泛型键类型定义reduce映射字典的正确对象类型
现有实现的类型推导失效原因
- 原实现中对泛型
T添加了过宽的约束{ [key: string]: any },会导致TypeScript在推导时把字段的字面量类型(比如"chair"、"table")直接拓宽为通用的string类型,丢失精准的候选键提示能力 key和value参数直接用了宽泛的keyof T类型,没有单独拆分为独立泛型位,无法把入参中传入的具体字段名反向关联到返回值的结构上reduce的初始值为空对象{},TypeScript无法自动推导累积值的结构,最终返回值会退化为普通的{ [key: string]: any }类型,完全失去类型保护和代码提示能力
优化后的可正确推导的实现
export const getMappingDictionary = <T, K extends keyof T, V extends keyof T>( objectsToMap: T[], key: K, value: V, ): Record<T[K], T[V]> => { return objectsToMap.reduce( (prev, cur) => ({ ...prev, [cur[key]]: cur[value] }), {} as Record<T[K], T[V]> ); };
实现效果验证
针对给定的样例数组做测试:
const myArray = [ { name: "chair", id: 1, description: "omg a chair" }, { name: "table", id: 2, description: "thats a nice table" }, { name: "lamp", id: 3, description: "so bright" } ]; const mymap = getMappingDictionary(myArray, "name", "id");
此时mymap会被精确推导为Record<"chair" | "table" | "lamp", number>,完全匹配使用需求:
- 静态场景下输入
mymap.时,IDE会自动弹出所有合法键的补全提示 - 动态远程数据场景下,因为返回值结构已经被
Record类型约束,通过键名索引取值时不需要额外做空值判断,TypeScript会明确提示对应键的值类型为业务定义的类型(比如示例里的number) - 业务侧调整映射的源字段、目标字段时,返回值的类型会自动跟随变化,不需要手动修改类型声明
代码精简性优化说明
- 移除了原来过宽的对象索引类型约束,保留了对入参类型的兼容性,同时不破坏字面量类型的推导链路
- 拆分独立泛型位让类型推导全程自动完成,调用函数时不需要手动传入泛型参数
- 利用内置
Record工具类型定义返回结构,比手写自定义索引签名的可读性、兼容性更好 - 仅在
reduce内部做一次类型断言,不向外扩散非类型安全的问题:因为函数的运行逻辑是基于源数组逐个生成键值对,实际运行结构和类型声明完全一致,不存在类型错位的风险
内容的提问来源于stack exchange,提问作者Narshe
相关产品推荐
相关产品推荐

