Cos'è il pattern Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** è un pattern per strutturare i test in modo chiaro in tre fasi: **Arrange** (preparazione), **Act** (esecuzione dell'azione), **Assert** (verifica del risultato). Rende i test leggibili, organizzati e facili da comprendere.

## Le tre fasi

```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.
```

## Esempio

```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);
});
```

Le tre fasi sono visivamente chiare (spesso separate da righe vuote o commenti), rendendo l'intento del test ovvio: cosa viene preparato, cosa viene fatto, cosa viene verificato.

## Perché AAA aiuta

```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.)
```

## Perché è importante

Comprendere il pattern Arrange-Act-Assert è prezioso perché fornisce una **struttura semplice ed efficace per scrivere test chiari e manutenibili**, quindi è una conoscenza pratica utile.

Il pattern — strutturare ogni test in **Arrange** (preparare il contesto del test, gli input e lo stato), **Act** (eseguire l'azione singola sottoposta a test), e **Assert** (verificare che il risultato corrisponda alle aspettative) — rende i test leggibili e ben organizzati, con l'intento immediatamente chiaro (cosa viene preparato, cosa viene fatto, cosa viene verificato).

Comprendere **perché AAA aiuta** è il valore chiave: migliora la **leggibilità** (la struttura chiara in tre parti rende i test facili da seguire), incoraggia la **focalizzazione** (un'azione per test, poiché c'è una sola fase Act chiara — promuovendo test focalizzati che verificano un comportamento), migliora la **manutenibilità** (struttura coerente in tutta la suite di test), e aiuta a **individuare problemi** (una preparazione eccessiva in Arrange segnala dipendenze complesse, più azioni Act segnalano un test che fa troppo).

Seguire AAA produce test che sono facili da scrivere, comprendere e mantenere — prezioso poiché i test vengono letti e modificati nel tempo, e i test poco chiari rappresentano un vero onere di manutenzione.

Sapere che **Given-When-Then** (la formulazione BDD: Given preparazione, When azione, Then esito) è la stessa idea connette AAA agli approcci behavior-driven.

Poiché scrivere test chiari, ben strutturati e manutenibili è importante (i test sono codice che deve essere compreso e mantenuto) e AAA fornisce una struttura semplice ed efficace per questo, e poiché comprendere il pattern e i suoi vantaggi aiuta a scrivere test migliori, comprendere il pattern Arrange-Act-Assert è una conoscenza preziosa e praticamente rilevante — una pratica semplice ma efficace per scrivere test chiari, focalizzati e manutenibili, ampiamente utilizzata e che vale la pena di applicare per una migliore qualità dei test, un'abitudine utile per chiunque scriva test.