Çfarë është modeli Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** është një model për strukturimin e testeve në mënyrë të qartë në tre faza: **Arrange** (përgatitje), **Act** (kryerja e veprimit), **Assert** (verifikimi i rezultatit). Bën testet të lexueshme, të organizuara dhe të lehta për t'u kuptuar.

## Të tre fazat

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

## Shembull

```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ë tre fazat janë vizualisht të qarta (shpesh të ndara me rreshta bosh ose komente), duke bërë qëllimin e testit të qartë: çfarë përgatitet, çfarë bëhet, çfarë kontrollohet.

## Përse AAA ndihmon

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

## Përse është i rëndësishëm

Përtej modelit Arrange-Act-Assert është i vlefshëm sepse ofron **një strukturë të thjeshtë dhe efektive për të shkruar teste të qarta dhe të mirëmbajtshme**, kështu që është njohurinë praktike e dobishme.

Modeli — strukturimi i secilit test në **Arrange** (përgatitja e kontekstit, inputeve dhe gjendjes së testit), **Act** (kryerja i veprimit të vetëm që testohet), dhe **Assert** (verifikimi se rezultati përputhet me pritshmëritë) — bën testet të lexueshme dhe të organizuara mirë, me qëllimin menjëherë të qartë (çfarë përgatitet, çfarë bëhet, çfarë kontrollohet).

Përtej **përse AAA ndihmon** është vlera kyçe: përmirëson **lexueshmërinë** (struktura e qartë tre-pjesëshe bën testet të lehta për t'u ndjekur), nxit **fokus** (një veprim për test, pasi ka një fazë të qartë Act — duke promovuar teste të fokusuar që verifikojnë një sjellje), përmirëson **mirëmbajtjen** (struktura konsistente në të gjithë suitën e testeve), dhe ndihmon **identifikimin e problemeve** (përgatitja e tepërt në Arrange sinjalizon varësi komplekse, multiple Acts sinjalizojnë një test që bën shumë).

Ndiqja e AAA prodhon teste që janë të lehta për të shkruar, kuptuar dhe mirëmbajtur — të vlefshme pasi testet lexohen dhe modifikohen me kalimin e kohës, dhe teste të paqarta janë një barrë e vërtetë mirëmbajtjeje.

Dija që **Given-When-Then** (frazimi BDD: Given përgatitje, When veprim, Then rezultat) është e njëjta ide lidh AAA me qasjet e drejtuar nga sjellja.

Pasi shkruarja e testeve të qarta, të strukturuara mirë dhe të mirëmbajtshme është e rëndësishme (testet janë kod që duhet të kuptohet dhe mirëmbahet) dhe AAA ofron një strukturë të thjeshtë dhe efektive për këtë, dhe pasi kuptimi i modelit dhe i benefiteve të tij ndihmon në shkrimin e testeve më të mirë, kuptimi i modelit Arrange-Act-Assert është njohurinë e vlefshme dhe praktikisht relevante — një praktikë e thjeshtë por efektive për të shkruar teste të qarta, të fokusuar, të mirëmbajtshme, përdoret gjerësisht dhe ia vlen të zbatohet për cilësinë më të mirë të testeve, një zakon i dobishëm për cilindo që shkruan teste.