---

name: testing description: 测试规范与最佳实践。Use when writing unit tests, integration tests, or component tests. Triggers on: creating test files, using Vitest, Testing Library, mocking, test organization questions.

Testing Guide

测试规范，涵盖 Vitest、Testing Library 和测试组织。

Quick Start

Copyimport { describe, it, expect } from 'vitest';

describe('ModuleName', () => {
  it('should behavior description', () => {
    expect(actual).toBe(expected);
  });
});

Test Location

All tests in __tests__/ directory, mirroring source structure:

Copy__tests__/
├── lib/utils/
├── lib/services/
├── components/
└── hooks/

File Naming

• Unit tests: *.test.ts / *.test.tsx
• Integration tests: *.spec.ts / *.spec.tsx

Commands

Copypnpm test           # Run all tests
pnpm test:watch     # Watch mode
pnpm test:coverage  # Coverage report

Component Test

Copyimport { render, screen } from '@testing-library/react';
import { Button } from '@/components/ui/button';

describe('Button', () => {
  it('should render children', () => {
    render(<Button>Click</Button>);
    expect(screen.getByText('Click')).toBeInTheDocument();
  });
});

Mocking

Copyimport { vi } from 'vitest';

vi.mock('@/lib/services', () => ({
  UserService: {
    getUser: vi.fn().mockResolvedValue({ id: '1' }),
  },
}));

Coverage Requirements

1. Normal path - Expected behavior
2. Edge cases - Empty, null, boundary values
3. Error handling - Exception scenarios