الاختبار البصري (visual testing) طريقة تحقق آلية تقارن لقطات شاشة لواجهة ويب بين إصدارين لاكتشاف الانحدارات الرسومية (عنصر انتقل من مكانه، أو لون تغيّر، أو مكوّن يفيض عن حاويته).
نستخدم GitLab يوميًا في Delta-QA. مستودعاتنا وخطوط أنابيبنا وطلبات الدمج (merge requests) وCI/CD لدينا: كل شيء يعمل على GitLab. وهذا ليس خيارًا افتراضيًا: بل خيار مقصود لمنصة توفر خط أنابيب مدمجًا أصلًا، وسجل حاويات، وفلسفة DevOps متسقة من البداية إلى النهاية.
وحين نتحدث عن الاختبار البصري في GitLab CI، فنحن لا نكرر توثيقًا قرأناه بالأمس. بل نشارك ما تعلمناه من استخدامه فعليًا. يغطي هذا المقال المقاربات المتاحة، وخصوصيات GitLab CI التي تؤثر في الاختبار البصري، وكيف تحصلون على خط أنابيب انحدار بصري موثوق.
الخلاصة في صفحة واحدة (التعريف، والأتمتة بدون برمجة، وجدول اختيار الأداة): اختبار عدم الانحدار الآلي، بدون برمجة.
هل لستم مستعدين بعد للمساس بملف
.gitlab-ci.yml؟ ابدؤوا الاختبار البصري خارج خط الأنابيب: يقارن Delta-QA شاشاتكم بدون برمجة، بحساب مجاني وبدون بطاقة مصرفية. جرّب Delta-QA مجانًا ←
لماذا يناسب GitLab CI الاختبار البصري
لدى GitLab CI خصائص تجعله ملائمًا بوجه خاص للاختبار البصري، خصائص لا يملكها مستخدمو GitHub Actions أو Jenkins افتراضيًا.
القطع الناتجة (artifacts) الأصلية
يدير GitLab CI قطع خط الأنابيب الناتجة أصلًا. وحين ينتج اختبار بصري تقارير HTML أو صور فروق أو لقطات شاشة، تعلنونها كقطع ناتجة فتصبح متاحة مباشرة من واجهة طلب الدمج. لا حاجة إلى خدمة خارجية لتخزين النتائج والاطلاع عليها.
وهي ميزة يُستهان بها. ففي GitHub Actions، عليكم إعداد رفع قطع منفصل أو استخدام خدمة خارجية لإتاحة النتائج. أما في GitLab فهي أصلية.
بيئات المراجعة
يقدم GitLab تطبيقات المراجعة (Review Apps): بيئات مؤقتة تُنشر تلقائيًا لكل طلب دمج. يعمل تطبيقكم في بيئة مخصصة، متاحة عبر عنوان URL مؤقت. إنها البيئة المثالية للاختبار البصري: مستقرة ومعزولة وممثِّلة للإنتاج.
المشغّلات المُدارة ذاتيًا
يتيح GitLab استخدام مشغّلات مستضافة على بنيتكم التحتية. وفي الاختبار البصري هذا حاسم: فأنتم تتحكمون في بيئة العرض (نظام التشغيل والخطوط وGPU)، مما يقلل الإيجابيات الكاذبة الناتجة عن اختلاف البيئات. نستخدم مشغّلات مخصصة بإعداد مثبّت لضمان قابلية إعادة إنتاج الالتقاطات.
سجل الحاويات المدمج
لكل مشروع GitLab سجل حاويات. يمكنكم تخزين صورة Docker مُعدّة مسبقًا للاختبار البصري (بالخطوط الصحيحة والمتصفح الصحيح والتبعيات الصحيحة) واستخدامها أساسًا لمهام الاختبار لديكم. وهذا يزيل مصدرًا رئيسيًا لعدم الاستقرار.
مقاربات الاختبار البصري في GitLab CI
Playwright في مهمة GitLab CI
يُعدّ Playwright أمتن أداة مفتوحة المصدر للاختبار البصري في CI. تتولى دالته الأصلية toHaveScreenshot() الالتقاط والمقارنة وإعادات المحاولة التلقائية.
التكامل مع GitLab CI. تنشئون مهمة في ملف .gitlab-ci.yml تستخدم صورة Docker الرسمية الخاصة بـ Playwright، وتنفذ اختباراتكم، وتنشر النتائج كقطع ناتجة. ويمكن الاطلاع على تقارير HTML الخاصة بـ Playwright مباشرة في GitLab.
وللبنية الدقيقة لملف YAML، اسألوا مساعدكم الذكي المرافق (فهو متمكن من صياغة GitLab CI: وهو تقريبًا الشيء الوحيد الذي لا يهلوس فيه، حتى الآن). وبجدية أكبر، التوثيق الرسمي لـ Playwright لبيئات CI هو أفضل مرجع لكم.
ما ينجح جيدًا. تتضمن صورة Docker الرسمية لـ Playwright كل المتصفحات والتبعيات النظامية اللازمة. وبدمجها مع سجل حاويات GitLab، يمكنكم إنشاء صورة مشتقة بخطوطكم وإعداداتكم الخاصة. وتتيح قطع GitLab الناتجة الوصول إلى تقارير الاختبار دون إعداد إضافي.
الحدود في سياق GitLab. يجب توليد خطوط الأساس في بيئة CI لا محليًا. وهذه قاعدة عامة في الاختبار البصري، لكن GitLab يسهّل الأمر: يمكنكم إطلاق خط أنابيب يدويًا لإعادة توليد خطوط الأساس. وتبقى إدارة خطوط الأساس في Git تحديًا (ملفات ثنائية، تعارضات دمج)، لكن GitLab LFS مدمج أصلًا.
Percy مع GitLab CI
يقدم Percy (BrowserStack) تكاملًا رسميًا مع GitLab CI. تلتقط حزمة Percy اللقطات أثناء خط أنابيبكم وترسلها إلى سحابة Percy للمقارنة والمراجعة.
ما ينجح. يكتشف Percy تلقائيًا الفرع وطلب الدمج في GitLab. وتظهر النتائج كحالة خارجية على طلب الدمج. ويُدار تعدد المتصفحات في السحابة.
الحدود. يبقى التسعير بحسب اللقطة موضوعًا. وتضيفون اعتمادًا خارجيًا على خط أنابيبكم: إن كان Percy غير متاح، يبقى فحصكم معلقًا. ولفريق اختار GitLab تحديدًا للتحكم في بنيته التحتية، قد يتناقض هذا الاعتماد الخارجي مع الفلسفة.
BackstopJS في GitLab CI
يعمل BackstopJS في GitLab CI عبر صورة Docker الرسمية. وتناسب تقارير HTML نظام قطع GitLab الناتجة تمامًا.
ما ينجح. تقرير HTML في BackstopJS من أكثر التقارير بصرية ووضوحًا في المنظومة. وحين يُنشر كقطعة ناتجة في GitLab، يمكن الاطلاع عليه مباشرة في المتصفح من واجهة طلب الدمج. وإعداد السيناريوهات بـ JSON صريح وقابل للتحكم بالإصدارات.
الحدود. مرّ المشروع بفترات صيانة متقطعة: تحققوا من النشاط الأخير قبل الالتزام به. وقد يصبح الإعداد مطولًا في التطبيقات المعقدة، وعليكم إدارة المرور على صفحاتكم أو مكوناتكم يدويًا.
Delta-QA في GitLab CI: SDK Vision
يدخل Delta-QA إلى خط أنابيب GitLab CI عبر اختبارات Playwright لديكم، بواسطة SDK Vision.
كيف يعمل. تحفظون مفتاح API في متغير CI/CD مخفي (DELTAQA_API_KEY) وتضيفون vision.check() إلى الصفحات التي يجب أن تتحقق منها اختباراتكم. وتطلق المهمة npx playwright test كالمعتاد. وعند كل فحص (check)، يقارن Delta-QA الصفحة بمرجعها كما تفعل العين البشرية، ويرصد العناصر التي تغيّرت.
ما الذي يختلف. لا خطوط أساس تُخزَّن في مستودعكم: تعيش المراجع في فضاء Delta-QA لديكم، واحد لكل فرع؛ ولا تقرأ الحزمة git ولا CI: سطر في مهمتكم يعطيها الفرع والفرع الأساسي والـ commit. وأي فرق لم يُحكم عليه يُفشل المهمة، ويعرض سجلها رابط التقرير الذي يخبر أي عنصر تغيّر؛ وهناك يُحكم بـ «مقصود» أو «خطأ». وتشكل الاختبارات التي تعطي الـ commit نفسه نسخة واحدة، حتى لو توزعت على عدة مهام متوازية.
وبدون برمجة. تُحكَم المسارات التي يسجلها فريق الجودة في Delta-QA في الفضاء نفسه. وتغطي الحزمة Playwright بلغتي TypeScript وJavaScript، على Chromium؛ وهي تُعرض أولًا في إتاحة مبكرة، ويُطلب الوصول من صفحتها.
قبل كتابة أي مهمة CI، قيسوا ما يكتشفه الاختبار البصري في صفحاتكم. يلتقط Delta-QA شاشاتكم ويقارنها بنقرات قليلة، بحساب مجاني وبدون بطاقة مصرفية. جرّب Delta-QA مجانًا ←
خصوصيات GitLab CI التي ينبغي معرفتها للاختبار البصري
الذاكرة المؤقتة (cache) مقابل القطع الناتجة (artifacts)
هذا تمييز يخلط فيه كثيرون. الذاكرة المؤقتة في GitLab CI مشتركة بين خطوط أنابيب المشروع الواحد وتُستخدم لتسريع المهام (تبعيات npm، ومتصفحات Playwright). أما القطع الناتجة فهي مخرجات مهمة محددة: تقارير الاختبار ولقطات الشاشة وصور الفروق.
في الاختبار البصري، استخدموا الذاكرة المؤقتة للمتصفحات والتبعيات، والقطع الناتجة لنتائج الاختبار. ولا تخزّنوا خطوط الأساس مؤقتًا أبدًا: يجب أن تعيش في المستودع لتُصدَّر مع الشيفرة.
المراحل (stages) والتبعيات بين المهام
ينظم GitLab CI المهام في مراحل متتابعة. ويجب أن يكون الاختبار البصري في مرحلة تُنفَّذ بعد نشر تطبيق المراجعة. نمط شائع:
- build: بناء التطبيق
- deploy-review: نشر تطبيق المراجعة
- test-visual: الاختبار البصري على تطبيق المراجعة
- cleanup: حذف البيئة
وتتيح التوجيهة needs في GitLab CI إنشاء تبعيات صريحة بين المهام دون المرور بالمراحل المتتابعة، مما قد يسرّع خط أنابيبكم.
متغيرات البيئة المحمية
يجب تخزين رموز API للخدمات السحابية (Percy وChromatic) كمتغيرات CI/CD في GitLab. انتبهوا: المتغيرات المحمية متاحة فقط على الفروع المحمية. فإن لم تكن فروع الميزات لديكم محمية، فسيفشل الاختبار البصري بخدمة سحابية بصمت، وهو فخ كلاسيكي.
حدود الزمن والذاكرة
الاختبار البصري شره للموارد. فعرض الصفحات في متصفح بلا واجهة يستهلك الذاكرة، ومقارنة الصور تستغرق وقتًا. وللمشغّلات المشتركة في GitLab.com حدود زمن (عادة ساعة لكل مهمة) وذاكرة. ولمجموعات اختبار بصري كبيرة يوصى بالمشغّلات المُدارة ذاتيًا ذات الموارد المخصصة.
بناء خط أنابيب اختبار بصري متين
إليكم المقاربة التي نوصي بها، المبنية على تجربتنا الخاصة.
ابدؤوا صغيرًا ومستهدفًا
لا تختبروا كل صفحاتكم بصريًا منذ اليوم الأول. حدّدوا خمس إلى عشر صفحات هي الأكثر حرجًا: التي يراها مستخدموكم أولًا، والتي يكون لانحدار بصري فيها أكبر أثر على الأعمال. ثم وسّعوا تدريجيًا.
استخدموا تطبيقات المراجعة هدفًا
بدل تشغيل خادم محلي في مهمة CI لديكم، انشروا تطبيق مراجعة واختبروه. الميزة: البيئة مستقرة ومتاحة وممثِّلة. العيب: تضيفون مدة النشر إلى خط الأنابيب. والمفاضلة تستحق ذلك.
ثبّتوا بيئة العرض
أنشئوا صورة Docker مخصصة للاختبار البصري، مخزنة في سجل GitLab لديكم. ضمّنوا الخطوط التي يستخدمها تطبيقكم، والإصدار الدقيق للمتصفح، وكل التبعيات النظامية. وأصدِروا هذه الصورة بإصدارات. فحين تُثبَّت بيئة العرض، تنخفض الإيجابيات الكاذبة انخفاضًا حادًا.
ابدؤوا بوضع غير حاجب
اضبطوا مهمة الاختبار البصري لديكم بـ allow_failure: true خلال الأسابيع الأولى. هذا يتيح لفريقكم التآلف مع النتائج دون أن يحجب الاختبار البصري طلبات الدمج. وبمجرد ترسخ الثقة وضبط الإيجابيات الكاذبة، انتقلوا إلى الوضع الحاجب.
أخطروا بذكاء
يستطيع GitLab CI إرسال إشعارات عبر قنوات مختلفة (Slack والبريد الإلكتروني وwebhook). اضبطوا إشعارات الاختبار البصري بحيث تنبّه عند الإخفاق فقط، لا عند النجاح. الهدف جذب الانتباه عند الحاجة، لا إغراق فريقكم بالرسائل.
استثمار القطع الناتجة كنظام مراجع
لا تفيد قطع GitLab الناتجة في نشر التقارير فحسب: فإذا نُظمت جيدًا صارت العمود الفقري لاستراتيجية المراجع لديكم. ممارستان تصنعان الفرق.
نظّموا القطع بشكل مقروء
لا تكدّسوا كل لقطاتكم في مستوى واحد. أنشئوا شجرة واضحة: مجلد لكل صفحة مختبَرة، يحتوي بداخله على لقطة المرجع واللقطة الحالية وصورة الفروق. وضعوا تقرير HTML في الجذر للتنقل بين النتائج. وحين يفشل اختبار، يفتح المراجع متصفح القطع المدمج في GitLab، ويتنقل إلى الصفحة المعنية، ويرى الفرق فورًا دون مغادرة الواجهة.
استخدموا قطع main كمراجع
بدل تخزين خطوط الأساس في المستودع، يمكنكم استثمار قطع آخر خط أنابيب ناجح على الفرع الرئيسي كمجموعة مراجع. يتيح GitLab CI تنزيل قطع مهمة محددة على فرع محدد عبر واجهته البرمجية.
عمليًا، تبدأ مهمة الاختبار البصري في فرع الميزة لديكم بتنزيل لقطات المرجع من قطع آخر خط أنابيب main. ثم تلتقط لقطات فرع الميزة، وتقارن المجموعتين، وتخزن نتائجها كقطع لخط الأنابيب الحالي. ولا يلوث أي خط أساس ثنائي تاريخ Git لديكم.
سياسة احتفاظ بمستويين
مدة الاحتفاظ بقطع GitLab الناتجة قابلة للضبط، وفي الاختبار البصري تنجح سياسة بمستويين:
- الفرع الرئيسي: 30 يومًا (أو أكثر). تعمل هذه القطع كمراجع مستقرة لكل المقارنات.
- فروع الميزات: 7 أيام. الوقت اللازم لمعالجة طلب الدمج ودمجه.
اضبطوا بحسب إيقاعكم: فريق بدورات طويلة (فروع تعيش عدة أسابيع) سيحتاج احتفاظًا أطول على main، وعليه إعادة التأسيس (rebase) بانتظام أو إعادة تنزيل أحدث المراجع في كل تشغيل لتفادي المقارنة بخطوط أساس منتهية الصلاحية.
الأسئلة الشائعة
هل GitLab CI بجودة GitHub Actions نفسها للاختبار البصري؟
للاختبار البصري تحديدًا، يملك GitLab CI مزايا أصلية: القطع الناتجة المدمجة، وتطبيقات المراجعة، وسجل الحاويات، والمشغّلات المُدارة ذاتيًا. وتسهّل هذه الميزات إعداد بيئة اختبار بصري مستقرة وقابلة لإعادة الإنتاج. ولدى GitHub Actions متجره الغني الخاص، لكن بعض هذه الميزات تتطلب إعدادات إضافية.
هل يلزم مشغّلات مُدارة ذاتيًا للاختبار البصري في GitLab CI؟
ليس إلزاميًا، لكنه يوصى به بشدة. تعمل المشغّلات المشتركة في GitLab.com، لكن إعدادها العتادي المتغير قد يُدخل اختلافات في العرض. أما المشغّل المُدار ذاتيًا بإعداد مثبّت (الخطوط والمتصفح والدقة) فيزيل مصدر الإيجابيات الكاذبة هذا ويقدم عادة أداءً أفضل.
كيف ندير خطوط الأساس للاختبار البصري في مستودع GitLab؟
إذا استخدمتم Playwright أو BackstopJS، فإن خطوط الأساس (ملفات PNG) تعيش في مستودعكم. فعّلوا GitLab LFS لتفادي تضخم تاريخ Git بالملفات الثنائية. وبالنسبة لتعارضات الدمج على خطوط الأساس، فإن أبسط استراتيجية هي قبول خطوط الأساس الجديدة من الفرع المصدر وإعادة التوليد عند الحاجة. ومع Delta-QA تُدار خطوط الأساس بواسطة الأداة ولا تلوث مستودعكم.
هل يمكن استخدام تطبيقات المراجعة في GitLab كبيئة اختبار بصري؟
نعم، بل هي المقاربة التي نوصي بها. توفر تطبيقات المراجعة بيئة مستقرة ومعزولة لكل طلب دمج. تنتظر مهمة الاختبار البصري أن يُنشر تطبيق المراجعة، وتلتقط لقطات الشاشة على عنوان URL المؤقت، وتقارن بالمراجع. وهذا أوثق من خادم يُشغَّل على الفور داخل مهمة CI.
هل يعمل الاختبار البصري في GitLab CI مع المستودعات الأحادية (monorepos)؟
نعم. يدعم GitLab CI القواعد الشرطية التي تتيح إطلاق الاختبار البصري فقط إذا عُدّلت ملفات الواجهة الأمامية. وبدمجها مع التوجيهة only:changes، تتفادون تنفيذ اختبارات بصرية غير مفيدة حين لا يتغير إلا الجزء الخلفي. وهذا أساسي للحفاظ على خط أنابيب سريع في مستودع أحادي.
ما أفضل صورة Docker للاختبار البصري في GitLab CI؟
الصورة الرسمية لـ Playwright (mcr.microsoft.com/playwright) نقطة انطلاق ممتازة. فهي تتضمن المتصفحات والتبعيات النظامية. ولبيئة أكثر استقرارًا، أنشئوا صورة مشتقة تضيف خطوط تطبيقكم وتثبّت الإصدارات الدقيقة. وخزّنوها في سجل حاويات مشروع GitLab لديكم لوصول سريع.
الخلاصة
GitLab CI منصة ملائمة بطبيعتها للاختبار البصري. فميزاتها الأصلية (القطع الناتجة، وتطبيقات المراجعة، وسجل الحاويات، والمشغّلات المُدارة ذاتيًا) تحل مشكلات تتطلب منصات CI أخرى معالجتها يدويًا.
لكن المنصة لا تفعل كل شيء. يبقى الاختبار البصري في CI تحديًا هندسيًا: تثبيت العرض، وإدارة خطوط الأساس، ومعالجة الإيجابيات الكاذبة، وبناء سير مراجعة يعمل للفريق كله.
وإذا كنتم على GitLab وتريدون إضافة الاختبار البصري إلى خط أنابيبكم دون تعقيد سكربتات الاختبار والإدارة اليدوية لخطوط الأساس، فقد صُمم Delta-QA ليندمج أصلًا في سير عمل GitLab CI لديكم.
هل أنتم مستعدون لجعل طلبات الدمج لديكم أوثق بالاختبار البصري؟ أطلقوا أول مقارنة لكم مع Delta-QA، مجانًا وبدون بطاقة مصرفية، قبل حتى أن تمسّوا ملف
.gitlab-ci.yml. جرّب Delta-QA مجانًا ←
