ما هو اختبار التكامل (Integration Testing)؟

Question

Accepted Answer

**اختبار التكامل** يتحقق من أن **عدة مكونات أو وحدات تعمل بشكل صحيح معاً** — اختبار التفاعلات ونقاط التكامل (مثل الكود مع قاعدة البيانات، أو الخدمات التي تستدعي بعضها، أو الوحدات المدمجة). يكتشف المشاكل التي تفتقدها اختبارات الوحدات (التي تعزل الوحدات).

## ما يتحقق منه اختبار التكامل

```text
Integration tests verify COMPONENTS WORKING TOGETHER (not in isolation):
  → code + DATABASE (does the data layer actually work with a real DB?)
  → service A calling service B / an external API
  → multiple modules/units combined; the integration POINTS between them
→ catches issues in how parts INTERACT — which unit tests (isolated) can't catch.
```

## لماذا اختبارات التكامل مهمة (مقابل اختبارات الوحدات)

```text
UNIT tests isolate units (mocking dependencies) → fast, but DON'T verify real integration:
  → a unit can pass its tests but FAIL when combined (wrong assumptions about a dependency,
    a real DB query that's wrong, an API contract mismatch, config issues)
INTEGRATION tests use REAL (or realistic) dependencies → catch these interaction bugs:
  → wiring/configuration errors, data layer issues, contract mismatches between components
→ Integration tests verify the parts actually work TOGETHER.
```

## مثال واعتبارات

```js
// integration test: the repository actually works with a (test) database
test('UserRepository saves and retrieves a user', async () => {
  const repo = new UserRepository(testDb);     // REAL test database
  await repo.save({ name: 'Ann' });
  const user = await repo.findByName('Ann');    // real query
  expect(user.name).toBe('Ann');
});
```

```text
→ SLOWER than unit tests (real I/O, setup); use a TEST database/environment
→ Test important integration points (data access, key service interactions, APIs)
→ Fewer than unit tests (the pyramid middle); manage test data/state carefully
```

## لماذا هو مهم

فهم اختبار التكامل مهم لأنه **يكتشف فئة من الأخطاء التي لا تستطيع اختبارات الوحدات اكتشافها** — مشاكل في كيفية عمل المكونات معاً — لذلك فهو معرفة قيمة للاختبار الشامل.

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

فهم هذه العلاقة التكميلية (اختبارات الوحدات للمنطق المعزول، اختبارات التكامل للتفاعلات الحقيقية) هو مفتاح الاختبار الشامل، لأن أياً منهما وحده غير كافٍ.

فهم **الاعتبارات** — أن اختبارات التكامل أبطأ (عمليات إدخال/إخراج حقيقية وإعداد، لذا فهي تقع في منتصف الهرم مع عدد أقل من اختبارات الوحدات)، تستخدم قواعد بيانات/بيئات اختبار، تركز على نقاط التكامل المهمة (الوصول إلى البيانات، التفاعلات الرئيسية بين الخدمات، واجهات برمجية)، وتتطلب إدارة حذرة للبيانات الاختبارية/حالة النظام — يعكس الممارسة العملية لاختبار التكامل.

توفر اختبارات التكامل ثقة بأن الأجزاء المجمعة تعمل، وهو ما لا تستطيع اختبارات الوحدات وحدها تقديمه.

نظراً لأن التطبيقات الحقيقية تتكون من مكونات متفاعلة وأخطاء التكامل (مشاكل قاعدة البيانات، عدم توافق العقود، أخطاء الإعدادات) شائعة والتي يتم تفويتها بواسطة اختبارات الوحدات، وبما أن اختبار التكامل يكتشفها بالتحقق من عمل المكونات معاً، فإن فهم اختبار التكامل معرفة قيمة وعملية — ملحق أساسي لاختبار الوحدات يكتشف أخطاء التفاعل، مهم للاختبار الشامل الذي يتحقق ليس فقط من الوحدات المعزولة بل من أن أجزاء النظام تعمل معاً بشكل صحيح فعلاً.