O que é o padrão Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** é um padrão para estruturar testes de forma clara em três fases: **Arrange** (preparar), **Act** (executar a ação), **Assert** (verificar o resultado). Isso torna os testes legíveis, organizados e fáceis de entender.

## As três fases

```text
ARRANGE → set up the test: create objects, prepare inputs, configure mocks, set state
ACT     → perform the ACTION being tested (call the function/method under test)
ASSERT  → verify the OUTCOME: check the result/behavior matches what's expected
→ A clear three-part structure for every test.
```

## Exemplo

```js
test('Cart calculates total with discount', () => {
  // ARRANGE — set up
  const cart = new Cart();
  cart.add({ price: 100 });
  cart.applyDiscount(0.1);          // 10% off

// ACT — perform the action under test
  const total = cart.getTotal();

// ASSERT — verify the result
  expect(total).toBe(90);
});
```

As três fases ficam visualmente claras (geralmente separadas por linhas em branco ou comentários), tornando a intenção do teste óbvia: o que é preparado, o que é feito, o que é verificado.

## Por que AAA ajuda

```text
✓ READABILITY — clear structure; easy to see setup vs action vs verification
✓ FOCUS — encourages testing ONE action per test (one clear Act)
✓ MAINTAINABILITY — consistent structure across tests; easy to understand/modify
✓ Spot problems — too much in Arrange (complex setup) or multiple Acts (testing too much)
→ (Given-When-Then is the same idea, in BDD terms: Given setup, When action, Then outcome.)
```

## Por que isso importa

Entender o padrão Arrange-Act-Assert é valioso porque fornece uma **estrutura simples e eficaz para escrever testes claros e fáceis de manter**, portanto é um conhecimento prático útil.

O padrão — estruturar cada teste em **Arrange** (preparar o contexto do teste, entradas e estado), **Act** (executar a ação única sendo testada) e **Assert** (verificar se o resultado corresponde às expectativas) — torna os testes legíveis e bem-organizados, com a intenção imediatamente clara (o que é preparado, o que é feito, o que é verificado).

Entender **por que AAA ajuda** é o valor-chave: melhora a **legibilidade** (a estrutura clara em três partes torna os testes fáceis de seguir), incentiva o **foco** (uma ação por teste, já que há uma fase Act clara — promovendo testes focados que verificam um comportamento), melhora a **manutenibilidade** (estrutura consistente em toda a suite de testes) e ajuda a **identificar problemas** (preparação excessiva em Arrange sinaliza dependências complexas, múltiplas Acts sinalizam um teste fazendo demais).

Seguir AAA produz testes que são fáceis de escrever, entender e manter — valioso já que testes são lidos e modificados ao longo do tempo, e testes pouco claros são um verdadeiro fardo de manutenção.

Saber que **Given-When-Then** (a formulação BDD: Given preparação, When ação, Then resultado) é a mesma ideia conecta AAA com abordagens orientadas por comportamento.

Como escrever testes claros, bem-estruturados e fáceis de manter é importante (testes são código que deve ser entendido e mantido) e AAA fornece uma estrutura simples e eficaz para isso, e como entender o padrão e seus benefícios ajuda a escrever testes melhores, entender o padrão Arrange-Act-Assert é um conhecimento valioso e praticamente relevante — uma prática simples mas eficaz para escrever testes claros, focados e fáceis de manter, amplamente utilizada e vale a pena aplicar para melhor qualidade de testes, um hábito útil para qualquer pessoa que escreve testes.