درس مصغّر · العربية

كيف تجد الأخطاء في موقعك المنشور وتصلحها

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

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

لمن هذا الدرس؟

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

قبل أن تبدأ

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

الوقت المتوقع: 19–31 دقيقة

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

ما الذي ستتعلمه؟

  • أعد إنتاج إجراء معطل فعلًا بدل فحص تحميل الصفحة فقط.
  • شارك سياقًا آمنًا كافيًا لإصلاح محدد بواسطة المساعد.
  • تحقق من الإجراء المصحح وحالة المراقبة ذات الصلة.

ملفات ورشة العمل

الخطوة 1

جرّب إجراء الزائر

قد تفتح الصفحة بينما تكون ميزتها المفيدة معطلة.

اطلب من المساعد تشغيل مجلد public المرفق عبر HTTP وافتح الصفحة. فعّل Find contact section. تبحث نسخة practice-R1 المرفقة عمدًا عن هدف غير موجود، لذا تعرض الحالة فشل إجراء Contact.

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

مثال عملي

مثال وصف مفيد للمشكلة: «ضغطت Find contact section في practice-R1. توقعت فتح قسم Contact، لكن الحالة قالت Contact action failed».

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

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

اعثر على خطأ في موقع منشور وأصلحه

ابدأ بإجراء زائر فاشل، ثم استخدم تقريرًا لتحديد سببه.

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

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

مثال محلول

تُحمّل الصفحة الرئيسية نفسها بنجاح. يفشل النقر على «Find contact section» لأن السكربت يطلب #contact-missing بينما يحتوي HTML الفعلي على id=contact.

Extra implementation exercise

لماذا لا يكتشف فحص صفحة رئيسية بحالة HTTP 200 هذا الخطأ؟

عرض حل نموذجي مشروح

قد يُحمّل HTML بصورة صحيحة بينما يفشل إجراء JavaScript لاحق. كرر مهمة التواصل، لا طلب الصفحة فقط.

  • تختبر التفاعل المتأثر بعد تحميل الصفحة.
  • تميّز الإتاحة عن الصحة الوظيفية.

الخطوة 2

اجمع سياقًا مفيدًا وآمنًا فقط

قدّم للمساعد دليلًا دون بيانات زوار خاصة.

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

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

مثال عملي

الخطأ المسموح المرفق هو “Practice: missing contact target”. يمكن أن يتضمن الحدث المفيد الإصدار التدريبي وموضع المصدر، دون رسالة مستخدم حقيقية أو عنوان بريد أو رمز حساب.

Sentry: محمّل المتصفح والتهيئة المخصصة

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

أرسل تقرير تشخيص مضبوطًا

اجمع ما يكفي للبحث دون إرسال محتوى مستخدم خام.

اضبط رابط محمّل المشروع العام كما يشرح START-HERE.txt. يحدد السكربت رد نداء التهيئة قبل تحميل SDK، ويعطل التتبع وإعادة الجلسة، ويستخدم قائمة سماح beforeSend لهذا الخطأ التدريبي الثابت.

يستبعد الحدث التشخيصي المعاد بيانات الطلب والمستخدم والإضافات الاعتباطية ومسارات التتبع breadcrumbs. تُزال الاستعلامات وhash من أسماء ملفات المكدس. لموقع حقيقي، راجع كل مصدر لتشخيصات حساسة؛ لا تضمن sendDefaultPii=false وحدها خلو النص الحر أو الروابط من معلومات شخصية.

مرشح beforeSend صارم عمدًا: لا تُرسل إلا الرسالة المصطنعة المطابقة «Practice: missing contact target». تُسقط الرسائل الأخرى. إذا غيرت صياغة الخطأ التدريبي، فحدّث قائمة السماح عن قصد، وإلا فغياب الحدث متوقع. لا تزل المرشح لمجرد جعل اللوحة نشطة؛ افحص حمولة الحدث المسموح بحثًا عن بيانات غير مقصودة.

إذا لم يصل حدث، فافحص أولًا نص الرسالة الثابت وقائمة سماح beforeSend في app.js. يعرض الحدث غير المطابق الآن رسالة محلية عن تصفيته؛ ولا يُحسب مرسلًا. يستخدم محلل الروابط location.origin أساسًا لأسماء الملفات النسبية ويستبدل اسم ملف غير قابل للتحليل بـredacted بدل تمرير أصل قد يكون حساسًا.

يُضبط خيار المحمّل الموثق data-lazy="no" عبر script.dataset.lazy="no"؛ ويطلب تحميل SDK الكاملة مبكرًا. لا تحتفظ أسماء ملفات المكدس إلا بأصل HTTP(S) والمسار بعد إزالة الاستعلام/hash. تُحجب المخططات غير الويب بدل تمريرها دون تغيير.

مثال محلول

