ما هو نمط Arrange-Act-Assert؟

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** هو نمط لهيكلة الاختبارات بوضوح إلى ثلاث مراحل: **Arrange** (الإعداد)، **Act** (تنفيذ الإجراء)، **Assert** (التحقق من النتيجة). يجعل الاختبارات قابلة للقراءة والتنظيم وسهلة الفهم.

## المراحل الثلاث

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

## مثال

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

المراحل الثلاث واضحة بصريًا (غالبًا ما تكون مفصولة بأسطر فارغة أو تعليقات)، مما يجعل الغرض من الاختبار واضحًا: ما الذي تم إعداده، ما الذي تم إجراؤه، ما الذي تم التحقق منه.

## لماذا يساعد 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.)
```

## لماذا يهم

فهم نمط Arrange-Act-Assert مهم لأنه يوفر **هيكلًا بسيطًا وفعالًا لكتابة اختبارات واضحة وقابلة للصيانة**، لذلك فهو معرفة عملية مفيدة.

النمط — هيكلة كل اختبار إلى **Arrange** (إعداد سياق الاختبار والمدخلات والحالة)، **Act** (تنفيذ الإجراء الوحيد الذي يتم اختباره)، و **Assert** (التحقق من أن النتيجة تطابق التوقعات) — يجعل الاختبارات قابلة للقراءة وذات تنظيم جيد، مع وضوح الغرض على الفور (ما الذي تم إعداده، ما الذي تم تنفيذه، ما الذي تم التحقق منه).

فهم **لماذا يساعد AAA** هو القيمة الأساسية: يحسن **القراءة** (الهيكل الواضح ثلاثي الأجزاء يجعل الاختبارات سهلة المتابعة)، يشجع **التركيز** (إجراء واحد لكل اختبار، حيث يوجد مرحلة Act واحدة واضحة — مما يعزز اختبارات مركزة تتحقق من سلوك واحد)، يحسن **الصيانة** (هيكل متسق عبر مجموعة الاختبارات)، ويساعد **تحديد المشاكل** (الإعداد المفرط في Arrange يشير إلى تبعيات معقدة، عدة Acts يشير إلى اختبار يفعل الكثير).

اتباع AAA ينتج اختبارات سهلة الكتابة والفهم والصيانة — مفيد لأن الاختبارات تُقرأ وتُعدَّل بمرور الوقت، والاختبارات غير الواضحة تشكل عبء صيانة حقيقي.

معرفة أن **Given-When-Then** (صيغة BDD: Given الإعداد، When الإجراء، Then النتيجة) هي نفس الفكرة تربط AAA بأساليب موجهة للسلوك.

حيث أن كتابة اختبارات واضحة وذات هيكل جيد وقابلة للصيانة مهمة (الاختبارات هي كود يجب فهمه والحفاظ عليه) و AAA يوفر هيكلًا بسيطًا وفعالًا لهذا، وحيث أن فهم النمط وفوائده يساعد في كتابة اختبارات أفضل، فإن فهم نمط Arrange-Act-Assert هو معرفة عملية قيمة — ممارسة بسيطة لكن فعالة لكتابة اختبارات واضحة ومركزة وقابلة للصيانة، يتم استخدامها على نطاق واسع وتستحق التطبيق لتحسين جودة الاختبارات، عادة مفيدة لأي شخص يكتب الاختبارات.