Referência rápida

Folha de dicas do Jest Testing Framework

Guia de referencia rapida para Jest: opcoes CLI, matchers comuns, funcoes mock jest.fn e spies, testes de snapshot, codigo assincrono e ganchos de setup/teardown.

· Publicado

Jest e um framework de testes em JavaScript focado em simplicidade, configuracao zero e testes de snapshot instantaneos.

Execucao de testes e opcoes de CLI (CLI Flags)

jest                           # Executar todos os testes
jest --watch                   # Executar testes no modo watch interativo
jest --coverage                # Gerar relatorio de cobertura de codigo
jest path/to/test.js           # Executar arquivo de teste especifico
jest -t "test name pattern"    # Filtrar testes por descricao
jest --runInBand               # Executar testes em serie num unico processo

Comparadores comuns (Common Matchers)

// Veracidade e igualdade
expect(val).toBe(42);                  // Igualdade estrita (Object.is)
expect(val).toEqual({ a: 1 });         // Igualdade estrutural profunda
expect(val).toStrictEqual({ a: 1 });   // Verifica tambem os prototipos dos tipos
expect(val).toBeNull();
expect(val).toBeDefined();
expect(val).toBeTruthy();
expect(val).toBeFalsy();

// Numeros e comparacoes numericas
expect(val).toBeGreaterThan(3);
expect(val).toBeGreaterThanOrEqual(3.5);
expect(val).toBeCloseTo(0.3, 5);       // Comparacao aritmetica de ponto flutuante

// Strings e arrays
expect(str).toMatch(/regex/);
expect(arr).toContain('item');
expect(arr).toHaveLength(3);

// Excecoes e tratamento de erros
expect(() => compileCode()).toThrow();
expect(() => compileCode()).toThrow(ConfigError);

Codigo assincrono (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');
});

Funcoes Mock e Spies (jest.fn() & 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 implementacao original

Testes de instantaneos (Snapshot Testing)

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

Configuracao e limpeza (Setup and Teardown)

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

Referencias relacionadas

Temas relacionados