You need to enable JavaScript to run this app. TypeScript 中如何为已推导的现有Menu类型扩展新增属性
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript 中如何为已推导的现有Menu类型扩展新增属性

实现结论

该类型扩展需求完全可在TypeScript类型系统层面实现,不需要修改原有业务常量的定义逻辑,仅通过内置的条件类型、联合分布式特性即可完成精确匹配的类型改造。

核心实现方案

实现原理

借助TypeScript对裸联合类型的分布式自动分发规则,我们可以对数组内的元素做精准分支判断——当条件判断的输入是联合类型时,TS会自动把联合拆分成单个成员,逐一代入做匹配,不会将整个联合作为整体处理:

  • 遇到原本的string类型分支(比如代码里的'devider')时,完全保留原类型不做任何修改
  • 遇到对象类型分支时,为其合并必选的active: boolean属性,不改动原有对象的属性定义

具体代码实现

  1. 先定义通用的类型扩展工具:
type AddActiveToObjectItems<T> = T extends Array<infer ArrayItem>
  ? Array<
      // 逐一对联合成员做分支判断
      ArrayItem extends string 
        ? ArrayItem // 字符串分支直接原样返回
        : ArrayItem & { active: boolean } // 对象分支新增必选active属性
    >
  : never
  1. 基于原有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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 06:24:05