前端测试已经从"可选的善后工作"变成了"必备的工程实践"。Vitest 3.0 在 2026 年成为了前端测试的事实标准,提供了比 Jest 更快的速度和更好的 ESM 支持。
快照测试的正确用法
快照测试是检测 UI 回归的有效手段,但需要正确使用:
typescript
import { describe, it, expect } from 'vitest';
import { render, screen } from '@testing-library/vue';
import UserCard from './UserCard.vue';
describe('UserCard', () => {
it('渲染默认状态', () => {
const { container } = render(UserCard, {
props: {
name: 'Alice',
role: 'Admin',
avatar: '/avatar.jpg'
}
});
expect(container).toMatchSnapshot();
});
it('渲染加载状态', () => {
const { container } = render(UserCard, {
props: { loading: true }
});
expect(container).toMatchSnapshot();
});
});
快照测试的原则:
- 快照要小:只测试关键 UI 结构,不测试样式细节
- 快照要稳定:避免包含随机值(时间戳、UUID)
- 定期审查:不要盲目接受快照更新
组件测试策略
组件测试应该关注行为而非实现:
typescript
import { describe, it, expect } from 'vitest';
import { render, fireEvent } from '@testing-library/vue';
import Counter from './Counter.vue';
describe('Counter', () => {
it('点击增加按钮时计数器加一', async () => {
render(Counter, { props: { initialValue: 0 } });
const button = screen.getByRole('button', { name: /增加/i });
await fireEvent.click(button);
expect(screen.getByText('1')).toBeInTheDocument();
});
it('达到最大值时禁用增加按钮', async () => {
render(Counter, { props: { initialValue: 9, max: 10 } });
const button = screen.getByRole('button', { name: /增加/i });
await fireEvent.click(button);
expect(button).toBeDisabled();
});
});
Mock 策略
Mock 应该只在必要时使用:
typescript
import { describe, it, expect, vi, beforeEach } from 'vitest';
import { mount } from '@vue/test-utils';
import UserProfile from './UserProfile.vue';
// Mock API
vi.mock('./api', () => ({
getUser: vi.fn(),
updateUser: vi.fn()
}));
describe('UserProfile', () => {
beforeEach(() => {
vi.clearAllMocks();
});
it('加载并显示用户数据', async () => {
const mockUser = { id: 1, name: 'Alice', email: 'alice@example.com' };
vi.mocked(getUser).mockResolvedValue(mockUser);
mount(UserProfile, { props: { userId: 1 } });
expect(getUser).toHaveBeenCalledWith(1);
await nextTick();
expect(screen.getByText('Alice')).toBeInTheDocument();
});
});
Mock 的原则:
- API 调用必须 Mock:避免依赖网络
- 外部服务必须 Mock:数据库、第三方 API
- 内部逻辑尽量不 Mock:测试真实行为
异步测试
异步测试是前端测试的难点:
typescript
import { describe, it, expect, vi } from 'vitest';
import { render, waitFor } from '@testing-library/vue';
import DataList from './DataList.vue';
describe('DataList', () => {
it('加载完成后显示数据', async () => {
const mockData = [
{ id: 1, name: 'Item 1' },
{ id: 2, name: 'Item 2' }
];
global.fetch = vi.fn().mockResolvedValue({
json: () => Promise.resolve(mockData)
});
render(DataList);
// 等待加载完成
await waitFor(() => {
expect(screen.getByText('Item 1')).toBeInTheDocument();
expect(screen.getByText('Item 2')).toBeInTheDocument();
});
});
});
覆盖率报告
Vitest 3.0 的覆盖率报告更准确:
typescript
// vitest.config.ts
export default defineConfig({
test: {
coverage: {
provider: 'v8',
reporter: ['text', 'json', 'html'],
exclude: [
'node_modules/',
'src/**/*.spec.ts',
'src/**/*.test.ts'
]
}
}
});
覆盖率的目标不是 100%,而是关键路径的覆盖:
- 语句覆盖率 > 80%:大部分代码被执行过
- 分支覆盖率 > 70%:主要条件分支被测试
- 函数覆盖率 > 90%:所有公共函数都有测试
测试组织
测试文件应该与源文件保持对应:
src/
components/
UserCard.vue
UserCard.spec.ts
composables/
useAuth.ts
useAuth.spec.ts
utils/
formatDate.ts
formatDate.spec.ts
测试描述应该清晰表达预期行为:
typescript
describe('formatDate', () => {
it('格式化 ISO 日期字符串为本地格式', () => {
expect(formatDate('2026-06-11T16:00:00Z')).toBe('2026年6月11日');
});
it('空字符串返回空字符串', () => {
expect(formatDate('')).toBe('');
});
it('无效日期返回原始字符串', () => {
expect(formatDate('invalid')).toBe('invalid');
});
});
测试性能
Vitest 已经很快,但大规模测试仍需优化:
typescript
// vitest.config.ts
export default defineConfig({
test: {
// 并行测试
threads: true,
// 测试文件匹配
include: ['src/**/*.spec.ts'],
// 设置文件
setupFiles: ['./src/test-setup.ts'],
// 超时设置
testTimeout: 10000
}
});
优化策略:
- 减少 I/O:使用内存文件系统 Mock 文件操作
- 避免重复渲染:使用
beforeEach复用组件 - 并行执行:独立测试并行运行
- 按需 Mock:只 Mock 必要的依赖
测试驱动开发(TDD)
TDD 在前端同样适用:
typescript
// 1. 写一个失败的测试
it('验证邮箱格式', () => {
expect(validateEmail('test@example.com')).toBe(true);
expect(validateEmail('invalid')).toBe(false);
});
// 2. 写最少的代码让测试通过
function validateEmail(email: string): boolean {
return email.includes('@');
}
// 3. 重构代码
function validateEmail(email: string): boolean {
const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
return regex.test(email);
}
小结
Vitest 3.0 让前端测试变得更快、更容易。快照测试检测 UI 回归,组件测试验证行为,Mock 隔离外部依赖。2026 年的测试原则:测试行为不测试实现,Mock 只在必要时使用,覆盖率关注关键路径。好的测试不是覆盖率高,而是能在重构时提供信心。
