Ce este modelul Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** este un model pentru structurarea testelor clar în trei faze: **Arrange** (pregătire), **Act** (executarea acțiunii), **Assert** (verificarea rezultatului). Face testele citibile, organizate și ușor de înțeles.

## Cele trei faze

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

## Exemplu

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

Cele trei faze sunt vizual clare (adesea separate prin linii goale sau comentarii), făcând intenția testului evidentă: ce se pregătește, ce se execută, ce se verifică.

## De ce AAA ajută

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

## De ce conteaza

Înțelegerea modelului Arrange-Act-Assert este valoroasă deoarece oferă o **structură simplă și eficace pentru scrierea testelor clare și ușor de întreținut**, deci este o cunoștință practică utilă.

Modelul — structurarea fiecărui test în **Arrange** (pregătirea contextului testului, intrări și stare), **Act** (executarea acțiunii unice testate), și **Assert** (verificarea că rezultatul corespunde așteptărilor) — face testele citibile și bine organizate, cu intenția imediat clară (ce se pregătește, ce se execută, ce se verifică).

Înțelegerea **de ce AAA ajută** este valoarea-cheie: îmbunătățește **lizibilitatea** (structura clară în trei părți face testele ușor de urmat), încurajează **focalizarea** (o acțiune pe test, deoarece există o fază Act clară — promovând teste focalizate care verifică un singur comportament), îmbunătățește **capacitatea de întreținere** (structură consecventă pe întreaga suită de teste), și ajută la **identificarea problemelor** (pregătirea excesivă în Arrange semnalează dependențe complexe, multiple acte semnalează un test care face prea mult).

Respectarea AAA produce teste care sunt ușor de scris, înțeles și întreținut — valoroase deoarece testele sunt citite și modificate în timp, iar testele nelimpezi sunt o povară reală de întreținere.

Știind că **Given-When-Then** (fraza BDD: Given pregătire, When acțiune, Then rezultat) este aceeași idee conectează AAA la abordări conduse de comportament.

Deoarece scrierea testelor clare, bine structurate și ușor de întreținut este importantă (testele sunt cod care trebuie înțeles și întreținut) și AAA oferă o structură simplă și eficace pentru aceasta, și deoarece înțelegerea modelului și a beneficiilor sale ajută la scrierea unor teste mai bune, înțelegerea modelului Arrange-Act-Assert este o cunoștință valoroasă și practic relevantă — o practică simplă dar eficace pentru scrierea testelor clare, focalizate și ușor de întreținut, folosită pe scară largă și demnă de aplicat pentru o calitate mai bună a testelor, un obicei util pentru oricine scrie teste.