أول اختبار لكم مع test وexpect

يُعد test كودًا يتحقق من استمرار عمل كودكم. اكتبوه مرة واحدة، وسيحافظ على ذلك السلوك إلى الأبد. 🛡️

توفّر حزمة test الرسمية إمكانات الاختبار في Dart. أضيفوها ضمن dev_dependencies حتى تُضمّن مع أدوات التطوير فقط.

وفقًا للعرف، توضع الاختبارات في مجلد test/ على المستوى الأعلى، وينتهي اسم كل ملف بـ _test.dart حتى يتمكن المشغّل من العثور عليها.

يبدأ كل ملف اختبار باستيراد مكتبة test، التي توفّر لكم الدالتين المساعدتين test و expect.

تضعون كل تحقق داخل استدعاء test: وصفًا قصيرًا، بالإضافة إلى جسم يُشغّل تأكيداتكم.

تُقرأ أوصاف الاختبارات الجيدة كأنها جمل. اذكروا ما ينبغي أن يحدث، مثل يعيد صفرًا للقائمة الفارغة، بدلًا من ذكر السطر الذي تستدعونه.

تقارن الدالة expect بين قيمة فعلية وقيمة تتوقعونها. وإذا اختلفتا، يفشل الاختبار مع عرض رسالة واضحة.

يمكن أن تكون الوسيطة الثانية قيمة عادية أو matcher مثل equals أو isTrue أو isNull لإجراء عمليات تحقق أوضح وأكثر تعبيرًا.

شغّلوا dart test من جذر المشروع. سيعثر على كل ملف _test.dart ويعرض حالات النجاح والفشل.

تعني النقطة الخضراء أو ‎+1‎ نجاحًا؛ أما الفشل الأحمر فيعرض القيمتين المتوقعة والفعلية حتى تتمكنوا من إصلاح الفجوة بسرعة.

حافظوا على تركيز الاختبارات الأولية: وجود expect واحد واضح لكل سلوك يجعل حالات الفشل جلية والاختبارات سهلة القراءة.

ما الاستدعاء الذي يؤكد أن قيمة ما تساوي 4؟

أضفتم حزمة test، وكتبتم اختبارًا باسم واضح، وأكدتم النتيجة باستخدام expect، ثم شغّلتم dart test. هذه هي الحلقة الأساسية كاملة. ✅