Pular para o conteúdo
Test Automation Lab
  • Aprender
  • Praticar
  • Referência
  • Qualidade
Menu
  • Aprender
  • Praticar
  • Referência
  • Qualidade
PT
  • Português
  • English
Tema

Test Automation Lab

GitHub© 2026 LCDS IT
← Todas as receitas

🏗️ Builders de dados de teste

Monte objetos de teste válidos com padrões sensatos e só os campos que importam.

Praticante
  • unit
  • fixtures
  • readability

Problema

Os testes montam objetos inline com todos os campos escritos. O único campo que importa para o teste se perde no ruído, e acrescentar um campo obrigatório quebra dezenas de testes de uma vez.

Solução

Use um builder (ou factory) que devolve um objeto válido a partir de padrões sensatos e deixa cada teste sobrescrever só os campos que lhe interessam. A intenção salta aos olhos, e um novo campo obrigatório pede uma mudança só, no builder.

Mantenha os builders puros e determinísticos; se precisar de unicidade, injete uma semente em vez de apelar para valores aleatórios.

Trecho de código

Um builder pequeno com padrões sobrescrevíveis
function aUser(overrides: Partial<User> = {}): User {
  return {
    id: 'u-1',
    name: 'Test User',
    email: 'user@example.com',
    role: 'member',
    ...overrides,
  };
}

// O teste declara só o que importa.
it('blocks members from the admin panel', () => {
  expect(canAccessAdmin(aUser({ role: 'member' }))).toBe(false);
});

Armadilhas

  • Dados aleatórios por padrão: as falhas deixam de ser reproduzíveis. Prefira padrões fixos e injete uma semente quando precisar.
  • Builders que conseguem produzir objetos inválidos; mantenha os padrões válidos para os testes partirem de um estado conhecido e bom.
  • Exagerar com cadeias fluentes profundas quando uma função com um Partial de sobrescrita basta.

Veja também

Guia: O que testar (e o que não testar) →Ferramenta: Vitest →