Vue SFC单元测试应聚焦用户行为与组件响应,验证props输入、DOM交互、事件输出和渲染结果四类可观测行为,避免测试内部实现细节。

Vue 单文件组件(SFC)的单元测试,核心是验证“用户做了什么 → 组件怎么响应”,而不是测内部变量或方法名。重点落在 props 输入、DOM 交互、事件输出、渲染结果 这四类可观察行为上。
明确测试目标:只关注输入和输出
不要测 data、methods 或 computed 的实现细节。比如一个按钮点击后计数加 1 并 emit 事件,测试应围绕:
- 初始渲染是否显示 “Times clicked: 0”
- 点击按钮后,文本是否变成 “Times clicked: 1”
- 是否触发了
increment事件,且参数为[1]
避免直接调用 wrapper.setData({ count: 2 }) 或依赖 .counter 类名——这些属于实现细节,重构时容易让测试误失败。
挂载组件:选对方式并传清依赖
用 @vue/test-utils 的 mount 或 shallowMount 启动组件,关键在配置:
- 普通 props 直接写进
props选项:{ props: { title: '测试标题', disabled: false } } - 需要
$router或$store?用global.mocks或global.plugins注入 mock 实例 - 组件用了
provide/inject?通过global.provide提前注入模拟对象 - 只想测当前组件逻辑、屏蔽子组件干扰?用
shallowMount;要验证真实 DOM 结构或子组件渲染效果?用mount
模拟用户交互:走真实事件链
所有操作都得像真人一样点、输、选,不能绕过 DOM 直改数据:
- 定位元素:用
wrapper.find('button')、wrapper.find('[data-testid="email-input"]')等选择器 - 点击按钮:
await wrapper.find('button').trigger('click') - 填表单:
await wrapper.find('input').setValue('test@example.com'),再.trigger('input')(v-model 需要两者配合) - 选下拉:
await wrapper.find('select').setValue('option-2')
注意加 await,确保 Vue 响应式更新和 DOM 渲染完成后再断言。
断言行为结果:检查三类可观测输出
验证组件是否按预期工作,只看三件事:
-
DOM 输出:例如
expect(wrapper.text()).toContain('Hello, Alice!')或expect(wrapper.contains('.error')).toBe(true) -
响应式状态变化:如
expect(wrapper.vm.count).toBe(2)(仅当该状态直接影响外部行为且可被用户感知时) -
事件触发:用
wrapper.emitted()检查:expect(wrapper.emitted('submit')).toHaveLength(1)expect(wrapper.emitted('submit')[0]).toEqual(['test@example.com'])
不复杂但容易忽略。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










