قسم الاختبارات في مساحة العمل — فحوص HTTP لموقعك المنشور | مُبَرمِج

ما الذي يعمل فعلًا

عند الضغط على «شغّل» يطلب خادم مُبَرمِج الصفحة من عنوان موقعك المنشور (/اسم-موقعك على نطاق المنصة) بترويسة Mubarmij-TestAgent/1.0، ويقرأ HTML كما وصل، ثم يحكم على خطواتك ومعاييرك. لا يُفتح متصفح ولا يُنفَّذ أي جافاسكربت، فالمحتوى الذي يُرسم بعد التحميل لا يراه الاختبار. وتكتب الشاشة ذلك نصًّا في صندوق «فحوص تسليم على مستوى HTTP» وتحت كل نتيجة.

غير متاح بعد: ثلاثة خيارات تظهر في نموذج الإنشاء وتُحفظ لكنها لا تغيّر التشغيل: «بهوية مستخدم آلي» (يُطلب البريد لكن الطلب يخرج بلا تسجيل دخول)، و«العمل الحالي» (يُختبر الموقع المنشور دائمًا)، ومقاس الشاشة «سطح المكتب» و«لوحي» و«جوال» (لا متصفح يُضبط مقاسه). ومفتاح «مفعّل» لا يمنع التشغيل اليدوي، لكنه يوقف التشغيل المجدول والتشغيل بعد النشر.

إنشاء اختبار

1. افتح مشروعك، ثم اختر «الاختبارات» من القائمة الجانبية.
2. اضغط «اختبار جديد» أعلى الصفحة، أو «أنشئ اختبارًا» إن كانت القائمة فارغة («لا توجد اختبارات»).
3. اكتب اسمًا في الحقل «اسم الاختبار — مثال: نموذج التواصل يعمل».
4. اكتب مسار البداية في الحقل الذي يحمل «/» (الصفحة الرئيسية افتراضيًا).
5. في «تعليمات الاختبار *» اكتب خطوة واحدة في كل سطر بالصيغ الموضحة أدناه.
6. في «معايير النجاح *» اكتب شرطًا واحدًا على الأقل، واضغط «أضف معيارًا» لكل شرط إضافي.
7. اكتب «خطوات التنظيف (اختياري)» إن احتجت إليها.
8. اختر من قائمة «الجدول»: «عند الطلب فقط» أو «كل ساعة» أو «يوميًا» أو «أسبوعيًا»، وفعّل «شغّله عند كل نشر» إن أردت.
9. اضغط «إنشاء». تظهر رسالة «أُنشئ الاختبار» ويُضاف الاختبار إلى القائمة، أو اضغط «إلغاء» للتراجع.

التشغيل التلقائي: الجدول وبعد النشر

• الجدول: تشغّله مهمة المنصة الدورية (/api/cron/frequent) حين يمضي على آخر تشغيل ساعة أو يوم أو أسبوع بحسب اختيارك. لا تُشغَّل إلا الاختبارات المفعّلة في مشاريع منشورة، والأقدم تشغيلًا أولًا، بسقوف: 3 تشغيلات لكل مشروع في الدورة الواحدة، و48 لكل مشروع في 24 ساعة، و20 للدورة كلها. تغيّر الجدول لاحقًا من القائمة في صف الاختبار.
• بعد النشر: كل نشر (من المتصفح أو من الواجهة البرمجية) يصفّ تشغيلًا لكل اختبار مفعّل اختير له «شغّله عند كل نشر»، حتى 10 اختبارات، ويبدأ تنفيذها دون أن يؤخّر النشر. اختبار له تشغيل مصفوف لم يبدأ لا يُصفّ مرّة ثانية، وإن لم يكن المشروع منشورًا لحظة التنفيذ يفشل التشغيل بـ«المشروع غير منشور — لم يُشغَّل الاختبار».
• التشغيل المجدول وتشغيل النشر يُحفظان كالتشغيل اليدوي، فتقرأ نتيجتهما بالطريقة نفسها.

صيغ الخطوات والمعايير

