قراءة لقطة شاشة بالمساعد الذكي: هل الزر متاح الآن؟

الخلاصة السريعة

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

• يوثق Playwright صورا محفوظة للصفحة أو عنصر، مع فرق نطاق الصفحة الكاملة؛ لا نحول ملف الصورة إلى جلسة تفاعل حية. ^[1]
• في مثالنا يظهر زر حفظ وعبارة «تم الحفظ»؛ نقرأ العبارة الظاهرة ولا نعدها وحدها تحققًا من بقاء الملف المطلوب في النظام.
• راجع نسخة الواجهة والوقت والحالة الحالية قبل إرشاد يعتمد على زر؛ وجوده في لقطة قديمة لا يثبت موضعه أو توفره الآن.
• إذا غاب خيار عن جزء مصور فلا تقرر أنه غير موجود في البرنامج كله؛ افصل وصف الصورة عن فحص الإجراء ونتيجته، ولم ننفذ اختبارا.

ما نطاق الصورة التي وصلت؟

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

نفترض صورة محفوظة من محرر بطاقة نشاط فني. تظهر في الجزء المعروض مساحة العنوان وزر «حفظ» وعبارة «تم الحفظ». يمكن للمساعد وصف موضع الزر في هذه الصورة ونسخ العبارة، لكننا لم نقدم برنامجًا مفتوحا يستطيع القارئ أو كاتب المقال التفاعل معه.

ماذا تثبت رسالة النجاح في الصورة؟

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

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

هل مكان الزر ثابت في الحالة الحالية؟

لنفترض أن الصورة قديمة ثم تغير تخطيط المحرر أو أصبحت الجلسة خارج الحساب. التعليمات التي تقول «اضغط الزر هناك الآن» تحتاج مراجعة الواجهة الحالية وما يسمح به الحساب. لا نستنتج من لون زر في الصورة وحده أنه قابل للاستعمال في لحظة أخرى أو أن الضغط عليه سيؤدي إلى النتيجة نفسها.

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

ماذا يعني غياب الخيار من الإطار؟

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

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