كيف تضيف مكتبات خارجية إلى بوستمين

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

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

لماذا استخدام المكتبات الخارجية في Postman؟

قبل أن نتعمق في التفاصيل، دعنا نستكشف الأسباب المقنعة لاستغلال المكتبات الخارجية:

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

استيراد المكتبات الخارجية: طريقتان قويّتان

يقدم Postman طريقتين رئيسيتين لإدماج المكتبات الخارجية:

1. جلب من شبكة توصيل المحتوى (CDN):

لدى العديد من المكتبات إصدارات CDN مستضافة على منصات مثل jsDelivr أو cdnjs. هذا يسمح لك باستيراد كود المكتبة مباشرة إلى Postman باستخدام دالة pm.sendRequest. إليك كيف:

العثور على عنوان URL الخاص بـ CDN: ابحث عن رابط CDN للمكتبة التي اخترتها (تجدها عادةً على صفحة الوثائق الخاصة بها).
إنشاء نص برمجي قبل الطلب: داخل علامة "نص مكتوب قبل الطلب" في طلبك، استخدم pm.sendRequest لجلب كود المكتبة من عنوان URL لـ CDN.
تخزين وتقييم: احفظ الاستجابة المسترجعة كمتغير في المجموعة واستخدم دالة eval لتنفيذ كود المكتبة، مما يجعل وظائفها متاحة داخل بيئة Postman الخاصة بك.

2. التحميل من متغير المجموعة:

إذا كنت تفضل تجنب إرسال طلب API في كل مرة، يمكنك تخزين كود المكتبة مباشرة داخل متغير المجموعة. إليك الخطوات:

انسخ والصق الكود: ابحث عن الكود البرمجي الخاص بالمكتبة (غالبًا ما يكون موجودًا في مستودع GitHub الخاص بها).
إنشاء متغير مجموعة: داخل مجموعتك، أنشئ متغيرًا جديدًا والصق كود المكتبة بداخله.

استخدام تعبير دالة مستدعاة بشكل فوري (IIFE): في سكريبتات Postman الخاصة بك، استخدم تعبير الدالة المستدعاة بشكل فوري لتغليف كود المكتبة، مما يجعل طرقها متاحة داخل صندوق الرمل في Postman.

تذكر، أن كلا الطريقتين لهما مزاياهما. الجلب من CDN يبقي كود مجموعتك نظيفًا، بينما التحميل من متغير يلغي الحاجة إلى طلبات API إضافية. اختر الأسلوب الذي يتناسب مع سير العمل الخاص بك!

كيفية استيراد المكتبات الخارجية في Apidog

Apidog هي منصة تعاون متكاملة مصممة لتبسيط دورة حياة واجهات برمجة التطبيقات. تجمع بين وظائف العديد من الأدوات مثل Postman وSwagger وMock وJMeter في منصة واحدة.

زر

يحتوي Apidog على محرك برمجي يعتمد على JavaScript. يمكنك استخدام السكريبتات (قصاصات كود JavaScript) لإضافة سلوك ديناميكي إلى طلبات واجهة برمجة التطبيقات أو اختبارات المجموعة.

لاستيراد المكتبات التي ليست مدمجة ولكن تم توفيرها على npm ديناميكيًا باستخدام دالة $$.liveRequire. فقط المكتبات النقية المدعومة، ويفضل المكتبات التي تحتوي على كلمة browser لدعم التشغيل على جانب المتصفح. المكتبات التي تحتوي على امتدادات لغوية مثل C/C++ غير مدعومة ولا يمكن تحميلها وستتسبب في انتهاء الوقت أو الاستثناءات.

فيما يلي مثال لاستخدام مكتبة JS غير مدمجة.

// جلب مكتبة npm واحدة: camelcase
$$.liveRequire("camelcase", (camelCase) => {
  camelCase("foo-bar"); // => 'fooBar'
});

// جلب عدة مكتبات npm: camelcase
$$.liveRequire(["camelcase", "md5"], (camelCase, md5) => {
  camelCase("foo-bar"); // => 'fooBar'
  md5("message"); // => '78e731027d8fd50ed642340b7c9a63b3'
});

using a non-built-in JS class library in Apidog

يوفر بناء جملة Apidog توافقًا بنسبة 100٪ مع بناء جملة سكريبتات Postman. يمكن ترحيل سكريبتات Postman بسلاسة إلى Apidog.

استخدم سكريبت المعالجة اللاحقة لكتابة سكريبت مخصص لاستيراد المكتبات

Use the postprocessor script to write your custom script

2. أرسل الطلب وحلل الإجابة في علامة التبويب الكونسول

Send the request and analyze the answer in the console tab

المكتبات الخارجية الشهيرة لتعزيز اختبار واجهات برمجة التطبيقات الخاصة بك

الآن بعد أن تعرفت على كيفية ذلك، دعنا نستكشف بعض المكتبات الخارجية الشهيرة التي يمكن أن تعزز بشكل كبير تجربتك مع Postman:

Lodash: توفر هذه المكتبة المتعددة الاستخدامات مجموعة واسعة من وظائف المساعدة لتلاعب البيانات، مما يجعل التحويلات المعقدة سهلة للغاية.
Moment.js: هل تعمل مع التواريخ والأوقات؟ Moment.js تقدم واجهة برمجة تطبيقات بديهية لتحليل، وتنسيق، وإجراء حسابات على التواريخ، وهي منقذة للحياة لواجهات برمجة التطبيقات التي تعتمد بشكل كبير على التواريخ.
Chai.js: تمكّنك هذه المكتبة من كتابة تأكيدات واضحة وموجزة للتحقق من استجابة واجهات برمجة التطبيقات، مما يضمن أن اختباراتك قوية وموثوقة.
Faker.js: هل تحتاج إلى بيانات اختبار واقعية؟ تولد Faker.js بيانات واقعية للأسماء، والعناوين، والبريد الإلكتروني، والمزيد، مما يجعلها مثالية لإنشاء سيناريوهات اختبار شاملة.

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

أمثلة في العمل: إحياء المكتبات في Apidog و Postman

لتعزيز فهمنا، دعنا نستكشف أمثلة ملموسة لاستخدام المكتبات الشهيرة في Apidog و Postman:

Moment.js لتلاعب بالتواريخ: تخيل أنك تختبر نقطة نهاية واجهة برمجة التطبيقات التي تتطلب تنسيق التواريخ. يأتي Moment.js لإنقاذك! يمكنك استيراده باستخدام إحدى الطرق المذكورة أعلاه ثم الاستفادة من وظائفه البديهية لتنسيق وتحليل وإجراء حسابات على التواريخ ضمن اختبارات Postman الخاصة بك.

Lodash لتحويل البيانات: هل تعمل مع هياكل بيانات JSON معقدة؟ توفر Lodash مجموعة واسعة من وظائف المساعدة للتصفية، والفرز، والتجميع، وتحويل البيانات. قم بدمج Lodash في بيئة Postman الخاصة بك لتبسيط مهام التعامل مع البيانات وكتابة اختبارات أكثر إيجازًا وتعبيرًا.

نصائح احترافية لتكامل سلس للمكتبات

بينما تغوص في عالم المكتبات الخارجية، احتفظ بهذه النصائح في اعتبارك:

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

الخاتمة

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