Vue 泛型 props 传给 toRefs 时可能丢失类型推断(2):待定的泛型键会让交集上的索引访问延迟求值
同一个对象上的 options,在 TypeScript 6.0.3 中有两种读法。表达式 props.options 能直接得到 string[],类型位置上的 Props<K>['options'] 却可能保留索引式。Vue 的 ToRefs 用的就是后者。
泛型映射的键还没确定
Extra<K> 用 K 来决定要声明哪些字段。下面对照 K 取 'value' 和 never 的结果。前者生成一个布尔字段,后者生成空映射。
type Base = { options: string[] };
// 键由 K 决定,生成的字段值都是 boolean。
type Extra<K extends 'value'> = { [Key in K]: boolean };
type Props<K extends 'value'> = Base & Extra<K>;
type WithValue = Extra<'value'>; // { value: boolean }
type WithoutValue = Extra<never>; // {}
// 同一个 props 对象,两种查找 options 的方式。
function inspect<K extends 'value'>(props: Props<K>) {
const options = props.options; // string[]
type FromRead = typeof options; // string[]
type Indexed = Props<K>['options']; // 保留索引访问,待求值。
}
type KnownOptions = Props<'value'>['options']; // string[]
type EmptyExtraOptions = Props<never>['options']; // string[]
直接读 props.options 时,检查器按名字查属性。左边提供 options: string[],右边没有同名字段参与这次读取。两边都查到同名字段时,读取结果才需要符合两边的字段类型。typeof options 取得的是这次读取的结果,已经是 string[]。
类型索引的顺序不同。检查器先看整个 Props<K>。右侧映射的键集合还依赖 K,所以检查器把它识别为泛型映射类型,再把泛型标记带到整个交集。遇到这样的泛型对象,检查器在按名字查属性之前就把 Props<K>['options'] 保留为索引访问类型。'options' 已经是一个具体的键,这个例子等待的是被索引的对象类型。
{>>我建议这里直接贴 TS 代码,并且写尽量详细的注释,更有说服力,直接贴源码没有注释的话读者肯定看不懂。<<}
上面的延迟规则按整个对象来判断。即使 K 的上界已经写成 'value',检查器在这一步也没有拿 'options' 和上界逐个比较。显式把 K 代成 'value' 或 never 后,右侧都没有 options,两次索引都查到了左边的 string[]。
{>>这块建议补个图对比,更直观地看出来「& 泛型类型」、「原始类型」「值」的区别。<<}
字段的值可以带泛型,外层形状仍然已知
把 K 从字段名的位置移开,就能看到影响范围。下面的 V 仍然待定,但 value 是固定的键,Option<V>[] 的外层也始终是数组。
type WithFixedKeys<V> = { options: string[] } & { value: V };
type FixedOptions<V> = WithFixedKeys<V>['options']; // string[]
type Option<V> = { value: V };
type IsArray<X> = [X] extends [readonly unknown[]] ? true : false;
type OptionsAreArray<V> = IsArray<readonly Option<V>[]>; // true
FixedOptions<V> 可以取出具体字段,OptionsAreArray<V> 也可以直接选真分支。判断能不能继续时,要看未确定的泛型参与了哪一步。这里既不需要知道 value 的类型,也不需要知道数组里每个 Option<V> 的值,就能确定字段类型或数组形状。
Vue 旧版 defineProps() 的右边正是这种由待定键生成的映射。它把数组字段的类型索引保留下来,再交给 第 3 篇里的 ToRef。此时 [P['options']] 的直接元素就是那个待求值的索引,接上了第 1 篇的双侧元组检查。