Czym jest wzorzec Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** to wzorzec do strukturyzowania testów na trzy jasne fazy: **Arrange** (przygotowanie), **Act** (wykonanie akcji), **Assert** (weryfikacja wyniku). Czyni testy czytelnym, zorganizowanymi i łatwymi do zrozumienia.

## Trzy fazy

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

## Przykład

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

Trzy fazy są wizualnie wyraźne (często oddzielone pustymi liniami lub komentarzami), przez co intencja testu jest oczywista: co się przygotowuje, co się wykonuje, co się sprawdza.

## Dlaczego AAA pomaga

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

## Dlaczego to ważne

Zrozumienie wzorca Arrange-Act-Assert jest wartościowe, ponieważ zapewnia **prostą, skuteczną strukturę do pisania jasnych, łatwych w utrzymaniu testów**, dlatego jest to przydatna praktyczna wiedza.

Wzorzec — strukturyzowanie każdego testu na **Arrange** (przygotowanie kontekstu testu, wejść i stanu), **Act** (wykonanie pojedynczej testowanej akcji) i **Assert** (weryfikacja, czy wynik odpowiada oczekiwaniom) — czyni testy czytelnymi i dobrze zorganizowanymi, z jasną intencją (co się przygotowuje, co się wykonuje, co się sprawdza).

Zrozumienie **dlaczego AAA pomaga** jest kluczową wartością: poprawia **czytelność** (jasna trójczęściowa struktura czyni testy łatwymi do śledzenia), zachęca do **skupienia** (jedna akcja na test, ponieważ jest jedna jasna faza Act — promując skoncentrowane testy weryfikujące jedno zachowanie), poprawia **łatwość utrzymania** (spójna struktura w całej baterii testów) i pomaga **dostrzec problemy** (nadmierne przygotowanie w Arrange sygnalizuje złożone zależności, wiele akcji w Act sygnalizuje test, który robi zbyt wiele).

Zastosowanie AAA prowadzi do testów, które są łatwe do napisania, zrozumienia i utrzymania — wartościowe, ponieważ testy są czytane i modyfikowane w czasie, a niejasne testy stanowią rzeczywisty problem utrzymaniowy.

Wiedza, że **Given-When-Then** (wyrażanie w BDD: Given przygotowanie, When akcja, Then wynik) to ten sam pomysł, łączy AAA z podejściami opartymi na zachowaniu.

Ponieważ pisanie jasnych, dobrze ustrukturyzowanych, łatwych w utrzymaniu testów jest ważne (testy to kod, który musi być zrozumiany i utrzymywany) i AAA zapewnia prostą, skuteczną strukturę do tego, oraz ponieważ zrozumienie wzorca i jego korzyści pomaga pisać lepsze testy, zrozumienie wzorca Arrange-Act-Assert jest wartościową, praktycznie istotną wiedzą — prostą ale skuteczną praktyką pisania jasnych, skoncentrowanych, łatwych w utrzymaniu testów, powszechnie stosowaną i wart stosowania dla lepszej jakości testów, przydatnym nawykiem dla każdego, kto pisze testy.