
درس مصغّر · العربية
كيف تجد الأخطاء في موقعك المنشور وتصلحها
أعد إنتاج إجراء زائر معطل في المثال المرفق، واطلب من المساعد إصلاحًا محددًا، وتحقق من الإجراء نفسه بعد التعديل.
لمن هذا الدرس؟
لمن يريد اكتشاف الأعطال التي يواجهها الزوار وإصلاحها. ستستخدم صفحة معطلة مرفقة؛ يستطيع مساعد البرمجة تعديل الكود بينما تصف المشكلة وتكرر إجراء الزائر.
قبل أن تبدأ
تحتاج إلى موقع التدريب المنفصل المرفق ومساعد برمجة. مشروع Sentry تجريبي اختياري لجزء المراقبة؛ أرسل الأخطاء الوهمية المرفقة فقط، ولا تستخدم بيانات زوار خاصة.
الوقت المتوقع: 19–31 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. إعداد مزوّد المراقبة وانتظار استلام الأحداث وقت إضافي. استدعاء التقاط محلي ليس دليلًا على استلام تنبيه.
ما الذي ستتعلمه؟
- أعد إنتاج إجراء معطل فعلًا بدل فحص تحميل الصفحة فقط.
- شارك سياقًا آمنًا كافيًا لإصلاح محدد بواسطة المساعد.
- تحقق من الإجراء المصحح وحالة المراقبة ذات الصلة.
الخطوة 1
جرّب إجراء الزائر
قد تفتح الصفحة بينما تكون ميزتها المفيدة معطلة.
اطلب من المساعد تشغيل مجلد public المرفق عبر HTTP وافتح الصفحة. فعّل Find contact section. تبحث نسخة practice-R1 المرفقة عمدًا عن هدف غير موجود، لذا تعرض الحالة فشل إجراء Contact.
أخبر المساعد بالزر المحدد والوجهة المتوقعة والنتيجة الظاهرة. قد يوجد قسم Contact في الصفحة بينما يفشل الزر في الوصول إليه؛ ولن يكشف تحميل الصفحة الرئيسية وحده هذه المشكلة.
مثال عملي
مثال وصف مفيد للمشكلة: «ضغطت Find contact section في practice-R1. توقعت فتح قسم Contact، لكن الحالة قالت Contact action failed».
استخدم مثال إجراء التواصل المعطل المرفق في موقع تدريب منفصل. أعد إنتاج عطل الزر وحدّد سببًا واضحًا وعدّل الضروري فقط. ساعدني في تكرار الإجراء نفسه والمقارنة قبل التعديل وبعده. إن فُعّلت المراقبة، فاستخدم أخطاء وهمية ومشروعي التجريبي فقط، ولا ترسل بيانات صفحة أو نموذج خاصة. لا تعتبر المشكلة أُصلحت لمجرد وسمها محلولة.ملفات هذه الخطوة
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 لاحق. كرر مهمة التواصل، لا طلب الصفحة فقط.
- تختبر التفاعل المتأثر بعد تحميل الصفحة.
- تميّز الإتاحة عن الصحة الوظيفية.
خطأ شائع
إعلان سلامة ميزة JavaScript لأن الخادم يقدم HTML الخاص بها.
الخطوة 2
اجمع سياقًا مفيدًا وآمنًا فقط
قدّم للمساعد دليلًا دون بيانات زوار خاصة.
أعط المساعد ملفات التدريب ونسخة الصفحة ووصف المشكلة من الخطوة السابقة. يكفي ذلك لبدء فحص هذا المثال المحلي، دون إرسال نص نموذج أو معلومات حساب لأي زائر حقيقي.
إذا استخدمت مشروع Sentry الاختياري، فاضبط قيمة أداة التحميل العامة فقط وفعّل المراقبة التدريبية قبل إعادة إنتاج الخطأ المنضبط. افحص الحدث التدريبي المطابق وبياناته. ظهور حدث في Sentry منفصل عن وصول تنبيه إلى البريد.
مثال عملي
الخطأ المسموح المرفق هو “Practice: missing contact target”. يمكن أن يتضمن الحدث المفيد الإصدار التدريبي وموضع المصدر، دون رسالة مستخدم حقيقية أو عنوان بريد أو رمز حساب.
Sentry: محمّل المتصفح والتهيئة المخصصة
جرّب بنفسك
ما السياق الذي ستشاركه؟ وما البيانات الخاصة التي ستستبعدها؟
عرض حل نموذجي مشروح
سأشارك ملفات practice-R1 المرفقة وإجراء Find contact section ورسالة فشله. بعد تفعيل المراقبة، سأبحث عن “Practice: missing contact target” والإصدار المطابق في مشروعي التجريبي. سأستبعد عناوين الزوار ونصوص النماذج ورموز الحسابات؛ ويبقى التنبيه البريدي اختبارًا منفصلًا.
- يشارك الإجراء الافتراضي القابل لإعادة الإنتاج والإصدار التدريبي وسياق الملفات ذات الصلة.
- يستبعد محتوى الزوار الحقيقي ويميز أحداث المراقبة المستلمة عن التنبيهات التي وصلت.
ملفات هذه الخطوة
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. يستطيع المساعد إصلاح التطابق؛ وأنت تقيّم النتيجة باستخدام الزر مجددًا.
جرّب بنفسك
ما الذي تغير؟ وماذا حدث عندما كررت الإجراء الأصلي؟
عرض حل نموذجي مشروح
في الحل المرفق، يغير المساعد البحث من الهدف المفقود إلى قسم #contact الموجود، ويسمي المراجعة practice-R2. الاختبار المتوقع هو وصول الزر نفسه إلى Contact وعرض “Contact section opened.” علامة حل في نظام المراقبة دون إعادة ذلك الاختبار لا تثبت الإصلاح.
- يربط إصلاح الوجهة المحدود بقسم Contact الموجود.
- يكرر الإجراء نفسه على النسخة المعدلة ويفحص النتيجة الظاهرة للمستخدم.
ملفات هذه الخطوة
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. عبارة «حُلّت المشكلة» وحدها تغفل نتيجة الزائر.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم سجل الحادث واختبار الإجراء المصحح الفعلي.
ما المطلوب إنجازه سجل حادث قصير يتضمن المشكلة التي أُعيد إنتاجها والتعديل المحدد وإعادة الاختبار الناجحة الفعلية.
عرض حل نموذجي مشروح
مثال سجل حادث: أبلغ زر Contact في practice-R1 عن فشل؛ وصحح المساعد الهدف المفقود؛ وفي practice-R2 وصل الزر نفسه إلى Contact وأظهر رسالة النجاح. فُحص الحدث الافتراضي بصورة مستقلة في مشروع المراقبة التجريبي. لم تُعد قاعدة تنبيه، لذا لم يُختبر وصول الإشعارات. يغطي هذا السجل عيب Contact، لا كل خطأ مستقبلي في الموقع.
- يربط العرض الأصلي للمشكلة والتعديل المحدد وإعادة اختبار الإجراء نفسه فعلًا بالنسخة المعينة.
- يفصل ملاحظات حدث المزود وتنبيهه، ويحدد أي نطاق ما زال دون اختبار.
ملفات هذه الخطوة
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 على الرابط المنشور الفعلي. تغيير تسمية الإصدار أو حالة المشكلة وحدهما لا يصلح المحدد.
سجّل استلام المشكلة منفصلًا عن تسليم إشعار التنبيه. قد يظهر الحدث قبل وصول تنبيه معدّ؛ أبقِ أيًا من الملاحظتين معلقة حتى فحصها. تربط ملاحظة الحادث المرجعية الفشل والإطار وتغيير المحدد وإعادة الاختبار الظاهرة للمستخدم.
- تربط العَرَض والإصدار وسبب المصدر.
- تتحقق من السلوك وتفصل ادعاءات تسليم الحدث والإشعار.
خطأ شائع
افتراض أن لوحة مراقبة فارغة تثبت عدم رؤية المستخدمين أخطاء.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها