You need to enable JavaScript to run this app. TypeScript 自定义键对象扁平化及值字面量联合类型获取方法
优惠活动
大模型
产品
解决方案
定价
更多

TypeScript 自定义键对象扁平化及值字面量联合类型获取方法

问题根源

你当前的实现存在两处类型信息丢失,直接导致字面量推导失效:

  • 扁平化函数入参直接标注为any,完全无法捕获原对象携带的字面量类型
  • 返回值硬编码为{ [x: string]: string },把所有原本可能的字面量值统一拓宽为通用string类型。这种类型拓宽是不可逆的——哪怕后续对返回值加as const,也只能从已经被拓宽的string集合里取值,根本拿不到原对象的字面量。

这也是为什么你写的[...Object.values(flatten(myObject))] as const 最终推导为string[]而不是预期的字面量联合。

具体改造方案

1. 新增保留字面量的递归类型工具

写纯逻辑的类型递归,遍历嵌套对象时不做类型拓宽,完整保留叶子节点的字面量类型:

type LeafValueUnion<T> = T extends object
  ? { [K in keyof T]: LeafValueUnion<T[K]> }[keyof T]
  : T;

这个类型会递归钻进对象的每一层,直到碰到非对象的叶子节点,把所有叶子节点的类型收集成联合类型。

2. 改写扁平化函数的类型定义

保留原来的运行时逻辑,只调整类型标注,避免硬编码的类型拓宽:

// 匹配扁平化返回值的类型结构,值完全来自输入对象,不做通用string拓宽
type FlattenedResult<T> = Record<string, LeafValueUnion<T>>;

// 用泛型捕获输入对象的真实类型,不写死入参/返回值类型
export function flattenDaisyChain<T extends object>(obj: T): FlattenedResult<T> {
  const result: Record<string, unknown> = {}

  const transform = (wrapper: unknown, p?: string) => {
    // 补充null值判断,修复原逻辑把null当成对象遍历的潜在bug
    if (typeof wrapper === 'object' && wrapper !== null) {
      p = p ? p + '.' : ''
      for (const item in wrapper) {
        transform((wrapper as Record<string, unknown>)[item], p + item)
      }
      return
    }
    if (p) {
      result[p] = wrapper
    }
  }

  transform(obj)
  return result as FlattenedResult<T>
}

3. 正确提取字面量联合

不需要绕数组展开的弯路,直接从原对象类型提取所有叶子值的联合即可,精度更高也不会丢类型:

// 定义原对象时加as const,把内部字符串的拓宽状态固定为字面量
const myObject = {
  names: {
    title: 'red',
    subtitle: 'green'
  },
} as const

// 直接提取字面量联合,推导结果为 'red' | 'green'
type AllowedName = LeafValueUnion<typeof myObject>

这时候组件的类型约束可以完全生效:

// 合法:name值属于字面量联合范围内
<Component name="red" />

// 报错:不在字面量联合范围内
<Component name="something different than red or green" />
关键注意事项
  • 定义需要提取字面量的对象时,必须加as const断言,否则TS默认会把对象内部的字符串拓宽为通用string,哪怕类型工具再完善也拿不到字面量。
  • 不要在函数定义阶段把返回值硬编码为值是string的通用对象结构,这种写法会直接阻断字面量类型的传递,后续靠类型断言补不回来。
  • 如果你坚持要从扁平化的返回值里提取值联合,在函数泛型正确的前提下,可以直接取返回值的所有值的联合:
    const flattened = flattenDaisyChain(myObject)
    type FlattenedValues = (typeof flattened)[keyof typeof flattened]
    // 推导结果依然是 'red' | 'green',不需要手动展开数组
    

内容的提问来源于stack exchange,提问作者Bart Krakowski

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 00:45:02