Kas yra Arrange-Act-Assert šablonas?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** yra šablonas, skirtas testams struktūrizuoti aiškiai į tris fazes: **Arrange** (paruošimas), **Act** (veiksmo atlikimas), **Assert** (rezultato patikrinimas). Tai daro testus skaitomais, organizuotais ir lengvai suprantamais.

## Trys fazės

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

## Pavyzdys

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

Trys fazės yra vizualiai aiškios (dažnai atskirtos tuščiomis eilutėmis arba komentarais), todėl testo tikslas yra akivaizdus: kas paruošta, kas atlikta, kas patikrinta.

## Kodėl AAA padeda

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

## Kodėl tai svarbu

Arrange-Act-Assert šablono supratimas yra vertingas, nes jis suteikia **paprastą, efektyvią aiškių, priežiūroje lengvų testų rašymo struktūrą**, todėl tai yra naudinga praktinė žinias.

Šablonas — kiekvieno testo struktūrizavimas į **Arrange** (testo konteksto, įvesties ir būsenos paruošimas), **Act** (tikrinamo vienintelio veiksmo atlikimas) ir **Assert** (išvesties atitikimo lūkesčiams patikrinimas) — daro testus skaitomais ir gerai organizuotais, o tikslas iš karto aiškus (kas paruošta, kas atlikta, kas patikrinta).

Supratimas apie **tai, kodėl AAA padeda**, yra pagrindinė vertė: jis pagerina **skaitomumą** (aiški trijų dalių struktūra daro testus lengvai sekamais), skatina **fokusavimąsi** (vienas veiksmas per testą, nes yra viena aiški Act faza — skatinant sukoncentruotus testus, patvirtinančius vieną elgesį), pagerina **priežiūrimumą** (nuosekli struktūra visoje testo rinkinyje) ir padeda **aptikti problemas** (per daug paruošimo Arrange fazėje signalizuoja sudėtingus priklausomybes, keli Act signalizuoja testą, kuris daro per daug).

Laikymasis AAA gamina testus, kurie yra lengvi rašyti, suprasti ir priežiūrėti — vertinga, kadangi testai yra skaitomi ir modifikuojami laikui bėgant, ir neaiškūs testai yra tikra priežiūros našta.

Žinojimas, kad **Given-When-Then** (BDD formulavimas: Given paruošimas, When veiksmas, Then rezultatas) yra tą pačią idėją, susieja AAA su elgesio valdytomis priemonėmis.

Kadangi aiškių, gerai struktūrizuotų, priežiūroje lengvų testų rašymas yra svarbus (testai yra kodas, kuris turi būti suprastas ir prižiūrėtas) ir AAA suteikia paprastą, efektyvią šios struktūrą, ir kadangi šablono ir jo privalumų supratimas padeda rašyti geresnius testus, Arrange-Act-Assert šablono supratimas yra vertinga, praktiškai reikalinga žinias — paprastas, bet efektyvus aiškių, sukoncentruotų, priežiūroje lengvų testų rašymo atlikimas, plačiai naudojamas ir vertas taikyti geresnei testų kokybei, naudingas įprotis kiekvienam, kuris rašo testus.