تكفي رسالة خطأ ثابتة مثل «Practice: missing contact target» لهذا التدريب. إرسال كائن نموذج كامل يضيف مخاطرة دون المساعدة في تحديد هدف DOM المفقود.

Sentry: محمّل المتصفح والتهيئة المخصصة

Extra implementation exercise

هل يجعل تعطيل البيانات الشخصية الافتراضية رسائل خطأ اعتباطية آمنة للإرسال تلقائيًا؟

عرض حل نموذجي مشروح

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

  • تدرك أن نص التطبيق وروابطه قد تظل تحتوي بيانات خاصة.
  • تطبّق حجبًا صريحًا وقائمة سماح.

الخطوة 3

نفّذ إصلاحًا واحدًا محددًا

كرّر الإجراء المعطل نفسه بعد التعديل.

اطلب من المساعد مقارنة وجهة الزر الفاشل بقسم Contact الموجود. يتضمن worked-solution/app.js المرفق إصلاح الهدف الصغير؛ فاطلب تطبيقه وتسمية المراجعة التدريبية المعدلة practice-R2.

افتح صفحة practice-R2 المعدلة وفعّل الزر نفسه مجددًا. ينبغي أن يصل إلى Contact ويعرض “Contact section opened.” تغيير تسمية الإصدار فقط أو وضع علامة الحل في Sentry لا يغير سلوك الزر.

مثال عملي

يبحث السكربت المعطل عن #contact-missing، بينما يعرّف HTML قسم Contact عند #contact. يستطيع المساعد إصلاح التطابق؛ وأنت تقيّم النتيجة باستخدام الزر مجددًا.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

طابق التقرير وأصلح السبب وأعد الاختبار

تسمية المشكلة محلولة لا تصلح الشيفرة.

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

استبدل السكربت بـworked-solution/app.js، وحدّث تسمية الإصدار وكرر إجراء التواصل. ينبغي أن يظهر الهدف الصحيح بالتمرير إليه. تعليم مشكلة على أنها محلولة في اللوحة لا يستبدل فحص السلوك هذا.

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

مثال محلول

يفشل R1 عند #contact-missing؛ ويستخدم R2 القيمة #contact. دليل التعافي المهم هو أن إجراء التواصل يعمل الآن في إصدار المصدر المصحح.

Extra implementation exercise

المشكلة معلّمة بأنها محلولة لكن السكربت المنشور لا يزال يستعلم عن #contact-missing. هل أُصلحت المشكلة؟

عرض حل نموذجي مشروح

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

  • تفحص المصدر المنشور الفعلي وإصداره.
  • تكرر الإجراء الذي فشل سابقًا.

الخطوة 4

أكمل ملاحظة حادث مفيدة

أبقِ المشكلة والإصلاح والتحقق مترابطة.

أكمل incident-record.txt بفشل الزر الأصلي وتصحيح الهدف الصغير ونتيجة تكرار الإجراء على الصفحة المعدلة. إذا نشرت التعديل التدريبي، فافحص النسخة المنشورة نفسها، لا الملف المحلي وحده.

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

مثال عملي

يربط سجل حادث مختصر فشل Contact في practice-R1 بتصحيح الهدف ونجاح إعادة الاختبار في practice-R2. عبارة «حُلّت المشكلة» وحدها تغفل نتيجة الزائر.

ملفات هذه الخطوة

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

مهمتك: اكتب ملاحظة حادث مفيدة

اجعل المحقق التالي يفهم السبب والأدلة معًا.

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

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

مثال محلول

«أُصلح محدد الهدف المفقود من #contact-missing إلى #contact؛ واجتاز R2 إعادة الاختبار» وصف عملي. «كان في Sentry خطأ؛ حُلّ» يترك السبب والتحقق مجهولين.

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

Extra implementation exercise

أنجز ملاحظة حادث وأثبت أن إجراء المستخدم المصحح يعمل.

عرض حل نموذجي مشروح

فعّل محمّل التدريب المعدّ وأطلق الخطأ المصطنع المطابق. إذا غيرت نص الخطأ، فحدّث قائمة السماح الصارمة عمدًا؛ إسقاط رسالة غير مسموح بها متوقع. افحص الحدث المستلم الفعلي من حيث الإصدار والإطار والبيانات غير المرغوبة.

طبّق السكربت المصحح المرفق على public/app.js، وغيّر RELEASE إلى practice-R2. انشر إصدار التدريب ذاك عبر سير العمل المراجَع، ثم كرر Find contact section على الرابط المنشور الفعلي. تغيير تسمية الإصدار أو حالة المشكلة وحدهما لا يصلح المحدد.

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

  • تربط العَرَض والإصدار وسبب المصدر.
  • تتحقق من السلوك وتفصل ادعاءات تسليم الحدث والإشعار.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.

واصل التعلّم

استكشف الدروس الأخرى