Cad is ea patrún an Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** is a pattern for structuring tests clearly into three phases: **Arrange** (set up), **Act** (perform the action), **Assert** (verify the result). It makes tests readable, organized, and easy to understand.

## An trí chéim

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

## Example

```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á an trí chéim le feiceáil go soiléir (go minic scartha ag línte folamha nó tráchtanna), rud a bhíonn d'intinn an tréimhse soiléir: cad atá socraithe, cad atá déanta, cad atá seicheadh.

## Conas a chabhraíonn AAA

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

## Cén fáth a bhíonn tábhacht air

Tá an patrún Arrange-Act-Assert luachmhar toisc go soláthraíonn sé **struchtúr simplí, éifeachtach chun tréimhsí soiléir, in-choimeádta a scríobh**, agus dá bhrí sin is eolas praiticiúil úsáideach a bhíonn ann.

An patrún — gach tréimhse a struchtúrú ina **Arrange** (an comhthéacs tréimhse, ionchuir, agus staid a shocrú), **Act** (an gníomh singil atá á thástáil a dhéanamh), agus **Assert** (a fhíorú go bhfreagraíonn an toradh do na dúshlán) — déanann sé tréimhsí ináite agus eagraithe go maith, agus bíonn an bhríathar soiléir ar an bpointe (cad atá socraithe, cad atá déanta, cad atá seicheadh).

Is é an eochair-luach a thuiscint **cén fáth a chabhraíonn AAA**: feabhsaíonn sé **inléiteacht** (déanann an struchtúr soiléir trí-chuid tréimhsí éasca a leanuint), spreagann sé **díriú** (gníomh amháin in aghaidh an tréimhse, ós rud é go bhfuil gníomh soiléir amháin ann — ag spreagadh tréimhsí dírithe a fhíorú iompar amháin), feabhsaíonn sé **in-choimeádtacht** (struchtúr comhsheasmhach ar fud an tsraith tréimhsí), agus cabhraíonn sé **fadhbanna a aimsiú** (socrú iomarcach in Arrange a léiríonn spleáchais chasta, gníomh iolrach a léiríonn tréimhse ag déanamh an iomarca).

Réamhdhílse AAA a tháirgeann tréimhsí atá éasca a scríobh, a thuiscint, agus a choimeád — luachmhar ós rud é gur cód iad tréimhsí atá a bheith a léamh agus a athrú thar an am, agus is fíor-ualach coimeádta iad tréimhsí geal.

Tá fhios agat go bhfuil **Given-When-Then** (an phrásáil BDD: Given setup, When action, Then outcome) an smaoineamh céanna agus ceanglaíonn sé AAA le cur chuige-bhiodháideach.

Toisc go bhfuil tábhacht ar scríobh tréimhsí soiléir, struchtúr-bhreá, in-choimeádta (cód atá tréimhsí, cé go gcaithfear a thuiscint agus a choimeád) agus soláthraíonn AAA struchtúr simplí, éifeachtach don scéal seo, agus ó thuiscint na patrúin agus a bhuntáistí cabhraíonn sé scríobh tréimhsí níos fearr, thuiscint ar an Arrange-Act-Assert patrún is eolas praiticiúil, ábhartha — gníomhaíonn simplí ach éifeachtach chun tréimhsí soiléir, dírithe, in-choimeádta a scríobh, a úsáidtear go leor agus ba bhreá a chur i bhfeidhm chun tréimhse-caighdeán níos fearr, cleachtas úsáideach do dhuine ar bith a scríobh tréimhsí.