Apakah itu corak Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** ialah corak untuk menyusun ujian dengan jelas kepada tiga fasa: **Arrange** (sediakan), **Act** (lakukan tindakan), **Assert** (sahkan hasil). Ia menjadikan ujian mudah dibaca, teratur, dan mudah difahami.

## Tiga fasa

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

## Contoh

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

Tiga fasa ini jelas secara visual (selalunya dipisahkan oleh baris kosong atau komen), menjadikan niat ujian itu nyata: apa yang disediakan, apa yang dilakukan, apa yang disemak.

## Mengapa AAA membantu

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

## Mengapa ia penting

Memahami corak Arrange-Act-Assert adalah bernilai kerana ia menyediakan **struktur yang ringkas dan berkesan untuk menulis ujian yang jelas dan boleh diselenggara**, jadi ia merupakan pengetahuan praktikal yang berguna.

Corak ini — menyusun setiap ujian kepada **Arrange** (sediakan konteks ujian, input, dan keadaan), **Act** (lakukan satu tindakan yang sedang diuji), dan **Assert** (sahkan hasil sepadan dengan jangkaan) — menjadikan ujian mudah dibaca dan tersusun dengan baik, dengan niatnya nyata serta-merta (apa yang disediakan, apa yang dilakukan, apa yang disemak).

Memahami **mengapa AAA membantu** ialah nilai utama: ia meningkatkan **kebolehbacaan** (struktur tiga bahagian yang jelas menjadikan ujian mudah diikuti), menggalakkan **fokus** (satu tindakan setiap ujian, kerana terdapat satu fasa Act yang jelas — menggalakkan ujian fokus yang mengesahkan satu tingkah laku), meningkatkan **kebolehselenggaraan** (struktur konsisten merentas suite ujian), dan membantu **mengesan masalah** (penyediaan yang berlebihan dalam Arrange menandakan dependencies yang kompleks, beberapa Act menandakan ujian yang melakukan terlalu banyak).

Mengikut AAA menghasilkan ujian yang mudah ditulis, difahami, dan diselenggara — bernilai kerana ujian dibaca dan diubah dari semasa ke semasa, dan ujian yang tidak jelas merupakan beban penyelenggaraan yang nyata.

Mengetahui bahawa **Given-When-Then** (frasa BDD: Given setup, When action, Then outcome) ialah idea yang sama menghubungkan AAA dengan pendekatan berasaskan tingkah laku.

Memandangkan menulis ujian yang jelas, tersusun baik, dan boleh diselenggara adalah penting (ujian ialah kod yang mesti difahami dan diselenggara) dan AAA menyediakan struktur yang ringkas dan berkesan untuk ini, dan memandangkan memahami corak ini dan manfaatnya membantu menulis ujian yang lebih baik, memahami corak Arrange-Act-Assert adalah pengetahuan yang bernilai dan relevan secara praktikal — amalan yang ringkas tetapi berkesan untuk menulis ujian yang jelas, fokus, dan boleh diselenggara, digunakan secara meluas dan wajar diaplikasikan untuk kualiti ujian yang lebih baik, satu tabiat berguna bagi sesiapa yang menulis ujian.