👉 Si desean tener autocompletado en los archivos, pueden instalar los tipos de jest:
NPM
npm i @types/jest --save-dev
Yarn
yarn add -D @types/jest
Las pruebas end-to-end con Supertest te permiten automatizar lo que normalmente harías manualmente en Insomnia o Postman: enviar un request a un endpoint y validar su respuesta de forma programática. Aprenderás a montar un servidor en Express, lanzarle solicitudes desde código y verificar status codes, headers y body como un profesional del backend en Node.js.
¿Qué son las pruebas end-to-end y en qué se parecen a Postman?
Las pruebas end-to-end ejecutan un request real contra tu servidor y analizan la respuesta completa, igual que cuando pegas una URL en Insomnia, presionas send y revisas el resultado.
La diferencia está en el alcance y la automatización. En lugar de hacer clic una y otra vez para validar un solo caso de uso, escribes código que cubre múltiples escenarios para cada endpoint. Por ejemplo, al crear un producto no solo pruebas el caso feliz: también validas variantes, errores y formatos.
¿Qué hace una prueba end-to-end? Envía un request a un endpoint real, recibe la respuesta del servidor y verifica de forma programática que el status code, los headers y el body coincidan con lo esperado.
Lo interesante es que estas pruebas no se quedan en un solo aspecto. Puedes verificar si el servidor se conectó, si devolvió la información correcta, si validó los DTO y si respondió con el status code apropiado. Todo en un solo flujo automatizado.
¿Cómo instalar Supertest y preparar el entorno?
La herramienta más usada para pruebas end-to-end en Node.js es Supertest, y se instala como dependencia de desarrollo igual que Jest [3:48].
El flujo de instalación es directo:
app.endtoend.js para tu primera prueba.Una vez instalada, importas la librería con require y la guardas en una constante llamada request. Esta constante será la encargada de emular, o más bien ejecutar, los requests reales contra tu aplicación.
¿Cómo escribir tu primera prueba con Supertest y Express?
Dentro del archivo de prueba, primero montas una aplicación pequeña en Express con un endpoint que responda algo concreto, y después la pasas a Supertest para atacarla [5:30].
El ejemplo mínimo se ve así:
javascript const request = require('supertest'); const express = require('express');
const app = express();
app.get('/hello', (req, res) => { res.status(200).json({ name: 'Nico' }); });
app.listen(9000);
const api = request(app);
describe('Pruebas for app', () => { describe('GET /hello', () => { it('should return a response', async () => { const response = await api.get('/hello'); expect(response).toBeTruthy(); }); }); });
Fíjate en lo que pasa aquí. Creas la app, defines un endpoint /hello, la pones a escuchar en el puerto 9000 y le pasas la instancia a request. A partir de ese momento, api.get('/hello') ejecuta una solicitud real y guarda todo el detalle en response.
El matcher toBeTruthy confirma que la respuesta exista, es decir, que no sea null ni undefined. Es la validación más básica, pero suficiente para arrancar.
¿Qué puedes validar dentro del response?
El objeto response que devuelve Supertest contiene mucha más información de la que parece, y ahí está la riqueza de estas pruebas.
Entre las validaciones más comunes están:
expect(response.statusCode).toEqual(200) para confirmar el código HTTP esperado.expect(response.body.name).toEqual('Nico') para revisar el contenido del JSON devuelto.expect(response.headers['content-type']).toMatch(/json/) para verificar el formato de la respuesta.¿Qué validar en una prueba end-to-end? El status code, el contenido del body y los headers como
content-type. Con esos tres puntos cubres la mayor parte de los contratos que tu API debe cumplir.
Cuando ejecutas npm run test:endtoend con todas las aserciones bien escritas, Jest reporta que cada spec pasó. Si cambias el valor esperado, por ejemplo escribir 201 cuando el endpoint devuelve 200, la prueba falla y te muestra exactamente qué aserción rompió el contrato.
¿Por qué aparece el aviso de operación asíncrona sin terminar?
Al correr las pruebas, Jest puede mostrar un mensaje alarmante avisando que una operación asíncrona no ha parado y que la terminal queda colgada [13:20].
Esto sucede porque app.listen(9000) deja un proceso abierto escuchando en ese puerto, y Jest no lo cierra automáticamente al terminar las aserciones. Para salir, toca matar el proceso manualmente con Control C o Control Z, lo cual no es ideal en un flujo de integración continua.
Es un detalle importante porque indica que el servidor sigue vivo después de las pruebas, consumiendo recursos y bloqueando la terminal. La solución correcta pasa por manejar el ciclo de vida del servidor dentro de la prueba, algo que se aborda en la siguiente clase.
¿Ya intentaste escribir tu primera prueba end-to-end? Cuéntame en los comentarios qué endpoint validaste primero y qué matcher te resultó más útil.
Las pruebas end-to-end con Supertest te permiten automatizar lo que normalmente harías manualmente en Insomnia o Postman: enviar un request a un endpoint y validar su respuesta de forma programática. Aprenderás a montar un servidor en Express, lanzarle solicitudes desde código y verificar status codes, headers y body como un profesional del backend en Node.js.
Las pruebas end-to-end ejecutan un request real contra tu servidor y analizan la respuesta completa, igual que cuando pegas una URL en Insomnia, presionas send y revisas el resultado.
La diferencia está en el alcance y la automatización. En lugar de hacer clic una y otra vez para validar un solo caso de uso, escribes código que cubre múltiples escenarios para cada endpoint. Por ejemplo, al crear un producto no solo pruebas el caso feliz: también validas variantes, errores y formatos.
¿Qué hace una prueba end-to-end? Envía un request a un endpoint real, recibe la respuesta del servidor y verifica de forma programática que el status code, los headers y el body coincidan con lo esperado.
Lo interesante es que estas pruebas no se quedan en un solo aspecto. Puedes verificar si el servidor se conectó, si devolvió la información correcta, si validó los DTO y si respondió con el status code apropiado. Todo en un solo flujo automatizado.
La herramienta más usada para pruebas end-to-end en Node.js es Supertest, y se instala como dependencia de desarrollo igual que Jest [3:48].
El flujo de instalación es directo:
app.endtoend.js para tu primera prueba.Una vez instalada, importas la librería con require y la guardas en una constante llamada request. Esta constante será la encargada de emular, o más bien ejecutar, los requests reales contra tu aplicación.
Dentro del archivo de prueba, primero montas una aplicación pequeña en Express con un endpoint que responda algo concreto, y después la pasas a Supertest para atacarla [5:30].
El ejemplo mínimo se ve así:
javascript const request = require('supertest'); const express = require('express');
const app = express();
app.get('/hello', (req, res) => { res.status(200).json({ name: 'Nico' }); });
app.listen(9000);
const api = request(app);
describe('Pruebas for app', () => { describe('GET /hello', () => { it('should return a response', async () => { const response = await api.get('/hello'); expect(response).toBeTruthy(); }); }); });
Fíjate en lo que pasa aquí. Creas la app, defines un endpoint /hello, la pones a escuchar en el puerto 9000 y le pasas la instancia a request. A partir de ese momento, api.get('/hello') ejecuta una solicitud real y guarda todo el detalle en response.
El matcher toBeTruthy confirma que la respuesta exista, es decir, que no sea null ni undefined. Es la validación más básica, pero suficiente para arrancar.
El objeto response que devuelve Supertest contiene mucha más información de la que parece, y ahí está la riqueza de estas pruebas.
Entre las validaciones más comunes están:
expect(response.statusCode).toEqual(200) para confirmar el código HTTP esperado.expect(response.body.name).toEqual('Nico') para revisar el contenido del JSON devuelto.expect(response.headers['content-type']).toMatch(/json/) para verificar el formato de la respuesta.¿Qué validar en una prueba end-to-end? El status code, el contenido del body y los headers como
content-type. Con esos tres puntos cubres la mayor parte de los contratos que tu API debe cumplir.
Cuando ejecutas npm run test:endtoend con todas las aserciones bien escritas, Jest reporta que cada spec pasó. Si cambias el valor esperado, por ejemplo escribir 201 cuando el endpoint devuelve 200, la prueba falla y te muestra exactamente qué aserción rompió el contrato.
Al correr las pruebas, Jest puede mostrar un mensaje alarmante avisando que una operación asíncrona no ha parado y que la terminal queda colgada [13:20].
Esto sucede porque app.listen(9000) deja un proceso abierto escuchando en ese puerto, y Jest no lo cierra automáticamente al terminar las aserciones. Para salir, toca matar el proceso manualmente con Control C o Control Z, lo cual no es ideal en un flujo de integración continua.
Es un detalle importante porque indica que el servidor sigue vivo después de las pruebas, consumiendo recursos y bloqueando la terminal. La solución correcta pasa por manejar el ciclo de vida del servidor dentro de la prueba, algo que se aborda en la siguiente clase.
¿Ya intentaste escribir tu primera prueba end-to-end? Cuéntame en los comentarios qué endpoint validaste primero y qué matcher te resultó más útil.
👉 Si desean tener autocompletado en los archivos, pueden instalar los tipos de jest:
NPM
npm i @types/jest --save-dev
Yarn
yarn add -D @types/jest
Jest y Supertest son dos herramientas que se utilizan comúnmente en el desarrollo de software en JavaScript para probar y evaluar aplicaciones, pero se enfocan en aspectos diferentes:
Jest: Jest es un framework de pruebas unitarias y de integración para JavaScript. Se utiliza para escribir y ejecutar pruebas automatizadas que verifican el comportamiento de las diferentes partes de una aplicación. Jest proporciona una amplia gama de utilidades y funciones para escribir pruebas de manera efectiva. Algunas características destacadas de Jest incluyen:
Assertions Integradas: Jest incluye un conjunto de aserciones (assertions) integradas que permiten verificar que los resultados de las funciones y componentes sean los esperados.
Mocks y Espías: Jest ofrece herramientas para crear mocks y espías, lo que facilita la simulación de componentes o módulos externos en las pruebas.
Testing Asincrónico: Jest maneja de manera efectiva las pruebas asincrónicas utilizando funciones como async/await o el uso de las funciones globales setTimeout y setInterval.
Snapshot Testing: Jest es conocido por su característica de "snapshot testing", que permite capturar el estado actual de un componente y luego compararlo con futuras ejecuciones para detectar cambios no deseados.
Supertest: Supertest, por otro lado, es una biblioteca que se utiliza para probar APIs HTTP en aplicaciones Node.js. Su principal objetivo es simular solicitudes HTTP y evaluar las respuestas obtenidas desde una perspectiva externa. Algunas características de Supertest son:
Solicitudes HTTP Simuladas: Supertest permite realizar solicitudes HTTP (GET, POST, PUT, DELETE, etc.) a una API simulada o en ejecución.
Evaluación de Respuestas: Con Supertest, puedes verificar las respuestas HTTP recibidas, como los códigos de estado, encabezados y cuerpo de respuesta.
Uso con Otros Marcos de Pruebas: Supertest se utiliza comúnmente en combinación con frameworks de pruebas como Mocha o Jest para probar APIs y servicios.
En resumen, Jest se enfoca en las pruebas unitarias e integración de código JavaScript en general, mientras que Supertest está diseñado específicamente para probar APIs HTTP y servicios en Node.js. Dependiendo de tus necesidades, podrías utilizar Jest para probar la lógica interna de tus componentes y funciones, y Supertest para probar las interacciones HTTP de tu aplicación.
Muy interesante esta clase
No se necesita corrar la api app.listen(PORT), para poder correr las pruebas con supertest
La UI de Postman es mejor que Insomnia