跳到正文

Vue 泛型 props 传给 toRefs 时可能丢失类型推断(9):补充内容:只改 TypeScript 时需要识别待定索引的数组形状

Vue 泛型 props 传给 toRefs 时可能丢失类型推断

  1. 双侧元组中的泛型可能让条件类型延迟求值
  2. 待定的泛型键会让交集上的索引访问延迟求值
  3. 布尔键映射让 toRefs 的数组字段读成 any
  4. 组件可用类型标注或 getter 暂时绕过推断错误
  5. 逆向映射推断让 toRefs 保留字段类型
  6. 补充内容:LooseRequired 让 props 键必有并保留 undefined
  7. 补充内容:条件求值、赋值和索引访问走不同的检查路径
  8. 补充内容:用泛型上界提前选分支需要额外条件
  9. 补充内容:只改 TypeScript 时需要识别待定索引的数组形状(当前)

第 5 篇把修复放在 Vue 的类型声明里。若保留原来的 DefineProps 和 ToRef,则要从 TypeScript 检查器入手。以第 3 篇里的泛型选择器为例,可以分别观察元组条件何时保留,以及检查器继续比较后能否得出假分支。

编译器需要证明这个数组不会匹配 Ref

[P['options']] extends [Ref] 在这里应该得到 false。这份复现的 options 是数组,选中假分支后会得到 Ref<readonly Option<T>[]>。固定 Vue 发布声明时,检查器要从仍待定的 P['options'] 恢复数组形状,或者在比较阶段证明本例的索引结果与 Ref 不兼容。

单独跳过元组元素检查仍然会报错

这组实验固定 Vue 3.6.0-rc.15 的发布声明和同一个复现文件,只修改 TypeScript 6.0.3 的本地检查器。修改点是 getConditionalType() 内两处不同的判断。表里先只为右侧是 [unknown] 的比较绕过直接元素检查,再尝试对所有双侧元组绕过这一层。最后一组恢复原检查,只在已定位的 options 条件上强制选假分支。

一份普通 .ts 文件就能观察这两个结果。inspectTuple 单独测试元组条件,inspectVue 保留触发错误的泛型 props。

import { defineProps, toRefs } from 'vue';

type IsUnknownTuple<X> = [X] extends [unknown] ? true : false;
type ExpectTrue<X extends true> = X;

function inspectTuple<T extends ['a']>() {
  // @ts-expect-error TS2344,原版检查器仍保留元组条件。
  type Result = ExpectTrue<IsUnknownTuple<T>>;
}

type Option<T> = { value: T };

interface Props<T> {
  options: readonly Option<T>[];
  value: T;
}

function inspectVue<T extends string | number>() {
  const props = defineProps<Props<T>>();
  const { options } = toRefs(props);

  // @ts-expect-error TS7006,原版检查器无法给 item 提供类型。
  options.value.find(item => item.value === props.value);
}

这份代码只用于类型检查。用原版编译器时,两条 @ts-expect-error 分别对应 TS2344 和 TS7006。做检查器对照时先去掉它们,再记录各版本的诊断和 item 类型。

检查器中的实验改动 [T] extends [unknown] toRefs(props).options.value.find(...)
使用原版 条件待定,ExpectTrue 报 TS2344 item 报 TS7006
只让右侧为 [unknown] 的条件跳过左侧的元组元素检查 得到 true 仍报 TS7006
对所有条件跳过元组元素检查 得到 true 仍报 TS7006
仅对复现中的 options 强制选择 ToRef 的假分支 条件待定,ExpectTrue 报 TS2344 item 恢复为 Option<T>

跳过元组元素检查后,TypeScript 6.0.3 的分支比较仍要处理一个带待定布尔键映射的索引。实验里,检查器用较宽松的方式代入类型参数后认为两侧有可能兼容,用较严格的方式代入后又无法证明一定兼容,于是继续保留条件式。强制选择假分支验证了选中该分支足以恢复推断。修复可以让检查器确认这里的索引类型与 Ref 不兼容,也可以在更早的位置让 options 的数组类型摆脱待定布尔键映射的影响。