TypeScript 中如何为已推导的现有Menu类型扩展新增属性
实现结论
该类型扩展需求完全可在TypeScript类型系统层面实现,不需要修改原有业务常量的定义逻辑,仅通过内置的条件类型、联合分布式特性即可完成精确匹配的类型改造。
核心实现方案
实现原理
借助TypeScript对裸联合类型的分布式自动分发规则,我们可以对数组内的元素做精准分支判断——当条件判断的输入是联合类型时,TS会自动把联合拆分成单个成员,逐一代入做匹配,不会将整个联合作为整体处理:
- 遇到原本的
string类型分支(比如代码里的'devider')时,完全保留原类型不做任何修改 - 遇到对象类型分支时,为其合并必选的
active: boolean属性,不改动原有对象的属性定义
具体代码实现
- 先定义通用的类型扩展工具:
type AddActiveToObjectItems<T> = T extends Array<infer ArrayItem> ? Array< // 逐一对联合成员做分支判断 ArrayItem extends string ? ArrayItem // 字符串分支直接原样返回 : ArrayItem & { active: boolean } // 对象分支新增必选active属性 > : never
- 基于原有
typeof推导的基础类型做扩展:
// 原有通过typeof推导得到的原始Menu类型 type OriginalMenu = typeof menu // 扩展后得到目标Menu类型 type TargetMenu = AddActiveToObjectItems<OriginalMenu>
可选优化:展平交叉类型
上述写法生成的类型在IDE中会以交叉类型的形式展示(比如{ title: string; body?: undefined } & { active: boolean }),如果希望IDE展示的结构和预期的“active属性直接内嵌在对象结构内”的效果完全一致,不会出现交叉类型的标记,可以加一层简单的类型展平工具:
// 展平对象交叉类型,优化IDE展示效果 type FlattenObject<T> = T extends object ? { [Key in keyof T]: T[Key] } : T // 更新扩展工具,对对象分支做展平处理 type AddActiveToObjectItems<T> = T extends Array<infer ArrayItem> ? Array< ArrayItem extends string ? ArrayItem : FlattenObject<ArrayItem & { active: boolean }> > : never
此时推导得到的TargetMenu结构会和预期完全一致:
type TargetMenu = ( | string | { title: string; active: boolean; body?: undefined } | { body: string; active: boolean; title?: undefined } )[]
注意事项
- 整个扩展过程完全基于已有推导类型做改造,不会侵入修改原始业务常量的定义
- 由于利用了分布式分发特性,不管后续原菜单结构新增多少对象类型的数组项,这个扩展工具都能自动给所有对象分支补充
active属性,不需要手动调整类型定义 - 字符串分支会被严格识别并保留,不会被错误加上
active属性
内容的提问来源于stack exchange,提问作者Teresa
相关产品推荐
相关产品推荐

