Skip to content

testing-patterns.md

Latest commit

 

History

History
131 lines (79 loc) · 3.74 KB

testing-patterns.md

File metadata and controls

131 lines (79 loc) · 3.74 KB
Raw

🧪 Testing Architecture

Comprehensive testing strategy using Vitest for unit tests and Playwright for E2E testing with proper test isolation.

🏗️ Testing Structure

test/
├── unit/
│   ├── setup.ts            # Vitest configuration
│   └── components/         # Component tests
│       └── ui/
│           └── form/       # Form component tests
└── e2e/
    ├── auth.setup.ts       # Playwright authentication setup
    ├── db.setup.ts         # Database setup for E2E tests
    ├── app/
    │   └── home.spec.ts    # Home page functionality
    └── swagger/
        └── swagger-protection.spec.ts  # API documentation protection

🔧 Vitest Configuration

Test Setup

Implementation: See test/unit/setup.ts for Vitest configuration and Nuxt composable mocking.

Component Testing

Implementation: See test/unit/components/ for Vue component testing patterns with Vue Test Utils.

Composable Testing

Implementation: Composable testing patterns can be implemented for usePostForm and other composables.

Store Testing

Implementation: Pinia store testing can be implemented with createPinia setup.

🎭 Playwright E2E Testing

Configuration

Configuration: See playwright.config.ts for Playwright setup with multi-browser testing and CI optimization.

Authentication Testing

Implementation: Authentication flow testing can be implemented for login/register flows.

API Testing

Implementation: API route testing with authentication scenarios can be implemented.

🔧 Test Utilities

Page Object Model

Implementation: Page Object Model patterns can be implemented for reusable page methods.

Test Data Factory

Implementation: Test data factory functions can be implemented for generating test data.

Database Helpers

Implementation: Database reset and seeding utilities can be implemented for test isolation.

🗄️ Database Testing

Test Database Isolation

Implementation: Test database isolation can be implemented with beforeAll/afterAll hooks and TEST_DATABASE_URL.

Transaction Rollback Pattern

Implementation: Prisma transaction rollback patterns can be implemented for API testing.

🎯 Testing Best Practices

Test Organization

  1. Arrange-Act-Assert pattern for clarity
  2. Descriptive test names that explain behavior
  3. Single assertion per test when possible
  4. Test isolation with proper setup/teardown

Component Testing

  1. Test behavior, not implementation
  2. Use data-testid for reliable element selection
  3. Mock external dependencies
  4. Test user interactions

E2E Testing

  1. Test critical user journeys
  2. Use Page Object Model for maintainability
  3. Test across multiple browsers
  4. Include accessibility testing

Performance Testing

Implementation: Page load time testing can be implemented with Playwright.

📊 Test Coverage

Coverage Configuration

Configuration: See vitest.config.ts for test coverage thresholds and provider configuration.

Running Tests

Commands: See package.json scripts for available test commands including unit, E2E, coverage, and debug modes.

🔍 Debugging Tests

Vitest Debugging

Implementation: Debugging patterns can be implemented with vi.fn() mock inspection and component HTML logging.

Playwright Debugging

Commands: Use --debug, --headed flags and trace viewer for E2E test debugging.

📚 Testing Resources