Vue 泛型 props 传给 toRefs 时可能丢失类型推断(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 的数组类型摆脱待定布尔键映射的影响。