Pruebas unitarias y de integración automatizadas
En esta página
Automatiza la escritura de pruebas
Las pruebas son lo primero que se elimina cuando escasea el tiempo, y la deuda técnica más costosa a largo plazo. Codex cambia la ecuación: generar una cobertura completa para un módulo pasa de ser una tarea de toda una tarde a cuestión de minutos. Sin embargo, debes pedir algo más que «escribe pruebas», una instrucción que suele producir un puñado de casos nominales: verdes, reconfortantes e inútiles.
Genera pruebas unitarias
La palanca principal es que nombres tú mismo los casos límite. Tú conoces tu dominio de negocio; el agente no sabe que un descuento superior al 100 % ocurre una vez al trimestre en tus datos.
"Genera pruebas unitarias para src/lib/pricing.ts.
Usa Vitest. Cubre todos los casos límite: precio negativo,
descuento > 100 %, moneda no válida, cantidad cero."
Codex analiza el código fuente, identifica las funciones exportadas, comprende su lógica y produce luego un conjunto de pruebas que cubre tanto las rutas normales como los casos que has citado.
// src/lib/pricing.test.ts
import { describe, it, expect } from "vitest";
import { calculatePrice, applyDiscount, formatPrice } from "./pricing";
describe("calculatePrice", () => {
it("calcula el precio total para una cantidad positiva", () => {
expect(calculatePrice(10, 3)).toBe(30);
});
it("devuelve 0 para una cantidad de cero", () => {
expect(calculatePrice(10, 0)).toBe(0);
});
it("lanza un error para un precio negativo", () => {
expect(() => calculatePrice(-5, 1)).toThrow("Invalid price");
});
});
describe("applyDiscount", () => {
it("aplica un descuento estándar", () => {
expect(applyDiscount(100, 20)).toBe(80);
});
it("rechaza un descuento superior al 100 %", () => {
expect(() => applyDiscount(100, 150)).toThrow();
});
});
Un detalle merece inspección: el mensaje de error esperado, «Invalid price», se ha extraído de la implementación real, no se ha inventado. Esta es la firma de una prueba escrita desde el código y no desde una plantilla, y lo primero que debes comprobar al revisar un conjunto de pruebas generado.
Genera pruebas de integración
Para una ruta de API o un servicio que toca la base de datos, necesitas proporcionar más contexto, especialmente sobre qué simular (mock).
"Genera pruebas de integración para src/api/routes/orders.ts.
Usa supertest para las peticiones HTTP. Simula el servicio
de Stripe con vi.mock. Escenarios de prueba: creación de pedido,
pedido con producto inexistente, pago fallido."
Codex distingue claramente entre los dos niveles de prueba: configura los mocks adecuados, gestiona la configuración y limpieza de la base de datos de pruebas y simula servicios externos. Nombrar explícitamente Stripe y supertest evita que invente una infraestructura paralela a la que tu equipo ya utiliza.
Cubre un proyecto entero
En un proyecto estructuralmente carente de pruebas, una tarea global es más eficaz que una serie de peticiones archivo por archivo.
"Analiza todos los archivos .ts en src/lib/ y src/services/.
Por cada archivo sin su correspondiente .test.ts,
genera pruebas unitarias. Apunta a una cobertura de ramas > 80 %."
Codex procesa entonces los archivos uno a uno, adaptando las pruebas a cada módulo; cuenta con varios minutos de ejecución para un conjunto completo. Ejecuta esta tarea en una carpeta cada vez en lugar de hacerlo en todo el directorio src/: más allá de eso, la solicitud de extracción (pull request) se vuelve demasiado grande para revisarla, y un conjunto de pruebas aprobado sin leerlo no protege a nadie.
Mejora las pruebas existentes
Codex no solo crea; también puede diagnosticar un conjunto de pruebas que tranquiliza sin proteger.
"Analiza las pruebas en src/__tests__/. Identifica:
- Pruebas que solo comprueban una ruta (camino feliz)
- Aserciones vagas (toBeTruthy en lugar de toBe)
- Pruebas que comparten estado mutable
Corrige estos problemas."
Estos tres síntomas explican la mayoría de los conjuntos de pruebas en verde que dejan pasar errores. El tercero es el más insidioso: las pruebas que comparten estado mutable pasan mientras se ejecutan en el orden habitual, y comienzan a fallar aleatoriamente el día que activas la paralelización.
Pruebas por tipo de componente
El tipo de prueba que debes solicitar depende directamente de la naturaleza del código, y la instrucción cambia con ello.
| Tipo de código | Tipo de prueba | Instrucción para Codex |
|---|---|---|
| Función utilitaria | Unitaria | «Prueba todas las entradas y salidas posibles» |
| Ruta de API | Integración | «Prueba con supertest, simula servicios externos» |
| Componente React | Renderizado | «Prueba el renderizado y las interacciones con Testing Library» |
| Servicio con BD | Integración | «Usa una BD de pruebas, reinicia entre cada prueba» |
Configura AGENTS.md para las pruebas
En lugar de repetir estas elecciones para cada tarea, escríbelas de una vez por todas en una sección dedicada de AGENTS.md.
## Pruebas
- Framework: Vitest
- Comando: `npm run test`
- Cobertura: `npm run test:coverage`
- Convención: archivos .test.ts junto al código fuente
- Mocks: usa vi.mock(), sin mocks manuales
- Aserciones: prefiere toBe/toEqual frente a toBeTruthy/toBeFalsy
- Cada prueba debe ser independiente (sin estado compartido)
Con estas siete líneas, Codex aplica tus convenciones a cada prueba que genera, incluso cuando un desarrollador apresurado formula su petición en tres palabras. Esta es la forma más económica de hacer que la calidad de tus pruebas sea independiente de la calidad de la instrucción.
Puntos clave
- Codex genera pruebas adaptadas a tu código, no pruebas genéricas
- Especifica los casos límite que quieres cubrir en tus instrucciones
- Codex distingue entre pruebas unitarias y de integración
- Usa AGENTS.md para definir tus convenciones de prueba
- Codex puede mejorar las pruebas existentes, no solo crear nuevas