javascript
  3 min. de lectura (aproximado)

Pruebas en JavaScript con jest: guía básica

(3 min. de lectura) Jest es un framework de testing para JavaScript y TypeScript, muy popular en el mundo del desarrollo frontend y backend. Jest lo creó Facebook (Meta). Su función principal es permitir a los desarrolladores escribir, ejecutar y evaluar pruebas automatizadas para garantizar que su código funcione correctamente. Jest es especialmente famoso por ser el framework por defecto cuando se trabaja con React, aunque hoy en día mucha gente está migrando a Vitest.

Ejemplo básico de prueba con Jest

test('suma dos números correctamente', () => {
  expect(2 + 2).toBe(4);
});
Jest es muy maduro, enorme ecosistema, mucha documentación y soporte. Pero Vitest es más moderno, mucho más rápido, mejor integración con Vite,el build tool más usado actualmente.

Características principales

Característica Descripción
Configuración cero Funciona muy bien sin necesidad de mucha configuración inicial
Snapshot Testing Permite guardar el "resultado esperado" de un componente o función
Mocking Muy fácil simular módulos, funciones, APIs, etc.
Ejecución paralela Corre las pruebas de forma rápida y en paralelo
Watch Mode Modo que vuelve a ejecutar solo las pruebas modificadas
Coverage Reporte de cobertura de código integrado
Compatible con React, Vue, Angular, NODEJS, TypeScript, etc.

Instalación básica de Jest

npm install -D jest
Añadir en el fichero "package.json"

{
  "scripts": {
"test": "jest",
"test:watch": "jest --watch"
  }
}

Ejemplo básico

Fichero "math.js"

function sumar(a, b) {
  return a + b;
}

function restar(a, b) {
  return a - b;
}

function esPar(numero) {
  return numero % 2 === 0;
}

module.exports = { sumar, restar, esPar };
Fichero "math.test.js"

const { sumar, restar, esPar } = require('./math');

test('debería sumar dos números', () => {
  expect(sumar(2, 3)).toBe(5);
  expect(sumar(10, -5)).toBe(5);
});

test('debería restar dos números', () => {
  expect(restar(10, 4)).toBe(6);
});

test('debería detectar si un número es par', () => {
  expect(esPar(4)).toBe(true);
  expect(esPar(7)).toBe(false);
});

Usando "describe" e "it"

const { sumar } = require('./math');

describe('Función sumar', () => {

  it('debería sumar dos números positivos', () => {
expect(sumar(3, 5)).toBe(8);
  });

  it('debería sumar números negativos', () => {
expect(sumar(-3, -2)).toBe(-5);
  });

  it('debería sumar cero', () => {
expect(sumar(5, 0)).toBe(5);
  });

});

Matchers más usados en Jest

test('Matchers básicos', () => {

  expect(5).toBe(5); // igualdad estricta (===)
  expect({ nombre: "Juan" }).toEqual({ nombre: "Juan" }); // comparación profunda
  expect([1, 2, 3]).toContain(2);  // contiene elemento
  expect("Hola mundo").toContain("mundo");

  expect(true).toBeTruthy();
  expect(false).toBeFalsy();
  expect(null).toBeNull();
  expect(undefined).toBeUndefined();

  expect(() => { throw new Error("Error!") }).toThrow();
  expect(10).toBeGreaterThan(5);
  expect(10).toBeLessThan(15);

});

Testing de funciones asíncronas

// user.js
async function obtenerUsuario(id) {
  const res = await fetch(`https://api.ejemplo.com/users/${id}`);
  return res.json();
}

// user.test.js
test('debería obtener un usuario', async () => {
  const usuario = await obtenerUsuario(1);
  
  expect(usuario).toHaveProperty('id');
  expect(usuario.nombre).toBeDefined();
});

Mock básico (simular función)

const { obtenerUsuario } = require('./user');

test('debería llamar a la API', async () => {
  // Crear mock
  global.fetch = jest.fn().mockResolvedValue({
json: jest.fn().mockResolvedValue({ id: 1, nombre: "María" })
  });

  const usuario = await obtenerUsuario(1);

  expect(fetch).toHaveBeenCalledWith('https://api.ejemplo.com/users/1');
  expect(usuario.nombre).toBe("María");
});