Vue组件emit测试需先交互再断言,用wrapper.emitted()捕获事件并校验名称、次数及参数;支持对象、多参数及部分字段校验,并需结合props验证条件触发逻辑。

在单元测试中验证 Vue 组件的 emits,核心是捕获并断言子组件是否按预期触发了指定事件、事件名是否正确、参数是否匹配。Vitest + Vue Test Utils(v4)提供了简洁可靠的机制,不需要模拟或手动监听。
用 wrapper.emitted() 捕获事件
wrapper.emitted() 返回一个对象,键为事件名,值为该事件每次触发时的参数数组列表。即使只传一个参数,也以数组形式存储(如 [{ id: 1 }])。
- 检查事件是否触发:
expect(wrapper.emitted('submit')).toBeDefined() - 检查触发次数:
expect(wrapper.emitted('submit')).toHaveLength(1) - 检查第 n 次触发的参数:
expect(wrapper.emitted('submit')![0]).toEqual([{ title: 'test' }])
先交互,再断言
事件通常由用户操作(点击、输入、提交)触发,测试必须模拟这些行为:
- 按钮点击:
wrapper.find('button').trigger('click') - 表单提交:
wrapper.find('form').trigger('submit') - 输入框变更:
wrapper.find('input').setValue('new value')(会自动触发input和change)
注意:必须在触发交互后调用 emitted(),否则返回空或 undefined。
验证复杂参数结构
当事件携带对象、多参数或可选字段时,直接比对整个结构即可:
- 对象参数:
expect(wrapper.emitted('update:modelValue')![0]).toEqual([true]) - 多参数:
emit('search', 'vue', { page: 1, size: 10 })→expect(wrapper.emitted('search')![0]).toEqual(['vue', { page: 1, size: 10 }]) - 部分字段校验(如只关心是否存在
id):const [payload] = wrapper.emitted('save')![0]; expect(payload.id).toBe(123)
配合 Props 验证组合场景
真实逻辑常依赖 props 状态决定是否 emit,测试需覆盖这种联动:
- 挂载时传入
disabled: true,点击按钮后确认click未触发 - 初始
modelValue: false,点击开关后检查是否发出update:modelValue且参数为true - 避免只测“有没有 emit”,重点测“在什么条件下 emit 什么”
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










