عن المشروع

Detox هو إطار عمل مفتوح المصدر لاختبارات الطرف إلى الطرف (end-to-end) من نوع gray box للأتمتة والاختبار، مصمم لتطبيقات الهاتف المحمول، ويستهدف بشكل أساسي تطبيقات React Native على منصتي Android و iOS. وعلى عكس أدوات اختبار black box التقليدية، يتزامن Detox مع الحالة الداخلية للتطبيق لتقليل عدم استقرار الاختبارات من خلال مراقبة العمليات غير المتزامنة في الوقت الفعلي. تُكتب الاختبارات بلغة JavaScript باستخدام واجهة برمجة تطبيقات async-await حديثة، مما يجعلها قابلة للتصحيح والقراءة — على سبيل المثال، محاكاة إجراءات المستخدم مثل كتابة النصوص أو النقر على الأزرار، ثم التأكد من تغييرات واجهة المستخدم. تشمل الميزات الرئيسية الدعم متعدد المنصات، والمزامنة التلقائية لمنع حالات السباق (race conditions)، والتوافق مع أدوات تشغيل الاختبارات الشائعة (خاصة Jest)، والتكامل السلس في بيئات CI/CD مثل Travis CI أو CircleCI أو Jenkins. يقوم Detox بتشغيل الاختبارات على أجهزة حقيقية أو محاكيات، مما يعزز الثقة في عملية النشر. وبينما يدعم رسميًا إصدارات React Native من v0.77.x إلى v0.84.x (بما في ذلك New Architecture)، فقد يعمل أيضًا مع إصدارات أحدث أو أقدم، وإن كان ذلك غير مضمون. يشجع المشروع المساهمات المجتمعية عبر GitHub issues و Discord، ويوفر وثائق شاملة تتضمن أدلة البدء، ومبادئ التصميم، وتعليمات المساهمة. تم إصدار Detox بموجب رخصة MIT ويتضمن موارد غير إنجليزية ساهم بها المجتمع، مثل دليل تعليمي باللغة البرتغالية البرازيلية.