Una prueba
Una prueba ejecuta una pieza de código y comprueba el resultado. Si la comprobación falla, la prueba falla:
// precio.js
export function conDescuento(precio, porcentaje) {
if (porcentaje < 0 || porcentaje > 100) throw new RangeError("porcentaje inválido");
return precio * (1 - porcentaje / 100);
}
// precio.test.js, con el ejecutor incluido en Node.js
import { describe, it } from "node:test";
import assert from "node:assert/strict";
import { conDescuento } from "./precio.js";
describe("conDescuento", () => {
it("aplica el porcentaje", () => {
assert.equal(conDescuento(200, 25), 150);
});
it("sin descuento devuelve el mismo precio", () => {
assert.equal(conDescuento(80, 0), 80);
});
it("rechaza porcentajes imposibles", () => {
assert.throws(() => conDescuento(80, 120), RangeError);
});
});
node --test # busca y ejecuta los archivos *.test.js
node --test --watch # vuelve a ejecutar al guardar
Vitest
Vitest es el ejecutor más usado en proyectos con Vite. Usa expect, con la API de Jest, y se integra con la configuración de Vite (TypeScript, alias, plugins):
import { describe, it, expect } from "vitest";
import { conDescuento } from "./precio.js";
describe("conDescuento", () => {
it("aplica el porcentaje", () => {
expect(conDescuento(200, 25)).toBe(150);
});
it("devuelve objetos iguales", () => {
expect({ total: 150, moneda: "PEN" }).toEqual({ total: 150, moneda: "PEN" }); // compara el contenido
});
});
toBe compara con ===; toEqual, el contenido de objetos y arrays. Hay muchos más: toContain, toThrow, toMatch, toBeCloseTo (para decimales)…
Asíncronas, ganchos y mocks
import { describe, it, expect, beforeEach, vi } from "vitest";
describe("carrito", () => {
let carrito;
beforeEach(() => {
carrito = []; // cada prueba empieza con un carrito limpio
});
it("espera promesas con async/await", async () => {
const datos = await Promise.resolve({ ok: true });
expect(datos.ok).toBe(true);
});
it("controla el tiempo y las funciones con mocks", () => {
vi.useFakeTimers();
const avisar = vi.fn(); // una función de mentira que registra sus llamadas
setTimeout(avisar, 1000);
vi.advanceTimersByTime(1000); // adelanta el reloj sin esperar
expect(avisar).toHaveBeenCalledTimes(1);
vi.useRealTimers();
});
});
Qué probar
- Pruebas unitarias: una función o un módulo, aislados. Muchas, rápidas.
- Pruebas de integración: varias piezas juntas (tu API con una base de datos de prueba).
- Pruebas de extremo a extremo (E2E): la aplicación entera en un navegador real, como un usuario, con Playwright. Pocas, pero valiosas: este sitio se prueba así.
Prueba el comportamiento (qué devuelve, qué muestra), no los detalles internos: así puedes reescribir el código sin reescribir las pruebas. Y prueba los casos borde: vacío, cero, negativo, el máximo, el error.
Resumen
- Una prueba ejecuta código y comprueba el resultado; corre en segundos cada vez que cambias algo.
node:test+node:assertvienen con Node.js; Vitest es la opción con Vite.toBecompara con===;toEqual, el contenido.- Pruebas asíncronas con
async/await;beforeEachpara empezar limpio; mocks para la red, el tiempo y las dependencias. - Muchas unitarias, algunas de integración, pocas E2E. Prueba el comportamiento y los casos borde.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Código que comprueba código
Resuelto
Elige una respuesta en cada pregunta.
¿Qué es una prueba unitaria?
¿Necesitas instalar algo para escribir pruebas en Node.js?
¿Qué es un mock?
Si una prueba falla, ¿dónde está el error?
Ordena la salida: Los ganchos de una suite
Resuelto
Una suite con ganchos que avisan cuándo corren. Ordena lo que aparecería en la terminal.
1import { describe, it, before, beforeEach, after } from "node:test";2 3describe("carrito", () => {4 let n = 0;5 before(() => console.log("before"));6 beforeEach(() => console.log("beforeEach", ++n));7 after(() => console.log("after"));8 9 it("agrega", () => console.log("prueba: agrega"));10 it("quita", () => console.log("prueba: quita"));11});Consola, de arriba abajo
- beforeEach 2
- after
- before
- prueba: agrega
- prueba: quita
- beforeEach 1
before corre una vez, antes de todas las pruebas; beforeEach, antes de cada una (ideal para preparar datos limpios); after, al final. Así cada prueba empieza desde el mismo estado.
Detective: Una prueba que falla
Resuelto
Una prueba falla. Antes de tocar el código, encuentra dónde está el error de verdad y elige el arreglo.
Consola
✖ suma dos números (0.8ms)
AssertionError [ERR_ASSERTION]: Expected values to be strictly equal:
2 !== 3
at TestContext.<anonymous> (file:///proyecto/sumar.test.js:6:10)
ℹ tests 1
ℹ pass 0
ℹ fail 1Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Probar y arreglar
Resuelto
Con un mini ejecutor de pruebas, escribe tres pruebas para precioFinal, descubre el error y arréglalo.
$ node programa.js
Lo que debe cumplir
- Hay al menos tres pruebas (pendiente)
- Todas las pruebas pasan (pendiente)
- La función está arreglada:
precioFinal(80, 25)da60(pendiente)
Una solución
1const resultados = [];2function prueba(nombre, fn) {3 try {4 fn();5 resultados.push(`✔ ${nombre}`);6 } catch (e) {7 resultados.push(`✘ ${nombre}: ${e.message}`);8 }9}10function esperar(real) {11 return {12 toBe(esperado) {13 if (real !== esperado) throw new Error(`esperaba ${esperado}, llegó ${real}`);14 },15 };16}17 18function precioFinal(precio, descuento) {19 return precio * (1 - descuento / 100);20}21 22prueba("sin descuento", () => esperar(precioFinal(100, 0)).toBe(100));23prueba("con 50 %", () => esperar(precioFinal(80, 50)).toBe(40));24prueba("con 100 %", () => esperar(precioFinal(30, 100)).toBe(0));25 26console.log(resultados.join("\n"));Con la función original, la prueba sin descuento pasa (100 − 0 = 100), pero las otras dos fallan: restaba 0,5 en lugar del 50 %. Escribir primero las pruebas y después arreglar el código hasta que pasen es la idea de TDD (desarrollo guiado por pruebas).