كيفية تعيين المتغيرات في سكربت ما بعد الطلب في بوستمان

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

تتناول هذه المقالة تفاصيل استخدام قدرات البرمجة النصية في Postman لتعيين المتغيرات. سوف تقدم إرشادات شاملة حول استخدام دوال pm.environment.set() و pm.globals.set() لإنشاء وإدارة المتغيرات ضمن نطاقات مختلفة. ستوضح الأمثلة العملية كيفية استخراج البيانات من استجابات واجهة برمجة التطبيقات وتعيينها للمتغيرات للاستخدام اللاحق في حالات الاختبار.

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

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

بشكل أساسي، تسمح لك بأتمتة المهام المختلفة لاختبار البيانات والتعامل معها داخل بيئة Postman.

دليل خطوة بخطوة حول كيفية تعيين متغير في سكربت ما بعد الطلب في Postman

الخطوة 1 - الوصول إلى علامة تبويب سكربت ما بعد الطلب:

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

الخطوة 2 - استخراج البيانات من استجابة Postman

استخدم طرق pm.response.json() أو pm.response.text() للوصول إلى جسم استجابة واجهة برمجة التطبيقات كـ JSON أو نص، على التوالي.

خلال هذه الخطوة، يجب عليك أيضًا استخدام أي تقنيات ضرورية للتلاعب بالكائنات أو السلاسل في JavaScript لاستخراج البيانات المطلوبة.

الخطوة 3 - تعيين المتغير

يجب أن تستخدم إما pm.environment.set() أو pm.globals.set() أو pm.collectionVariables.set() لتخزين البيانات المستخرجة في متغير. يعتمد الاختيار على النطاق المطلوب.

مثال على تعيين متغير في سكربت ما بعد الطلب في Postman

pm.test("تعيين متغير", () => {
    const jsonData = pm.response.json();
    const token = jsonData.access_token;
    pm.environment.set("auth_token", token);
});

تستخرج هذه القطعة الشفرية access_token من الاستجابة بصيغة JSON وتخزنها في متغير بيئة يسمى auth_token.

نصائح إضافية

• تعامل مع الأخطاء: نفذ معالجة الأخطاء للتعامل بسلاسة مع تنسيقات الاستجابة غير المتوقعة أو البيانات المفقودة.
• أنواع البيانات: تأكد من صحة أنواع البيانات للمتغيرات. استخدم عامل typeof للتحقق.
• استخدام المتغيرات: الوصول إلى المتغيرات في الطلبات اللاحقة باستخدام الأقواس المعقوفة المزدوجة: {{auth_token}}.
• أفضل الممارسات: ضع في اعتبارك استخدام أسماء متغيرات وصفية وتنظيم سكربتاتك لتحسين قابلية القراءة.

مزايا تعيين المتغيرات في سكربتات ما بعد الطلب في Postman

بيانات اختبار ديناميكية

بيانات في الوقت الحقيقي: التقاط وتخزين البيانات الديناميكية من استجابات واجهة برمجة التطبيقات (مثل: المعرفات، الرموز، الطوابع الزمنية) لاستخدامها الفوري في الطلبات اللاحقة.

اختبار مدفوع بالبيانات: إنشاء اختبارات أكثر قوة باستخدام بيانات فعلية من النظام بدلاً من القيم الثابتة.

إعادة استخدام بيانات الاختبار

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

الارتباط: ربط الطلبات المعتمدة من خلال تمرير البيانات من استجابة إلى أخرى، مما يحسن دقة الاختبار.

صيانة الاختبار

المرونة: تعديل قيم المتغيرات بسهولة دون تغيير العديد من أجسام الطلبات، مما يجعل تحديثات الاختبار أكثر كفاءة.

المركزية: إدارة بيانات الاختبار في موقع مركزي (متغيرات بيئية أو عالمية) لتحسين التنظيم.

سيناريوهات اختبار معقدة

معالجة البيانات: معالجة وتحويل البيانات الملتقطة قبل تخزينها كمتغير، مما يمكّن من منطق اختبار معقد.

المنطق الشرطي: استخدام المتغيرات في العبارات الشرطية للتحكم في تدفق الاختبار بناءً على بيانات الاستجابة.

التعاون

البيانات المشتركة: مشاركة المتغيرات البيئية أو العالمية بين أعضاء الفريق للحفاظ على بيانات اختبار متسقة.

إدارة البيئة: إنشاء بيئات مختلفة بقيم متغيرة متباينة لسيناريوهات اختبار مختلفة.

الحالات الشائعة لاستخدام تعيين المتغيرات في سكربتات ما بعد الطلب في Postman

يعتبر تعيين المتغيرات في سكربتات ما بعد الطلب في Postman تقنية متعددة الاستخدامات لها العديد من التطبيقات في اختبار واجهة برمجة التطبيقات. إليك بعض الحالات الشائعة:

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

Apidog - أداة تطوير واجهة برمجة تطبيقات شاملة

Apidog هي أداة شاملة لواجهة برمجة التطبيقات توفر للمستخدمين وظائف كاملة لدورة حياة واجهة برمجة التطبيقات بأكملها. تتخصص في واجهة مستخدم بسيطة وبديهية تعزز من نهج التصميم في تطوير واجهة برمجة التطبيقات.

إنشاء سكربتات ما بعد المعالجة خلال ثوانٍ

مع Apidog، يمكنك تنفيذ ما بعد المعالجة بالطريقة التي ترغب بها.

يمكنك الاختيار من بين مجموعة متنوعة من المعالجات بعد الطلب، مثل التأكيدات، والعمليات المخصصة، وحتى السكربتات العامة.

استيراد واجهات برمجة التطبيقات الأخرى إلى Apidog

يدعم Apidog أنواع ملفات واجهة برمجة التطبيقات المختلفة، بما في ذلك OpenAPI (أو Swagger)، Postman، وInsomnia. بهذه الطريقة، يمكنك استيراد المشاريع الحالية إلى بيئة تطوير Apidog الأنيقة لمزيد من التعديلات!

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

الاستنتاج

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

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