• «افتح /المسار» (أو «زر» أو «انتقل إلى»): يطلب الصفحة. إن لم تكتب سطر فتح يبدأ الاختبار بمسار البداية.
• «يوجد نص …» (أو «يظهر»): يبحث عن النص في النص الظاهر بعد نزع الوسوم، فمطابقة داخل اسم صنف أو رابط لا تُحتسب.
• «يوجد رابط …» (أو «رابط»): يبحث بين وسوم الروابط عن عنوان أو نص رابط يطابق.
• «الحالة 200»: يقارن رمز الحالة لآخر صفحة طُلبت.
• «بلا أخطاء»: يفشل إن احتوت الصفحة عبارات مثل Application error أو 500 Internal Server Error أو Unexpected token.
• أي سطر آخر يُعامل كنص يجب أن يظهر.

معايير النجاح تُقيَّم على آخر صفحة وصلها التدفق، كلٌّ على حدة. ابدأ المعيار بـ«لا يوجد» أو «بدون» أو «يجب ألا» لتنفيه. خطوات التنظيف تنفّذ أسطر الفتح فقط، وفشلها يظهر خطوةً مستقلة ولا يُسقط الاختبار.

التشغيل وقراءة النتيجة

1. في صف الاختبار اضغط «شغّل»، وانتظر حتى ينتهي الطلب.
2. تتحول النقطة الملونة إلى ناجح أو فاشل، ويظهر في السطر الجدول («عند الطلب فقط» أو «كل ساعة» أو «يوميًا» أو «أسبوعيًا»)، و«بعد كل نشر» إن اخترته، ثم «آخر تشغيل» بتاريخه، أو «لم يُشغَّل بعد» قبل أول تشغيل.
3. اضغط السهم «عرض النتيجة» لترى لوحة «معايير النجاح» بحكم كل معيار، ثم كل خطوة بتفصيلها وزمنها بالمللي ثانية («م.ث»).

أيقونة سلة المهملات في الصف تحذف الاختبار مباشرة بلا سؤال تأكيد.

أسباب الرفض والفشل

• «اسم الاختبار مطلوب» و«تعليمات الاختبار مطلوبة» عند ترك الحقلين فارغين.
• «أضف معيار نجاح واحدًا على الأقل — اختبار بلا معيار ينجح دائمًا ولا يثبت شيئًا».
• «اختر مستخدمًا آليًا صالحًا للتشغيل بهويته» عند اختيار الهوية الآلية دون بريد صالح.
• «جدول غير معروف — المتاح: كل ساعة، يوميًا، أسبوعيًا» لقيمة جدول لا يعرفها المجدول.
• خطوة فتح تعيد حالة خطأ أو يتعذر الوصول إليها تفشل. وإن لم تُحمَّل أي صفحة تُسجَّل الخطوات التالية «تخطّي» لا نجاحًا.
• الاختبار يطلب الموقع المنشور، فمشروع لم يُنشر بعد تفشل خطوة فتحه. راجع النشر.
• نص يُرسم بجافاسكربت فقط يفشل في «يوجد نص» وإن ظهر لك في المتصفح.

الباقات

قسم «الاختبارات» لا يشترط قدرة من عقد الباقات، فهو غير مقفل في أي باقة، من «المجانية» إلى «الاحترافية». لفحوص الأمان والسرعة انظر التدقيق والأداء.

أسئلة شائعة

هل يفتح الاختبار متصفحًا حقيقيًا وينقر الأزرار؟

لا. يطلب الصفحات عبر HTTP ويقرأ HTML فقط؛ لا نقر ولا تعبئة نماذج ولا جافاسكربت.

هل يعمل الاختبار تلقائيًا بجدول أو بعد كل نشر؟

نعم إن اخترت ذلك: جدول «كل ساعة» أو «يوميًا» أو «أسبوعيًا»، أو «شغّله عند كل نشر»، بشرط أن يكون الاختبار مفعّلًا والمشروع منشورًا. السقوف في قسم «التشغيل التلقائي» أعلاه.