تحديث اللقطة قرار مراجعة.

يفشل فحص اللقطة بعد اختفاء زر. تحديث الصورة المتوقعة يعيد النجاح لكنه قد يجعل الاختفاء الحالة الطبيعية الجديدة. لا يقرر الأمر هل كان الاختفاء مقصودا. تحديث المرجع قرار بشأن المنتج وليس إصلاحا بأداة الصور.

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

سم المرجع وبيئته

يقارن الفحص الصورة بمرجع. يصف الدليل إنشاء المرجع في التنفيذ الأول ثم المقارنة لاحقا. اختر اسما يحدد المشهد حتى لا تستبدله صورة غير مرتبطة.

await page.setContent(`
  <main aria-label="Demo preference card">
    <h1>Demo preference</h1>
    <button>Keep demo setting</button>
  </main>
`);
await expect(page.getByRole('main')).toHaveScreenshot('demo-card.png');

يلزم مشغل Playwright واستيراد expect. تلتقط منطقة واحدة لا المنتج كله. يستخدم المثال تنسيقا ثابتا وحجم عرض محددا. ينشأ المرجع عمدا ثم يقارن في تشغيل مستقل.

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

اقرأ الفرق قبل الاستبدال

افحص الصورة المتوقعة والحالية والتغيير المرئي. قد يتغير المتطلب أو تنحرف البيئة أو يحدث عيب. تتطلب الأسباب إجراءات مختلفة رغم اللون الأحمر نفسه.

أمر update-snapshots موثق. استخدمه بعد فهم التغيير وقبوله في سير عمل الفريق. راجع ملفات المرجع كتغيير للسلوك المتوقع. لا تحدث الجميع لإسكات الاختلافات.

قد يكون الزر المحذوف تصميما صحيحا أو عيبا خطيرا. لا تعرف البكسلات ذلك. اربط التغيير بالمتطلب واحتفظ بفحص وظيفي حين تهم إتاحة الزر.

حدد المقارنة بصدق

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

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

نقارن البطاقة غير المتغيرة وننشئ صورة أخرى بنص زر مختلف للفحص البصري. الثانية لا تقبل مرجعا جديدا. يوضح المثال تغييرا ومقارنة ثابتة لا استراتيجية كاملة.

احتفظ بقرار قابل للمراجعة

سجل المشهد والبيئة والفرق المقصود وقرار المراجع. احفظ التاريخ ليفهم المهندس التالي تغير التوقع. أزل السجلات الخاصة قبل إدخال الصور للمستودع.

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

يصف AnyTest الاستكشاف واختبارات مراجعة البشر. اسأل عما يقارن ومن وافق على التوقع الجديد. لا ندعي ميزة مراجع في AnyTest. الأمر يكتب الملف والمراجع يملك معناه.