Vue / 系统课时
组件交互测试
组件交互测试
组件测试不该盯着内部变量,而要验证用户和父组件能观察到的结果:内容是否渲染、输入是否驱动界面变化、交互是否发出正确事件,以及插槽能否收到约定数据。下面用 Vue Test Utils 和 Vitest 完成完整验证。
学习目标
- 使用
mount、find和 DOM 断言验证组件渲染结果 - 使用
setValue与trigger模拟输入和提交,并等待 Vue 完成更新 - 使用
emitted与作用域插槽验证组件对外通信契约
以用户可观察行为作为断言对象
组件交互测试适合覆盖“输入什么、看到什么、发出什么”,而不是断言 wrapper.vm 上的内部实现。这样组件即使把 ref 改成 computed、把处理函数拆分或重命名,只要对外行为不变,测试就不需要跟着修改。
本例创建一个 SearchBox:空输入时按钮禁用;输入内容后按钮可用;提交时去掉首尾空格并发出 submit;具名插槽 hint 可以读取当前原始输入。项目需已具备 Vue 3、TypeScript、Vitest、Vue Test Utils 与 jsdom。
准备可交互组件
下面是项目内片段示例,保存为 src/components/SearchBox.vue。测试会通过真实 DOM 事件驱动它,不直接调用内部 submit 函数。
<script setup lang="ts">
import { computed, ref } from 'vue'
withDefaults(defineProps<{ label?: string }>(), {
label: '关键词',
})
const emit = defineEmits<{
submit: [value: string]
}>()
const query = ref('')
const canSubmit = computed(() => query.value.trim().length > 0)
function submit() {
const value = query.value.trim()
if (!value) return
// 对外事件只发送规范化后的值,输入框仍保留用户原始内容。
emit('submit', value)
}
</script>
<template>
<form @submit.prevent="submit">
<label for="search-query">{{ label }}</label>
<input id="search-query" v-model="query" type="text">
<button type="submit" :disabled="!canSubmit">搜索</button>
<slot name="hint" :query="query" />
</form>
</template>这个组件的测试契约已经很明确:标签和插槽属于渲染结果,输入框和按钮属于用户交互,submit 属于父组件可观察的事件。
模拟输入、事件和插槽
测试文件保存为 src/components/SearchBox.spec.ts。文件头指定 jsdom 环境,使 Vue Test Utils 可以创建和操作 DOM;setValue、trigger 都需要 await,以确保 Vue 已完成对应的响应式更新。
// @vitest-environment jsdom
import { h } from 'vue'
import { mount } from '@vue/test-utils'
import { describe, expect, it } from 'vitest'
import SearchBox from './SearchBox.vue'
type HintSlotProps = {
query: string
}
function mountSearchBox() {
return mount(SearchBox, {
props: { label: '站内搜索' },
slots: {
// 用作用域插槽验证子组件是否把当前 query 正确暴露给父级内容。
hint: ({ query }: HintSlotProps) =>
h('p', { class: 'hint' }, query ? `当前:${query}` : '请输入关键词'),
},
})
}
describe('SearchBox', () => {
it('渲染属性和插槽内容', () => {
const wrapper = mountSearchBox()
expect(wrapper.find('label').text()).toBe('站内搜索')
expect(wrapper.find('.hint').text()).toBe('请输入关键词')
expect((wrapper.find('button').element as HTMLButtonElement).disabled).toBe(true)
})
it('输入后更新按钮和作用域插槽', async () => {
const wrapper = mountSearchBox()
const input = wrapper.find('input')
await input.setValue(' vue ')
expect((input.element as HTMLInputElement).value).toBe(' vue ')
expect((wrapper.find('button').element as HTMLButtonElement).disabled).toBe(false)
expect(wrapper.find('.hint').text()).toBe('当前: vue ')
})
it('提交时向父组件发送规范化后的值', async () => {
const wrapper = mountSearchBox()
await wrapper.find('input').setValue(' vue ')
await wrapper.find('form').trigger('submit')
expect(wrapper.emitted('submit')).toEqual([['vue']])
})
})运行组件测试:
npx vitest run src/components/SearchBox.spec.ts预期输出中 3 个测试应全部通过;耗时等动态值可能不同。
✓ src/components/SearchBox.spec.ts (3 tests)
Test Files 1 passed (1)
Tests 3 passed (3)处理 Vue 更新时机与测试边界
setValue 会修改输入值并触发相应 DOM 事件,trigger 用于提交、点击等交互。两者返回 Promise,因此涉及 DOM 更新时应等待完成后再断言,否则测试可能在 Vue 刷新界面之前读取旧状态。
事件测试不仅要检查“发出过”,还应检查事件名、次数和参数。本例用 emitted('submit') 直接验证父组件最终收到 vue。插槽测试则确认插槽 props 的契约,而不是检查子组件内部状态。只要坚持从渲染、输入、事件和插槽这些对外行为断言,组件重构后的测试稳定性会明显更高。