Pruebas en Next.js
Prioridad: P1 (ALTA)
Estructura
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # Handlers de MSW
Directrices de Implementación
- Pruebas Unitarias: Use Vitest por su velocidad y React Testing Library (RTL) para el comportamiento de componentes. Siga los patrones Arrange-Act-Assert (AAA).
- Pruebas E2E: Use Playwright para la validación completa del App Router. Enfóquese en Flujos de Usuario (ej. Inicio de sesión, Proceso de compra).
- Red: Simule todos los límites de API internos/externos usando Mock Service Worker (MSW). Asegúrese de que los handlers
server y browser estén configurados correctamente.
- Pruebas de RSC: Pruebe los Componentes de Servidor de React (RSC) usando los mismos patrones que las bibliotecas (pruebas compatibles con SSR). Prefiera pruebas E2E para lógica compleja de obtención de datos asíncrona.
- Interacciones: Use
userEvent (async) para simular acciones del usuario: await user.click(boton).
- Selectores: Favorezca
getByRole / findByRole para probar la accesibilidad. Use data-testid solo como alternativa.
- Entorno: Configure
vitest.config.ts con jsdom o happy-dom para las pruebas de componentes.
- Reportes: Asegúrese de que las pruebas generen informes de cobertura en JSON para los gates de CI. Apunte a una cobertura del 80% o superior en las bibliotecas principales.
Anti-Patrones
- Sin uso de red real en las pruebas: Use siempre handlers de MSW o mocks.
- Sin pruebas de implementación: Pruebe el comportamiento del usuario, no los métodos internos.
- Sin E2E pesados para lógica unitaria: Use Vitest para pruebas de lógica aislada.
- Sin fuga de estado global: Reinicie los handlers de MSW y los mocks después de cada prueba.
Referencias