أفضل ممارسات Playwright: 10 قواعد يخطئ فيها وكلاء الذكاء الاصطناعي

يمكن لوكلاء الذكاء الاصطناعي كتابة 50 اختبار Playwright في دقيقة واحدة.

هذه السرعة هي فخ.

فغالبًا ما تفشل هذه الاختبارات دون سبب. ينسخ وكلاء الذكاء الاصطناعي الأنماط القديمة من بيانات التدريب؛ فهم لا يعرفون أن اختباراتك قد فشلت ليلة أمس، بل يستخدمون عادات قديمة.

اتبع هذه القواعد العشر للحفاظ على استقرار اختباراتك.

  1. استخدم محددات الموقع القائمة على الأدوار (role-based locators) استخدم getByRole أو getByLabel أو getByText. هذه المحددات تطابق ما يراه الشخص. خطأ الذكاء الاصطناعي: يستخدم الوكلاء CSS أو XPath، وهي تنهار بمجرد تغيير اسم فئة (class name) واحد.

  2. استخدم تأكيدات الويب أولاً (web-first assertions) استخدم expect(locator).toBeVisible(). هذا الأمر ينتظر الصفحة تلقائيًا. خطأ الذكاء الاصطناعي: يضيف الوكلاء await page.waitForTimeout(3000). الانتظار القسري (Hard waits) يتسبب في اختبارات غير مستقرة (flaky tests).

  3. حافظ على عزل الاختبارات يجب أن يبدأ كل اختبار في حالة نظيفة. استخدم الـ hooks لإعداد الحالة. خطأ الذكاء الاصطناعي: يقوم الوكلاء بربط الاختبارات معًا؛ فإذا فشل الاختبار الأول، ينهار الملف بأكمله.

  4. قم بتغذية البيانات عبر الـ API استخدم الـ request fixture لإرسال البيانات مباشرة إلى الخلفية (backend) الخاصة بك. خطأ الذكاء الاصطناعي: ينقر الوكلاء عبر عشر شاشات في واجهة المستخدم لإنشاء مستخدم واحد، مما يجعل الاختبارات بطيئة وهشة.

  5. أعطِ الأولوية للأدوار على معرفات الاختبار (test IDs) استخدم getByRole أولاً، واستخدم data-testid فقط كخيار احتياطي. خطأ الذكاء الاصطناعي: يضع الوكلاء data-testid على كل شيء، مما يؤدي إلى تفويت الأخطاء التي تحدث عندما لا يكون للزر تسمية (label) لقارئات الشاشة.

  6. اضبط سجلات التتبع (traces) للتسجيل عند إعادة المحاولة اضبط trace على 'on-first-retry' في ملف الإعدادات الخاص بك. خطأ الذكاء الاصطناعي: يترك الوكلاء التتبع معطلاً أو يتركونه يعمل في كل عملية تشغيل؛ أحدهما يفتقر إلى الأدلة، والآخر يبطئ كل شيء.

  7. التشغيل بالتوازي استخدم الوضع المتوازي (parallel mode) والتقسيم (sharding) لتوزيع الاختبارات عبر الأجهزة. خطأ الذكاء الاصطناعي: يكتب الوكلاء اختبارات تشترك في مستخدم واحد، مما يجعل هذه الاختبارات تتصادم مع بعضها البعض عند التشغيل بالتوازي.

  8. احذف جمل if وكتل try يجب أن يتبع الاختبار مسارًا واحدًا. إذا كان من المفترض وجود زر ما، فقم بالتأكيد عليه (assert). خطأ الذكاء الاصطناعي: يغلف الوكلاء عمليات النقر داخل جمل if لتجنب الأخطاء، وهذا يخفي الأخطاء الحقيقية.

  9. اختبر السلوك، وليس التفاصيل الداخلية تحقق من النتيجة المرئية على الشاشة. خطأ الذكاء الاصطناعي: يقوم الوكلاء بالتأكيد على فئات CSS أو متغيرات الحالة، وهي أمور تنهار مع كل عملية إعادة هيكلة للكود (code refactor).

  10. استخدم المشاريع (projects) لتغطية المتصفحات استخدم مصفوفة projects لاختبار Chromium و Firefox و WebKit. خطأ الذكاء الاصطناعي: يقوم الوكلاء بتثبيت متصفح واحد في الكود، مما يجعلك تفوت الأخطاء التي تحدث فقط في Safari.

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

إن مجموعة اختبارات تظهر باللون الأخضر (ناجحة) ولكنها لا تثبت شيئًا هي أمر خطير، فهي تخلق ثقة زائفة.

دع الذكاء الاصطناعي يكتب المسودة. استخدم بشراً لتطبيق هذه القواعد. الوكيل يوفر السرعة. الإنسان يوفر الاستقرار.

المصدر: https://dev.to/aiwithanton/playwright-best-practices-10-rules-ai-agents-get-wrong-2026-5cii

مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi