Referencia rápida

Hoja de referencia de Jest Testing Framework

Guia rapida de referencia para Jest en JavaScript: comandos CLI, matchers comunes, funciones mock y spies, snapshot testing, pruebas asincronas y hooks de setup/teardown.

· Publicado

Jest es un framework de pruebas de JavaScript enfocado en la simplicidad, configuracion cero (zero-config) y pruebas de instantaneas (snapshots) ultra rapidas.

Ejecucion de pruebas y opciones de CLI (CLI Flags)

jest                           # Ejecutar todas las pruebas
jest --watch                   # Ejecutar en modo observador interactivo
jest --coverage                # Generar informe de cobertura de codigo
jest path/to/test.js           # Ejecutar un archivo de prueba especifico
jest -t "test name pattern"    # Filtrar pruebas por nombre o patron de descripcion
jest --runInBand               # Ejecutar pruebas de forma secuencial en un solo proceso

Comparadores comunes (Common Matchers)

// Veracidad e igualdad
expect(val).toBe(42);                  // Igualdad estricta (Object.is)
expect(val).toEqual({ a: 1 });         // Igualdad estructural profunda
expect(val).toStrictEqual({ a: 1 });   // Verifica ademas los prototipos de tipos
expect(val).toBeNull();
expect(val).toBeDefined();
expect(val).toBeTruthy();
expect(val).toBeFalsy();

// Numeros y comparaciones
expect(val).toBeGreaterThan(3);
expect(val).toBeGreaterThanOrEqual(3.5);
expect(val).toBeCloseTo(0.3, 5);       // Comparacion aritmetica de punto flotante

// Cadenas y arreglos
expect(str).toMatch(/regex/);
expect(arr).toContain('item');
expect(arr).toHaveLength(3);

// Excepciones y errores
expect(() => compileCode()).toThrow();
expect(() => compileCode()).toThrow(ConfigError);

Codigo asincrono (Asynchronous Code)

test('resolves with data', async () => {
  const data = await fetchData();
  expect(data).toHaveProperty('status', 200);
});

test('handles promise rejection', async () => {
  await expect(fetchData('invalid')).rejects.toThrow('Not Found');
});

Funciones Mock y Spies (jest.fn() y Spies)

const mockFn = jest.fn().mockReturnValue('mocked result');
mockFn('arg1');

expect(mockFn).toHaveBeenCalledTimes(1);
expect(mockFn).toHaveBeenCalledWith('arg1');

// Mocking module methods
const spy = jest.spyOn(api, 'getUser').mockResolvedValue({ id: 1, name: 'Alice' });
const user = await api.getUser(1);
expect(spy).toHaveBeenCalled();
spy.mockRestore(); // Restaurar implementacion original

Pruebas de instantaneas (Snapshot Testing)

test('renders correctly', () => {
  const tree = renderer.create(<Button label="Submit" />).toJSON();
  expect(tree).toMatchSnapshot();
});

Configuracion y limpieza (Setup and Teardown)

beforeAll(() => database.connect());
afterAll(() => database.disconnect());
beforeEach(() => database.clear());
afterEach(() => jest.clearAllMocks());

Referencias relacionadas

Temas relacionados