跳到正文

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>
对比三个 item 的推断类型正在加载代码工作区...

把选择器的代码缩到一个普通 .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> 的宏声明位置。

直接读取、直接转 Ref 和标注后转 Ref 的回调类型对照

从待定的条件到可用的数组类型

想先修组件,可以跳到第 4 篇。要追查同一个字段为何在两条访问路径上得到不同类型,前 3 篇依次解释元组条件、类型索引和 Vue 声明。

  1. 《双侧元组中的泛型可能让条件类型延迟求值》说明检查器什么时候保留元组条件,以及条件未定时怎样读取两个分支共有的字段。
  2. 《待定的泛型键会让交集上的索引访问延迟求值》用一个交集对照直接访问和类型索引,说明泛型键怎样把延迟传给其他字段。
  3. 《布尔键映射让 toRefs 的数组字段读成 any》从 defineProps() 的布尔键映射追到 ToRef,找出 .value 第一次读成 any 的位置。
  4. 《组件可用类型标注或 getter 暂时绕过推断错误》用类型标注或 getter 让组件恢复数组元素推断。
  5. 《逆向映射推断让 toRefs 保留字段类型》对照逐字段宏方案和逆向映射重载,检查宽泛泛型、公开类型的双向赋值,以及 Verter 的兼容性。

补充内容