X'inhu l-pattern Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** huwa pattern għal strutturazzjoni ċara ta' testijiet f'tliet fażi: **Arrange** (ipprepara), **Act** (iwettaq l-azzjoni), **Assert** (ivverifika r-riżultat). Jagħmel it-testijiet li jkunu leġibbli, organizzati, u faċli biex tinfhimu.

## It-tliet fażi

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

## Eżempju

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

It-tliet fażi huma ċarament viżibbli (ħafna drabi separati b'linji vojta jew commenti), u jagħmlu l-intent tat-test ovvju: x'inhu ppreparat, x'inhu magħmul, x'inhu verifikat.

## Għaliex AAA tgħin

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

## Għaliex huwa importanti

L-għarif tal-pattern Arrange-Act-Assert huwa validu għaliex jipprovdi **struttura sempliċi u effettiva għal kitba ta' testijiet ċari u mantenutabbli**, għalhekk hija għarif prattiku utli.

Il-pattern — strutturazzjoni ta' kull test f'**Arrange** (ipprepara l-kuntest tat-test, inputs, u stat), **Act** (iwettaq l-azzjoni waħda jitħassab), u **Assert** (ivverifika li r-riżultat jaqbel mal-expectazzjonijiet) — jagħmel it-testijiet leġibbli u morganizzati sew, u l-intent huwa immedjat ċar (x'inhu ppreparat, x'inhu magħmul, x'inhu verifikat).
" L-għarif ta' **għaliex AAA tgħin** huwa l-valur ewlieni: itejjeb **il-leggibilità** (it-3-partiti struttura ċara tagħmel it-testijiet faċli li tkunu segwiti), trawwem **il-fokus** (azzjoni waħda per test, peress li hemm fażi Act waħda ċara — promozzjoni ta' testijiet mifruxa li jivverifikaw biħavja waħda), itejjeb **il-mantenibilità** (struttura konsistenti fl-intero suite ta' testijiet), u tgħin **biex tidentifika problemi** (setup eċċessiv f'Arrange jixxeraq dipendenzi kumplessi, multipli Acts jixxeraqu test li tagħmel wisq).

L-immudu AAA jipproduċi testijiet li huma faċli biex jinkitbu, jinftimu, u jintmenutnu — validu għaliex it-testijiet jinqraw u jinbidlu fuq il-ħin, u testijiet unkleari huma burdjen reali ta' manteniment.

Il-għarif li **Given-When-Then** (il-frażeolohġija BDD: Given setup, When azzjoni, Then riżultat) hija l-istess idea jeqred AAA ma' approċċi driven-behaviour.

Għaliex il-kitba ta' testijiet ċari, morganizzati sew, u mantenutabbli hija importanti (testijiet huma kodiċi li għandu jinfithem u jintmenutnu) u AAA jipprovdi struttura sempliċi u effettiva għal dan, u għaliex il-għarif tal-pattern u l-benefiċċji tiegħu jgħin nikteb testijiet aħjar, l-għarif tal-Arrange-Act-Assert pattern huwa għarif validu u prattikament rilevanti — prattika sempliċi imma effettiva għal kitba ta' testijiet ċari, mifruxa, u mantenutabbli, użata ħafna u tal-ħela biex tiżdied il-kwalità tal-testijiet, ħabit utli għal kull min jikteb testijiet.