Co je vzor Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** je vzor pro strukturování testů do tří jasných fází: **Arrange** (příprava), **Act** (provedení akce), **Assert** (ověření výsledku). Dělá testy čitelnými, organizovanými a snadno pochopitelnými.

## Tři fáze

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

## Příklad

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

Tři fáze jsou vizuálně jasné (často oddělené prázdnými řádky nebo komentáři), což činí záměr testu očividným: co se připravuje, co se děje, co se kontroluje.

## Proč AAA pomáhá

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

## Proč na tom záleží

Rozeznání vzoru Arrange-Act-Assert je cenné, protože poskytuje **jednoduchou, efektivní strukturu pro psaní jasných, udržovatelných testů**, takže jde o užitečné praktické znalosti.

Vzor — strukturování každého testu do **Arrange** (příprava testovacího kontextu, vstupů a stavu), **Act** (provedení jedné testované akce), a **Assert** (ověření, že výsledek odpovídá očekáváním) — činí testy čitelnými a dobře organizovanými, s jasným záměrem (co se připravuje, co se děje, co se kontroluje).

Rozeznání **proč AAA pomáhá** je klíčová hodnota: zlepšuje **čitelnost** (jasná tříčástná struktura činí testy snadnými k sledování), podporuje **soustředěnost** (jedna akce na test, protože je jedna jasná fáze Act — podporuje zaměřené testy, které ověřují jedno chování), zlepšuje **udržovatelnost** (konzistentní struktura v celé testovací sadě), a pomáhá **odhalovat problémy** (nadměrná příprava v Arrange signalizuje složité závislosti, více Acts signalizuje test, který dělá příliš mnoho).

Dodržování AAA vytváří testy, které je snadné psát, pochopit a udržovat — cenné, protože se testy čtou a upravují v průběhu času a nejasné testy jsou skutečným břemenem údržby.

Vědomí, že **Given-When-Then** (BDD formulace: Given příprava, When akce, Then výsledek) je stejná myšlenka, spojuje AAA s přístupy zaměřenými na chování.

Protože psaní jasných, dobře strukturovaných, udržovatelných testů je důležité (testy jsou kód, který musí být pochopen a udržován) a AAA poskytuje jednoduchou, efektivní strukturu pro to, a protože pochopení vzoru a jeho výhod pomáhá psát lepší testy, pochopení vzoru Arrange-Act-Assert je cenné, prakticky relevantní znalosti — jednoduché, ale efektivní postupy pro psaní jasných, zaměřených, udržovatelných testů, hojně používané a hodné aplikace pro lepší kvalitu testů, užitečná návyk pro každého, kdo píše testy.