إنتقل إلى المحتوى الرئيسي

اختبارات السيناريو والتقارير

الطلب المعزول يثبت نداءً فردياً فقط. أما اختبار السيناريو فيثبت تدفّق عمل: سلسلة طلبات تمرّر قيماً من استجابة إلى الطلب التالي وتفحص التأكيدات في كل خطوة. يلتقط السيناريو تدفّقات الطرف إلى الطرف التي كانت تعيش في أذهان المطوّرين.

بناء سيناريو​

  • خطوات مرتّبة، تشير كل واحدة إلى عملية في المواصفة.
  • تمرير بيانات بين الخطوات — مثل id مورد مُنشأ للطلب التالي.
  • تأكيدات على رموز الحالة ورؤوس الاستجابة وحقولها.
  • قيم يجب أن يزوّدها القارئ قبل التشغيل.

الترتيب والتأكيدات من الدرجة الأولى ولا يُتخلّى عنها صامتاً عند التشغيل.

تشغيل سيناريو​

يعمل السيناريو في العملية الرئيسية عبر محرك runScenario في @powerduck/openapi-cli.

  • scenario:run يبدأ التشغيل بالسيناريو والمواصفة وإعدادات الطلب.
  • يُبَث التقدّم عبر scenario:event مع تقدّم الخطوات.
  • scenario:cancel يُجهض تشغيلاً جارياً.

تراقب كل خطوة، وترى أين يفشل التدفّق، ويمكنك إلغاء التشغيلات الطويلة.

كيف يبني المساعد السيناريوهات​

لا يخترع المساعد تعريفات اختبار داخل المواصفة. السيناريوهات تدفّقات مضيف مستقلة ولا تُحفَظ في مستند OpenAPI — بلا مفتاح x-scenarios وبلا خطوات مدمجة.

عند طلب تصميم العمليات والاختبارات معاً، يُرتَّب العمل.

  1. يقترح المساعد أولاً تصحيح العمليات فقط.
  2. بعد التطبيق، يُرجع بطاقة إجراء تنفّذ التدفّق:
    • test.single لعملية معزولة.
    • scenario.plan كي يكتشف المضيف تدفّق طرف إلى طرف.
    • scenario.run لتجهيز وتشغيل التدفّق المرتّب.

تسرد بطاقة scenario.run العمليات بترتيب التشغيل (2 إلى 8)، مع حقول الاستجابة والرؤوس والحالات الممرّرة لكل طلب تالٍ، وتصف الهدف. كل مرجع منسوخ من المواصفة الحالية.

التقارير​

بعد التشغيل، يمكنك تصدير تقرير HTML مستقل. ليس مخرجات CLI الخام، بل مستند ملخّص يعرض التدفّق ونتيجة كل خطوة والتأكيدات والنتيجة النهائية بتخطيط مقروء.

عند التصدير، اختر اللغة؛ عشر لغات مدمجة.

  1. English
  2. 简体中文 (الصينية المبسطة)
  3. 繁體中文 (الصينية التقليدية)
  4. 日本語 (اليابانية)
  5. 한국어 (الكورية)
  6. Français (الفرنسية)
  7. Deutsch (الألمانية)
  8. Español (الإسبانية)
  9. Português — Brasil (البرتغالية — البرازيل)
  10. العربية (العربية)

خيار آخر/مخصص يتيح كتابة اللغة مباشرة.

التقرير آمن للمشاركة.

  • تُقنَع بيانات الاعتماد تلقائياً، لذا لا تظهر الرموز والمفاتيح.
  • تُطوى الحمولات الكبيرة، لإبقاء التقرير مقروءاً بدل إدراج كل شيء.

HTML مستقل: يُرفَق بالتذاكر أو يُؤرشَف لكل إصدار.

متى تُستخدم السيناريوهات​

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

انظر أيضاً: مساحة الطلب、التصميم مع المساعد、خادم المحاكاة.