ما هي تغطية الاختبارات (Test Coverage)؟

Question

Accepted Answer

**تغطية الاختبارات** تقيس كم جزء من الكود يتم **تنفيذه بواسطة الاختبارات** — عادة كنسبة مئوية (مثال: 80% تغطية). إنها مقياس مفيد للعثور على الكود غير المختبر، لكن من المهم فهم قيودها: التغطية العالية لا تضمن اختبارات جيدة.

## ما الذي تقيسه التغطية

```text
TEST COVERAGE = the % of code exercised by the test suite:
  LINE coverage → % of code lines executed by tests
  BRANCH coverage → % of branches (if/else paths) taken
  FUNCTION coverage → % of functions called
  STATEMENT coverage → % of statements executed
→ Coverage tools instrument the code and report what tests do/don't exercise.
```

## لماذا التغطية مفيدة

```text
✓ FINDS UNTESTED code — low coverage areas reveal what lacks tests (a gap finder)
✓ A measurable quality signal; track it over time; many teams set a target (e.g. ≥80%)
✓ Highlights branches/paths/error cases that tests miss
```

## القيود (مهم جداً!)

```text
⚠️ HIGH COVERAGE ≠ GOOD TESTS:
  → coverage shows code was EXECUTED, NOT that behavior was correctly VERIFIED
  → you can execute code with NO meaningful assertions → 100% coverage, tests verify nothing
  → 100% coverage can still miss bugs (untested input combinations, logic errors)
⚠️ Chasing a coverage NUMBER → writing low-value tests just to hit the target
→ Coverage is a USEFUL guide (find gaps), NOT a guarantee of quality. Use it wisely;
  focus on testing important behavior well, not just hitting a percentage.
```

## أهميتها

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

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

تستخدم العديد من الفرق التغطية كمقياس جودة مع أهداف محددة.

ومع ذلك، فهم **القيود حرج للغاية**: **التغطية العالية لا تساوي اختبارات جيدة** — التغطية تظهر أن الكود تم *تنفيذه*، وليس أن سلوكه تم *التحقق منه* بشكل صحيح، لذا يمكنك أن تحصل على تغطية عالية (حتى 100%) مع اختبارات بلا معنى (تنفيذ الكود دون assertions مناسبة لا يتحقق من شيء)، والتغطية الكاملة قد تفتقد الأخطاء (مجموعات المدخلات غير المختبرة، أخطاء المنطق).

خطر **السعي لرقم تغطية** (كتابة اختبارات منخفضة القيمة فقط للوصول إلى هدف) هو anti-pattern حقيقي.

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

بما أن التغطية مقياس شائع الاستخدام مفيد فعلاً (العثور على الكود غير المختبر) لكن يُساء فهمه واستخدامه بشكل شائع (يُعامل كضمان جودة أو هدف للتلاعب به)، وبما أن فهم قيمتها وقيودها المهمة يمكّن من استخدامه بحكمة، فهم تغطية الاختبارات معرفة قيمة وعملية — مقياس مفيد يجب فهمه بشكل صحيح، حيث أن تقدير قيودها (التغطية ≠ الجودة) مهم مثل المقياس نفسه، يعكس حكماً سليماً في الاختبار.