إدارة الطلبات المتقدمة باستخدام Collections و كتابة الاختبارات بـ Scripts

أهلاً بك في الدرس الرابع من دورة Postman و API Testing!

في هذا الدرس سنتقل من مرحلة إرسال الطلبات اليدوية (Manual Requests) إلى مرحلة التنظيم والأتمتة (Automation) من خلال استخدام الـ **Collections** وكتابة **Test Scripts** للتحقق الآلي من صحة الـ APIs.

---

1. ما هي الـ Collections في Postman؟

الـ **Collection** هي عبارة عن مجلد يُستخدم لتجميع وإدارة الطلبات (Requests) المرتبطة بمشروع معين أو ميزة معينة.

فوائد الـ Collections:

* **التنظيم:** بدلاً من وجود طلبات مبعثرة، يمكنك تقسيم المشافع إلى مجلدات فرعية (مثلاً: Authentication, Products, Cart).

* **إعادة الاستخدام:** يمكنك حفظ وتمرير متغيرات مشتركة (Variables) بين الطلبات بداخلها.

* **التشغيل الآلي:** ميزة **Collection Runner** تتيح لك تشغيل عشرات الطلبات والاختبارات متتالية بزر واحد.

---

2. مفهوم الـ Scripts في Postman

يقدم Postman تبويبين رئيسيين لكتابة أكواد بلغة **JavaScript**:

أ. Pre-request Script

* يُنفذ هذا السكريبت **قبل** إرسال طلب الـ HTTP للسيرفر.

* يُستخدم عادة في تجهيز البيانات، أو توليد تواريخ عشوائية، أو حساب توقيعات أمان (Signatures/Tokens).

ب. Tests Script

* يُنفذ هذا السكريبت **بعد** وصول الاستجابة (Response) من السيرفر.

* يُستخدم بكثرة للتحقق من:

* الـ **Status Code** (مثل 200, 201, 404).

* **زمن الاستجابة** (Response Time).

* محتوى الـ **Response Body** وقيم الحقول الـ JSON.

---

3. كتابة أول Test Script باستخدام Postman Chai Library

يعتمد Postman على مكتبة **Chai Assertion Library** للتأكد من النتائج. إليك مثال لكتابة اختبار بسيط:

```javascript

// التأكد من أن الـ Status Code هو 200

pm.test(“Status code is 200”, function () {

pm.response.to.have.status(200);

});

// Test 1: Check Status Code is 200 OK
pm.test("Status code is 200 OK", function () {
    pm.response.to.have.status(200);
});

// Test 2: Response time is less than 500ms
pm.test("Response time is less than 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
});

// Test 3: Check JSON body field
pm.test("Response body contains title", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0]).to.have.property("title");
});