直接用 mount 挂载即可, 组件经编译后与普通组件无异,Vitest + Vue Test Utils 完全兼容;需显式传入 props、mock 全局属性、provide 依赖;交互须通过 DOM 触发事件;断言应聚焦可观察结果。

直接用 mount 挂载即可,<script setup></script> 是编译时语法糖,测试时和普通组件无异——它最终会被编译成标准的组件对象,Vitest + Vue Test Utils 完全兼容。
挂载前确保 props 和依赖显式传入
<script setup></script> 组件不自动读取外部环境,所有输入都得手动提供:
- 通过
props选项传入 props 对象,例如:{ props: { title: '测试标题', disabled: false } } - 若组件用了
defineEmits或defineExpose,无需额外处理,测试时通过wrapper.emitted()或wrapper.vm.exposed访问即可 - 依赖全局属性(如
$router、$message)需在global.mocks或global.config.globalProperties中注入 mock 实例 - 使用
provide/inject的场景,通过global.provide提前注入依赖项
交互操作必须走 DOM 层,不能直改响应式数据
测试要模拟真实用户行为,尤其对 v-model 绑定的输入框:
- 用
wrapper.find('input')定位元素,再调用.setValue('新值'),接着.trigger('input')触发更新链 - 点击按钮用
wrapper.find('button').trigger('click'),而不是直接调vm.handleClick() - 表单提交、下拉选择等也遵循相同逻辑:先定位 → 再触发事件 → 最后断言
断言聚焦可观察结果,避开内部实现
验证的是 DOM 渲染、状态变化或事件发出,不是代码怎么写的:
- 检查文本是否出现:
expect(wrapper.text()).toContain('提交成功') - 检查元素是否存在:
expect(wrapper.contains('.loading')).toBe(true) - 检查响应式数据变化:
expect(wrapper.vm.count).toBe(2) - 检查事件是否触发及参数:
expect(wrapper.emitted('submit')[0]).toEqual(['abc'])
不需要为 <script setup></script> 单独做特殊处理,只要挂载方式选对、输入给足、交互走 DOM、断言看输出,整个流程就跑通了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











