اللقطة الدلالية ليست شهادة إمكانية الوصول.

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

يستخدم هذا الدليل وثائق لقطة ARIA الخاصة بـ Playwright لإنشاء عقد دلالي صغير. الشاشة المصاحبة هي شكل محلي مخترع. فهو يوضح العلاقة بين العنوان والزر، وليس عملية دفع العميل التي تم اختبارها أو تدقيق كامل لإمكانية الوصول.

ابدأ بمنطقة يمكنك شرحها

يصف Playwright لقطات ARIA بأنها تمثيلات YAML للبنية التي يمكن الوصول إليها. الأدوار والأسماء والسمات المحددة تأتي من دلالات HTML أو ARIA. القالب هو القيد. إنه ليس بالضرورة تسلسلًا كاملاً لكل شيء في شجرة إمكانية الوصول.

بالنسبة لمنطقة العرض التجريبي التي يتم التحكم فيها والتي تحتوي على عنوان وزر، يمكن أن يكون الشيك صغيرًا بما يكفي لقراءته في المراجعة:

await expect(page.getByRole('region', { name: 'Demo checkout' }))
  .toMatchAriaSnapshot(`
- heading "Review order" [level=2]
- button "Continue"
  `);

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

اقرأ ما يتركه القالب

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

القالب الذي يشير إلى الزر الوحيد قد يستمر في المرور بعد أن يصبح "متابعة" تسمية غير مفيدة. قد تمر خانة الاختيار التي لا تحتوي على قيد الحالة المحددة في أي من الحالتين. اكتب لماذا يعتبر كل إغفال آمنًا. إذا كان الاسم أو الحالة التي يمكن الوصول إليها ذات أهمية للرحلة، فاحتفظ بها في العقد أو أضف تأكيدًا مركّزًا.

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

الاختلاف الدلالي يستحق مراجعة المنتج

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

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

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

البنية هي طبقة واحدة من أدلة إمكانية الوصول

لا توفر الشجرة المطابقة تباينًا قابلاً للقراءة، أو تركيزًا قابلاً للاستخدام، أو إكمال لوحة المفاتيح، أو أخطاء معقولة، أو تجربة جيدة لقارئ الشاشة. استخدم فحوصات منفصلة لتلك المخاطر. يصف دليل اختبار إمكانية الوصول الخاص بـ Playwright المسح الآلي وحدوده؛ يجب أن تكون عمليات الفحص الآلي مصحوبة بتقييم يدوي عند الحاجة.

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

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

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