مقدمة

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

ألن يكون من الرائع أن يكون لديك طريقة آلية للتعامل مع التخزين المؤقت وإعادة استخدام استجابات الشبكة دون إعداد إستراتيجيات سخرية معقدة؟ لقد بحثت في الأساليب الحالية وقمت بتطوير أداة أريد تقديمها. فهو يحل هذه المشكلات تحديدًا عن طريق تخزين طلبات الشبكة مؤقتًا على نظام الملفات، مما يتيح اختبارات Playwright بشكل أسرع وأكثر موثوقية.

مشكلة طلبات الشبكة في الاختبارات

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

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

أدخل ذاكرة التخزين المؤقت لشبكة الكاتب المسرحي

تم تصميم Playwright-network-cache لتبسيط عملية التخزين المؤقت لاستجابات الشبكة في اختبارات Playwright، مما يلغي الحاجة إلى نماذج وهمية يدوية أو ملفات HAR جامدة. باستخدام هذه المكتبة، يتم تخزين استجابات الشبكة تلقائيًا على نظام الملفات أثناء التشغيل التجريبي الأول ويمكن إعادة استخدامها في عمليات التشغيل اللاحقة، مما يؤدي إلى تسريع تنفيذ الاختبار بشكل ملحوظ. علاوة على ذلك، يتم حفظ الردود في بنية مجلد واضحة ومنظمة، مما يسهل فحصها وتعديلها حسب الحاجة.

كيف يحل المشكلة

1. التخزين المؤقت التلقائي : تقوم المكتبة تلقائيًا بتخزين استجابات الشبكة مؤقتًا عند تشغيل الاختبارات لأول مرة. وهذا يعني أن اختباراتك لن تضطر إلى الانتظار حتى تستجيب واجهات برمجة التطبيقات الخارجية في عمليات التشغيل المستقبلية - سيتم استخدام البيانات المخزنة مؤقتًا بدلاً من ذلك، مما يؤدي إلى اختبارات أسرع وأكثر موثوقية.

2. التعديلات الديناميكية : هل تحتاج إلى تعديل الاستجابة لحالة اختبار معينة؟ يتيح لك playwright-network-cache تعديل الاستجابات المخزنة مؤقتًا ديناميكيًا. سواء كنت تريد تغيير رمز الحالة أو الترويسات أو نص الاستجابة، توفر المكتبة خيارات لضبط البيانات المخزنة مؤقتًا بشكل فوري دون الاحتفاظ بنماذج منفصلة يدويًا.

3. بنية مرنة : يقوم نظام التخزين المؤقت بتنظيم الملفات بناءً على اسم المضيف وطريقة الطلب ومسار عنوان URL، مما يضمن أنه يمكنك التنقل بسهولة عبر البيانات المخزنة مؤقتًا وإدارتها. بالنسبة للحالات الأكثر تعقيدًا، يمكنك أيضًا تقسيم ملفات ذاكرة التخزين المؤقت حسب معلمات استعلام الطلب أو نصوص الطلب أو الحقول المخصصة الأخرى، مما يضمن المرونة الكاملة في كيفية تخزين البيانات وإعادة استخدامها.

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

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

6. لا يوجد تعقيد HAR: يمكن أن تكون ملفات HAR مفيدة لتسجيل وإعادة تشغيل تفاعلات الشبكة، ولكنها سرعان ما تصبح مرهقة، خاصة عندما تحتاج إلى تعديل الاستجابات. يوفر playwright-network-cache بديلاً أكثر نظافة ومرونة لـ HAR من خلال السماح لك بإدارة الاستجابات الفردية كملفات JSON بسيطة.

مثال

تخيل أنك تختبر تطبيقًا يجلب قائمة القطط من واجهة برمجة التطبيقات. بدون التخزين المؤقت، سيتطلب كل اختبار تشغيل طلبًا مباشرًا إلى واجهة برمجة التطبيقات (API)، مما يضيف زمن الاستجابة ونقاط الفشل المحتملة إلى اختباراتك.

باستخدام ذاكرة التخزين المؤقت لشبكة playwright، يمكنك تخزين استجابة واجهة برمجة التطبيقات بسهولة:

test('test', async ({ page, cacheRoute }) => {
  await cacheRoute.GET('https://example.com/api/cats');
  // Perform usual test actions...
});

في التشغيل الأول، يتم تخزين الاستجابة مؤقتًا في دليل .network-cache، ببنية مثل هذا:

.network-cache
└── example.com
    └── api-cats
        └── GET
            ├── headers.json
            └── body.json

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

يمكنك تعديل الاستجابة المخزنة مؤقتًا لاحتياجات الاختبار المحددة:

test('test', async ({ page, cacheRoute }) => {
  await cacheRoute.GET('https://example.com/api/cats', {
    modify: async (route, response) => {
      const json = await response.json();
      json[0].name = 'Kitty-1';
      await route.fulfill({ json });
    }
  });
  // Perform usual test actions...
});

للحصول على متغير مسار التخزين المؤقت المتوفر في اختباراتك، قم بإنشاء مثيل له مثل أي تركيبات أخرى للكاتب المسرحي:

// fixtures.js
import { test as base } from '@playwright/test';
import { CacheRoute } from 'playwright-network-cache';

export const test = base.extend({
  cacheRoute: async ({ page }, use) => {
    const cacheRoute = new CacheRoute(page, { /* cache options */ });
    await use(cacheRoute);
  },
});

هناك العديد من الأمثلة وحالات الاستخدام الأخرى في وثائق المكتبة.

أكثر من مجرد التخزين المؤقت

لا تقتصر ذاكرة التخزين المؤقت لشبكة الكاتب المسرحي على التخزين المؤقت فقط. ويقدم ميزات متقدمة مثل:

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

بفضل هذه الإمكانات القوية، يمكنك التحكم بدقة في كيفية إدارة طلبات الشبكة في اختباراتك.

خلاصة

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

شكرًا على القراءة ❤️