Testing con Supertest y Vitest

Una prueba de endpoint debe verificar el contrato observable: entrada, status, forma de respuesta y efecto permitido. Supertest puede enviar la petición a la aplicación y Vitest organizar los casos. La prueba no necesita comprobar cada línea interna si cubre una decisión crítica.

Ejemplo resuelto

Para POST /enrollments, prepara un usuario autenticado y un curso existente. La respuesta válida debe ser 201 y contener la relación creada. Repite con el mismo usuario y curso: espera 409. Añade un usuario sin permiso cuando la ruta sea restringida: espera 403 y confirma que no aumentó el número de inscripciones.

La app de la primera lección puede comprobarse con estas pruebas independientes:

import request from 'supertest';
import { describe, it, expect } from 'vitest';
import { createApp } from './app.js';
describe('contrato de detalle', () => {
  it('devuelve el curso existente', async () => {
    const res = await request(createApp()).get('/courses/c1');
    expect(res.status).toBe(200);
    expect(res.body).toEqual({ id: 'c1', title: 'JavaScript' });
  });
  it('controla un ID inexistente', async () => {
    const res = await request(createApp()).get('/courses/c9');
    expect(res.status).toBe(404);
    expect(res.body.error).toBe('COURSE_NOT_FOUND');
  });
});

Para el duplicado de inscripciones, crea primero la inscripción dentro del mismo caso que probará 409. El caso de permiso necesita una política concreta, por ejemplo usuario suspendido: un estudiante activo sí puede inscribirse según este proyecto. No mezcles ese permiso con el de publicar cursos.

Pruébalo

1. Prepara datos mínimos y aislados.

2. Envía el caso válido y comprueba status y cuerpo.

3. Envía duplicado y permiso insuficiente.

4. Limpia o reinicia los datos entre casos.

Error frecuente: probar solo el camino feliz. Corrígelo incluyendo entradas inválidas, duplicados y ausencia de autorización.

Comprueba tu resultado

La matriz mínima debe contener tres filas: válido 201, duplicado 409 y sin permiso 403. En la última fila, el contador de inscripciones debe coincidir con el valor anterior; ninguna prueba puede depender del orden accidental de otra.