كتابة كتل test
ضعوا الاختبارات بجوار الشيفرة مباشرةً
كتابة كتل test درس مجاني في Zig Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Zig Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Zig Academy 4 دروس في المجموع.
توجد الاختبارات داخل شيفرتكم
في Zig، لا تحتاجون إلى ملف اختبار منفصل. إذ توجد كتلة test بجوار الشيفرة التي تختبرها، في الملف المصدر نفسه.
الكلمة المفتاحية test
تبدأ الاختبار باستخدام الكلمة المفتاحية test، ثم اسم بين علامتي اقتباس وكتلة. ويجمع المصرّف كل واحد من هذه العناصر نيابةً عنك.
test "adds two numbers" {
// checks go here
}سمِّ اختباراتك بوضوح
السلسلة النصية التي تأتي بعد test هي اسم الاختبار. يظهر اسم واضح مثل "يحلّل الإدخال الفارغ" في التقرير، ويخبرك بما فشل.
test "parses empty input" {}استيراد std لإجراء التأكيدات
تحتاج معظم الاختبارات إلى دوال مساعدة، لذلك تستورد المكتبة القياسية في الأعلى باستخدام استدعاء @import، وتستخدم std.testing في الداخل.
const std = @import("std");اختبار حقيقي أول
تحسب شيئًا داخل الكتلة ثم تتحقق منه. هنا لا ينجح expect إلا عندما يكون الشرط المنطقي صحيحًا.
test "two plus two" {
try std.testing.expect(2 + 2 == 4);
}يمكن أن تفشل الاختبارات
تعيد دوال المساعدة الخاصة بالتأكيد خطأً عندما يكون الفحص خاطئًا. لذلك تكتب try قبلها، مما يجعل الفشل ينهي الاختبار.
try std.testing.expect(1 == 2);اختبر دالة كتبتها بنفسك
يستدعي الاختبار عادةً إحدى دوالك ويتحقق من نتيجتها. ويمكن للدالة واختبار test مشاركة الملف نفسه.
fn add(a: i32, b: i32) i32 {
return a + b;
}التحقق من النتيجة
استدعِ الآن تلك الدالة من اختبار، وتحقق من أن الناتج هو ما تتوقعه باستخدام استدعاء واحد لـ expect.
test "add works" {
try std.testing.expect(add(2, 3) == 5);
}اختبارات متعددة في ملف واحد
يمكنك وضع العدد الذي تريده من كتل test متتابعة. تُشغَّل كل واحدة بمعزل عن الأخرى، لذلك لا يمنع فشل إحداها تشغيل البقية.
الاختبارات شيفرة مُصرَّفة
كتلة test هي Zig عادية، وتخضع لفحص الأنواع بالكامل. وإذا لم تُصرَّف، يتوقف تشغيل الاختبارات قبل تنفيذ أي شيء.
لماذا تفيد الاختبارات المضمّنة
يعني إبقاء الفحوصات بجانب الشيفرة أنها تتطور معها. وعندما تغيّر دالة، تجد اختبار test الخاص بها هناك لتحديثه.
فحص سريع
تريد تعريف اختبار وحدات في ملف مصدر Zig. ما البنية الصحيحة لذلك؟
مراجعة
تعرّفت إلى كتلة test: Zig مسمّاة ومضمّنة ومصرّفة بالكامل، وتُجري التأكيدات فيها باستخدام try. وتوجد الاختبارات بجانب الشيفرة التي تحميها مباشرةً. ✅
تعلم Zig مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «كتابة كتل test» مجاني؟
نعم — نص درس «كتابة كتل test» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Zig Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Zig Academy 4 دروس في المجموع.
ماذا ستتعلم في «كتابة كتل test»؟
ضعوا الاختبارات بجوار الشيفرة مباشرةً تتمرن على Zig Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Zig Academy؟
لا تُشترط خبرة سابقة. Zig Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «كتابة كتل test»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Zig Academy هذا؟
نعم. كل درس في Zig Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.