Tema 16 · Testing & Despliegue

16. Pruebas Unitarias con Jest, Testing E2E con Supertest y Despliegue en Producción

Prueba servicios aislando dependencias con TestingModule, ejecuta pruebas E2E HTTP y compila tu aplicación para producción con Docker o PM2 y Nginx.

Testing de Primera Clase gracias a la Inyección de Dependencias

Aquí es donde la arquitectura de NestJS rinde sus mayores frutos: como los controladores y servicios reciben sus dependencias a través del constructor, el paquete @nestjs/testing permite levantar un módulo aislado en milisegundos (Test.createTestingModule()) y reemplazar cualquier base de datos o pasarela de pagos por un Mock (simulador).

Tipo de Prueba Comando Qué Verifica
Pruebas Unitarias (Jest) npm run test Prueba métodos individuales de un servicio o controlador en memoria reemplazando repositorios con useValue: mockRepo.
Pruebas E2E (Supertest) npm run test:e2e Levanta la aplicación completa en memoria y dispara peticiones HTTP reales (GET /api/v1/cursos) verificando Guards, Pipes y códigos HTTP.

Compilación y Despliegue en Producción (VPS Linux / Docker)

En producción jamás ejecutamos TypeScript con ts-node o start:dev. Primero compilamos el proyecto a JavaScript puro optimizado en la carpeta dist/ y luego ejecutamos el binario compilado detrás de un proxy inverso Nginx:

# 1. Compilar TypeScript a JavaScript de alto rendimiento en dist/
npm run build

# 2. Ejecutar en producción con Node.js (o gestionado con PM2 / Docker)
NODE_ENV=production node dist/main.js

⚡ Prueba Unitaria de un Servicio con TestingModule y Mock Repository

Aislamiento completo de CursosService en Jest sin tocar la base de datos MySQL real:

src/cursos/cursos.service.spec.ts
Solo lectura
import { Test, TestingModule } from '@nestjs/testing';
import { NotFoundException } from '@nestjs/common';
import { CursosService } from './cursos.service';

describe('CursosService (Pruebas Unitarias)', () => {
  let service: CursosService;

  beforeEach(async () => {
    // Crea un contenedor IoC aislado exclusivamente para la prueba
    const module: TestingModule = await Test.createTestingModule({
      providers: [CursosService],
    }).compile();

    service = module.get<CursosService>(CursosService);
  });

  it('debe retornar la lista de cursos activos de Kilopolis Academia', () => {
    const cursos = service.listar();
    expect(cursos.length).toBeGreaterThan(0);
    expect(cursos[0].instructor).toBe('Juan Sebastián Amador');
  });

  it('debe lanzar NotFoundException (404) si el slug del curso no existe', () => {
    expect(() => service.buscarPorSlug('curso-inexistente')).toThrow(NotFoundException);
  });
});
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la forma correcta de ejecutar una aplicación NestJS en un servidor de producción tras haber finalizado el desarrollo?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.