كيفية الإبلاغ عن خطأ جيد في المتصفِّح

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

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

التحقّق من أنّها خطأ برمجي

الخطوة الأولى هي تحديد السلوك "الصحيح" الذي يجب اتّباعه.

ما هو السلوك الصحيح؟

اطّلِع على مستندات واجهة برمجة التطبيقات ذات الصلة على MDN أو حاوِل العثور على المواصفات ذات الصلة. يمكن أن تساعدك هذه المعلومات في تحديد واجهة برمجة التطبيقات المعطّلة ومكان العطل والسلوك المتوقّع.

هل يعمل في متصفّح آخر؟

يتم عادةً إعطاء الأولوية للسلوك الذي يختلف بين المتصفّحات باعتباره مشكلة في إمكانية التشغيل التفاعلي، خاصةً عندما يكون المتصفّح الذي يحتوي على الخطأ هو المتصفّح الوحيد الذي يختلف عن غيره. حاوِل إجراء الاختبار على أحدث إصدارات Chrome وFirefox وSafari وEdge، ويمكنك استخدام أداة مثل BrowserStack.

إذا أمكن، تأكَّد من أنّ الصفحة لا تتصرف بشكل مختلف عن قصد بسبب استنشاق وكيل المستخدم. في "أدوات مطوّري البرامج في Chrome"، جرِّب ضبط سلسلة User-Agent على متصفّح آخر.

هل حدثت المشكلة في إصدار حديث؟

هل كان هذا يعمل على النحو المتوقّع في السابق، ولكنّه توقّف عن العمل في إصدار متصفّح حديث؟ يمكن التعامل مع هذه المشاكل بشكل أسرع، خاصةً إذا قدّمت رقم إصدار كان يعمل بشكل صحيح ورقم إصدار آخر حدثت فيه المشكلة. يمكنك استخدام أدوات مثل BrowserStack للتحقّق من إصدارات المتصفّحات القديمة. استخدِم أدوات مثل bisect-builds tool (لـ Chromium) للبحث عن التغيير.

إذا كانت المشكلة عبارة عن تراجع ويمكن إعادة إنتاجها، فيمكن عادةً العثور على السبب الأساسي وحلّه بسرعة.

هل يواجه الآخرون المشكلة نفسها؟

إذا كنت تواجه مشاكل، من المرجّح أن يواجهها مطوّرون آخرون أيضًا. أولاً، حاوِل البحث عن الخطأ على Stack Overflow. قد يساعدك ذلك في ترجمة مشكلة مجرّدة إلى واجهة برمجة تطبيقات معطّلة محدّدة، وقد يساعدك في العثور على حلّ بديل قصير المدى إلى أن يتم إصلاح الخطأ.

هل سبق أن تم الإبلاغ عنه؟

بعد تحديد الخطأ، عليك التحقّق مما إذا تم الإبلاغ عنه من خلال البحث في قاعدة بيانات أخطاء المتصفّح.

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

إذا قررت التعليق على الخطأ، يمكنك تضمين معلومات حول كيفية تأثير الخطأ على موقعك الإلكتروني. تجنَّب إضافة تعليقات بأسلوب "+1"، لأنّ أدوات تتبُّع الأخطاء ترسل عادةً رسائل إلكترونية لكل تعليق.

الإبلاغ عن الخطأ

إذا لم يتم الإبلاغ عن الخطأ من قبل، فقد حان الوقت لإخبار بائع المتصفح عن ذلك.

إنشاء إطار اختبار مصغّر

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

في ما يلي بعض النصائح لتقليل إطار الاختبار:

  • نزِّل صفحة الويب وأضِف <base href="https://original.url"> وتأكَّد من أنّ الخطأ موجود على جهازك. قد يتطلّب ذلك خادم HTTPS مباشرًا إذا كان عنوان URL يستخدم HTTPS.
  • اختبِر الملفات المحلية على أحدث إصدارات أكبر عدد ممكن من المتصفحات.
  • حاوِل دمج كل شيء في ملف واحد.
  • أزِل الرموز البرمجية (بدءًا من الرموز التي تعرف أنّها غير ضرورية) إلى أن يختفي الخطأ.
  • استخدم التحكم في الإصدار حتى تتمكن من حفظ عملك والتراجع عن الأشياء التي تسير بشكل خاطئ.

استضافة إطار اختبار مصغّر

إذا كنت تبحث عن مكان جيد لاستضافة إطار الاختبار المصغّر، هناك العديد من الأماكن الجيدة المتاحة:

يُرجى العِلم أنّ العديد من هذه المواقع الإلكترونية تعرض المحتوى في إطار iframe، ما قد يؤدي إلى اختلاف سلوك الميزات أو الأخطاء.

الإبلاغ عن مشكلتك

بعد الحصول على إطار الاختبار المصغّر، ستكون جاهزًا للإبلاغ عن هذا الخطأ. انتقِل إلى الموقع الإلكتروني المناسب لتتبُّع الأخطاء، وأنشئ مشكلة جديدة.

إضافة أوصاف وخطوات واضحة لتكرار المشكلة

أولاً، قدِّم وصفًا واضحًا لمساعدة المهندسين في فهم المشكلة بسرعة والمساعدة في تحديد أولوياتها.

When installing a PWA using the `beforeinstallprompt.prompt()`, the
`appinstalled` event fires before the call to `prompt()` resolves.

بعد ذلك، قدِّم الخطوات التفصيلية المطلوبة لإعادة إنتاج المشكلة وصِف النتيجة المتوقعة والفعلية.

What is the expected result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)
2. INSTALL: Success (logged when `appinstalled` event fired)

What is the actual result? In the console:
0. INSTALL: Available (logged when `beforeinstallprompt` event fired)
1. INSTALL: Success (logged when `appinstalled` event fired)
2. INSTALL_PROMPT_RESPONSE: {outcome: "accepted", platform: "web"}
   (logged when beforeinstallprompt.prompt()` resolves)

لمزيد من المعلومات، يمكنك الاطّلاع على إرشادات كتابة تقارير الأخطاء على شبكة مطوّري برامج Mozilla‏ (MDN).

مكافأة: إضافة لقطة شاشة أو تسجيل رقمي للشاشة يوضّح المشكلة

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

تضمين تفاصيل البيئة

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

إرسال الخطأ

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