Vue 泛型 props 传给 toRefs 时可能丢失类型推断
设置页的泛型选择器要从 options 里找出当前值。直接调用 props.options.find(...) 时,TypeScript 能推断回调参数。对同一份 props 调用 toRefs() 后,options.value.find(...) 的回调参数却报 TS7006。两次查找读的是同一个数组,改变的是 TypeScript 在调用前看到的类型。
同一份泛型 props,转成 Ref 后丢失数组类型
设置页用同一个选择器处理两种值。窗口边框的选项值是字符串,整体缩放的选项值是数字。组件用 <script setup generic="Value extends string | number"> 把选项里的值、当前选中的值和 select 事件的参数绑在同一个类型参数上。这正是 Vue 泛型组件 能保留的类型关系。
报错的 item 位于 options.value.find(...)。组件节选只保留和查找、事件有关的声明。
<script setup lang="ts" generic="Value extends string | number">
import { toRefs } from 'vue';
type Option = { label: string; value: Value };
interface Props {
options: readonly Option[];
value: Value;
}
const props = defineProps<Props>();
const { options } = toRefs(props);
const emit = defineEmits<{ select: [value: Value] }>();
function select(value: unknown) {
const option = options.value.find(item => item.value === value);
if (option) {
emit('select', option.value);
}
}
</script>
把选择器的代码缩到一个普通 .ts 文件,仍然能复现这个报错。工作区用 T 表示组件里的 Value。悬停三行 .find() 回调里的 item,可以依次看到 Option<T>、any 和 Option<T>。在报错那行悬停 options 后面的 .value,会看到调用 .find() 之前已经读到了 any。把这一行的 toRefs(props) 改成 toRefs(normalized),数组类型会恢复,TS7006 的波浪线也会消失。
工作区用 Vue 3.6.0-rc.15 的发布声明和 Monaco 内置的 TypeScript 5.9.3 做类型检查。本地用 TypeScript 6.0.3 复测,得到同样的结果。实际组件中的 defineProps() 调用仍要写在 <script setup> 的宏声明位置。
从待定的条件到可用的数组类型
想先修组件,可以跳到第 4 篇。要追查同一个字段为何在两条访问路径上得到不同类型,前 3 篇依次解释元组条件、类型索引和 Vue 声明。
- 《双侧元组中的泛型可能让条件类型延迟求值》说明检查器什么时候保留元组条件,以及条件未定时怎样读取两个分支共有的字段。
- 《待定的泛型键会让交集上的索引访问延迟求值》用一个交集对照直接访问和类型索引,说明泛型键怎样把延迟传给其他字段。
- 《布尔键映射让 toRefs 的数组字段读成 any》从
defineProps()的布尔键映射追到ToRef,找出.value第一次读成any的位置。 - 《组件可用类型标注或 getter 暂时绕过推断错误》用类型标注或 getter 让组件恢复数组元素推断。
- 《逆向映射推断让 toRefs 保留字段类型》对照逐字段宏方案和逆向映射重载,检查宽泛泛型、公开类型的双向赋值,以及 Verter 的兼容性。
补充内容
- 《补充内容:LooseRequired 让 props 键必有并保留 undefined》解释运行时补键、布尔键筛选和 LooseRequired 取键方式对 mixin 类型检查的影响。
- 《补充内容:条件求值、赋值和索引访问走不同的检查路径》对照条件求值、普通赋值和索引访问,并核对编译器源码和编辑器悬停。
- 《补充内容:用泛型上界提前选分支需要额外条件》用可选属性、函数参数和多态 this 验证泛型上界能证明什么。
- 《补充内容:只改 TypeScript 时需要识别待定索引的数组形状》 固定 Vue 发布声明,用编译器实验定位 ToRef 为什么需要选中假分支。