Mikä on Arrange-Act-Assert-kuvio?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** on kuvio testien jäsentämiseksi selkeästi kolmeen vaiheeseen: **Arrange** (valmistelu), **Act** (toiminnon suorittaminen), **Assert** (tuloksen tarkistaminen). Se tekee testeistä luettavia, järjestäytyneitä ja helposti ymmärrettäviä.

## Kolme vaihetta

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

## Esimerkki

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

Kolme vaihetta ovat visuaalisesti selkeät (usein erotettuja tyhjillä riveillä tai kommenteilla), joten testin tarkoitus on ilmeinen: mitä valmistellaan, mitä tehdään, mitä tarkistetaan.

## Miksi AAA auttaa

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

## Miksi se on tärkeää

Arrange-Act-Assert-kuvion ymmärtäminen on arvokasta, koska se tarjoaa **yksinkertaisen ja tehokkaan rakenteen selkeiden, ylläpidettävien testien kirjoittamiseen**, joten se on hyödyllistä käytännön tietoa.

Kuvio — jokaisen testin jäsentäminen **Arrange**-vaiheeseen (testikontekstin, syötteiden ja tilan valmistelu), **Act**-vaiheeseen (testatun yksittäisen toiminnon suorittaminen) ja **Assert**-vaiheeseen (tulosten tarkistaminen odotusten mukaan) — tekee testeistä luettavia ja hyvin järjestäytyneitä, ja tarkoitus on heti selvä (mitä valmistellaan, mitä tehdään, mitä tarkistetaan).

Ymmärtäminen **miksi AAA auttaa** on avain arvoon: se parantaa **luettavuutta** (selkeä kolmiosainen rakenne tekee testeistä helposti seurattavia), edistää **keskittymistä** (yksi toiminto per testi, koska on yksi selkeä Act-vaihe — edistää keskittyviä testejä, jotka tarkistavat yhden käyttäytymisen), parantaa **ylläpidettävyyttä** (johdonmukainen rakenne koko testisarjassa) ja auttaa **ongelmien havaitsemisessa** (liiallinen valmistelu Arrange-vaiheessa viestii monimutkaisista riippuvuuksista, useat Act-vaiheet osoittavat testia, joka tekee liian paljon).

AAA:n noudattaminen tuottaa testejä, joita on helppo kirjoittaa, ymmärtää ja ylläpitää — arvokasta, koska testejä luetaan ja muutetaan ajan myötä, ja selkoutumattomat testit ovat todellinen ylläpitorasitus.

Tiedon, että **Given-When-Then** (BDD-ilmaisu: Given valmistelu, When toiminto, Then tulos) on sama idea, yhdistää AAA:n käyttäytymislähtöisiin lähestymistapoihin.

Koska selkeiden, hyvin jäsenneltyjen, ylläpidettävien testien kirjoittaminen on tärkeää (testit ovat koodia, joka on ymmärrettävä ja ylläpidettävä) ja AAA tarjoaa yksinkertaisen, tehokkaan rakenteen tähän, ja koska kuvion ja sen hyötyjen ymmärtäminen auttaa parempia testejä kirjoittaa, Arrange-Act-Assert-kuvion ymmärtäminen on arvokasta, käytännöllisesti relevanttia tietoa — yksinkertainen mutta tehokas käytäntö selkeiden, keskittyvien, ylläpidettävien testien kirjoittamiseen, laajalti käytetty ja arvoinen soveltaa paremman testikoon saavuttamiseksi, hyödyllinen tapa kaikille, jotka kirjoittavat testejä.