كيفية استخدام سكربتات الطلب بعد في Postman؟

ربما تكون على دراية بـ Postman، إذا كنت مطور أو مختبر API، فمن المحتمل أنك بالفعل على دراية بـ Postman. إنه أداة شائعة لاختبار API، ومليء بالميزات التي تجعل من السهل محاكاة الطلبات وتحليل الردود. لكن هل كنت تعلم أنه يمكنك أيضًا استخدام Postman لأتمتة المهام وإضافة سلوك ديناميكي لطلباتك؟ هنا تأتي أهمية سكريبتات ما بعد الطلبات.

ما هي سكريبتات ما بعد الطلبات؟

سكريبتات ما بعد الطلبات، المعروفة أيضًا باسم سكريبتات الاختبار، هي أجزاء من كود JavaScript تعمل Postman على تنفيذها بعد إرسال الطلب. هذه السكريبتات تُنفذ بعد إرسال الطلب الفعلي واستلام الرد. تُستخدم للتحقق مما إذا كان API يعمل بشكل صحيح، والتحقق من التكاملات، وضمان أن التطورات الجديدة لم تؤثر على الوظائف الحالية.

بينما تقوم سكريبتات ما قبل الطلبات بإعداد الطلب، تقوم سكريبتات ما بعد الطلبات بتحليل الرد. على سبيل المثال، يمكنك التحقق من أن البيانات المتوقعة موجودة في الرد أو إجراء تحقق إضافي.

ما هو Postman

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

متى تستخدم سكريبتات ما بعد الطلبات؟

سكريبتات ما بعد الطلبات متعددة الاستخدامات بشكل لا يصدق، ويمكنك استخدامها في العديد من السيناريوهات المختلفة. تعمل سكريبتات ما بعد الطلبات بعد استلام الرد. تُستخدم للتحقق مما إذا كان API يعمل بشكل صحيح، والتحقق من التكاملات، وضمان أن التغييرات الجديدة لم تؤثر على الوظائف الموجودة. يمكنك كتابة سكريبتات اختبار بلغة JavaScript للتحقق من الرد.

كيفية استخدام سكريبتات ما بعد الطلبات؟

1. افتح Postman وانتقل إلى علامة التبويب "الاختبارات" الموجودة بجوار علامات التبويب "الرؤوس" و "الجسم" في نافذة الطلب.

اكتب اختبارات JavaScript الخاصة بك في هذه العلامة. يوفر Postman مجموعة غنية من الشفرات الجاهزة على الجانب الأيمن لمساعدتك على البدء. على سبيل المثال، يجب أن يكون طول عناصر البيانات أكبر من صفر:

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

// تحقق من طول عناصر البيانات
pm.test("يجب أن يكون طول عناصر البيانات أكبر من صفر", function () {
    const responseData = pm.response.json();
    
    pm.expect(responseData.data.id.length).to.be.greaterThan(0, "يجب ألا يكون المعرف فارغًا");
    pm.expect(responseData.data.name.length).to.be.greaterThan(0, "يجب ألا يكون الاسم فارغًا");
    pm.expect(responseData.data.photoUrls.length).to.be.greaterThan(0, "يجب ألا تكون PhotoUrls فارغة");
    pm.expect(responseData.data.category.id).to.be.greaterThan(0, "يجب ألا يكون معرف الفئة فارغًا");
    pm.expect(responseData.data.category.name.length).to.be.greaterThan(0, "يجب ألا يكون اسم الفئة فارغًا");
    responseData.data.tags.forEach((tag)=>{
        pm.expect(tag.id).to.be.greaterThan(0, "يجب ألا يكون معرف العلامة فارغًا");
        pm.expect(tag.name.length).to.be.greaterThan(0, "يجب ألا يكون اسم العلامة فارغًا");
    });
    pm.expect(responseData.data.status.length).to.be.greaterThan(0, "يجب ألا تكون الحالة فارغة");
});

في علامة التبويب "نتائج الاختبار" في أسفل قسم الرد. إذا تم اجتياز سكريبتك، فسوف يظهر باللون الأخضر؛ إذا فشل، فسوف يكون باللون الأحمر.

استخدام سكريبتات ما بعد الطلب في Apidog.

Apidog هو مجموعة كاملة من الأدوات التي تربط دورة حياة API بالكامل. يجمع بين ميزات من أدوات مثل Postman وSwagger وMock وJMeter. يساعد Apidog فرق البحث والتطوير على تنفيذ أفضل الممارسات لتطوير API المبنية على التصميم أولاً. واجهته سهلة الاستخدام تجعل من السهل تصميم وتصحيح وتوثيق ومحاكاة واختبار APIs.

استخدام سكريبتات ما بعد الطلب في Apidog هو طريقة رائعة لأتمتة اختبار ردود API الخاصة بك. إليك دليل خطوة بخطوة حول كيفية استخدامها:

إعداد طلبك:

• في Apidog، أنشئ طلبًا جديدًا من خلال النقر على زر “+” أو اختيار “API جديدة.”
• أدخل عنوان URL للموارد التي تريد تحديثها (النقطة النهائية حيث سترسل طلب POST الخاص بك).
• أضف أي رؤوس أو معلمات إضافية تحتاجها لطلبك.

اكتب سكريبتات ما بعد الطلب:

• انتقل إلى علامة التبويب “معالجات ما بعد الطلب” المجاورة لعلامات التبويب "الرؤوس" و "الجسم" في نافذة الطلب.

// تحقق من طول عناصر البيانات
pm.test("يجب أن يكون طول عناصر البيانات أكبر من صفر", function () {
    const responseData = pm.response.json();
    
    pm.expect(responseData.data.id.length).to.be.greaterThan(0, "يجب ألا يكون المعرف فارغًا");
    pm.expect(responseData.data.name.length).to.be.greaterThan(0, "يجب ألا يكون الاسم فارغًا");
    pm.expect(responseData.data.photoUrls.length).to.be.greaterThan(0, "يجب ألا تكون PhotoUrls فارغة");
    pm.expect(responseData.data.category.id).to.be.greaterThan(0, "يجب ألا يكون معرف الفئة فارغًا");
    pm.expect(responseData.data.category.name.length).to.be.greaterThan(0, "يجب ألا يكون اسم الفئة فارغًا");
    responseData.data.tags.forEach((tag)=>{
        pm.expect(tag.id).to.be.greaterThan(0, "يجب ألا يكون معرف العلامة فارغًا");
        pm.expect(tag.name.length).to.be.greaterThan(0, "يجب ألا يكون اسم العلامة فارغًا");
    });
    pm.expect(responseData.data.status.length).to.be.greaterThan(0, "يجب ألا تكون الحالة فارغة");
});

يسمح لك Apidog بإضافة أنواع مختلفة من سكريبتات ما بعد الطلب.

إرسال طلب POST:

• انقر على زر “إرسال” لتنفيذ طلب POST الخاص بك.

عرض نتائج الاختبار في علامة التبويب على الجانب الأيمن من قسم الرد. إذا تم اجتياز سكريبتك، فسوف يظهر باللون الأخضر؛ إذا فشل، فسوف يكون باللون الأحمر.

تكون سكريبتات ما بعد الطلب مفيدة بشكل خاص في:

• التحقق من الرد: ضمان أن API يرجع رمز الحالة المتوقع، ووقت الرد، وبنية البيانات.
• إعداد متغيرات البيئة: استخراج البيانات من الرد وتعيينها كمتغير بيئي للاستخدام في الطلبات اللاحقة.
• اختبار قائم على البيانات: مقارنة الرد بمجموعة من البيانات للتحقق.

خاتمة

تعد سكريبتات ما بعد الطلب ميزه قوية في Postman يمكن أن تساعدك في أتمتة المهام، وإضافة سلوك ديناميكي لطلباتك، وضمان أن APIs الخاصة بك تعمل كما هو متوقع. فلماذا لا تجربها؟ قد تفاجأ بمدى قدرتها على تبسيط عملية اختبار API الخاصة بك.