استخدِم نقاط التوقف لإيقاف رمز JavaScript مؤقتًا. يشرح هذا الدليل كل نوع من نقاط التوقف المتاحة في "أدوات المطوّر"، بالإضافة إلى حالات استخدام كل نوع وكيفية ضبطه. للحصول على برنامج تعليمي تفاعلي حول عملية تصحيح الأخطاء، يُرجى الاطّلاع على البدء بتصحيح أخطاء JavaScript في "أدوات مطوّري البرامج في Chrome".
نظرة عامة على حالات استخدام كل نوع من نقاط التوقف
النوع الأكثر شهرة من نقاط الإيقاف هو سطر الرمز البرمجي. ولكن قد يكون من الصعب ضبط نقاط التوقف لخطوط الرموز البرمجية، خاصةً إذا كنت لا تعرف بالضبط المكان الذي يجب البحث فيه، أو إذا كنت تعمل مع codebase كبير. يمكنك توفير الوقت أثناء تصحيح الأخطاء من خلال معرفة كيفية استخدام الأنواع الأخرى من نقاط التوقف ومتى يتم استخدامها.
| نوع نقطة الإيقاف | استخدِم هذا الخيار عندما تريد إجراء ما يلي: |
|---|---|
| سطر الرمز البرمجي | يمكنك إيقاف الفيديو مؤقتًا عند منطقة معيّنة من الرمز. |
| سطر الرمز البرمجي الشَرطي | إيقاف مؤقت في منطقة محدّدة من الرمز، ولكن فقط عندما يكون شرط آخر صحيحًا |
| Logpoint | سجِّل رسالة في وحدة التحكّم بدون إيقاف التنفيذ مؤقتًا. |
| DOM | تُوقِف مؤقتًا تنفيذ الرمز الذي يغيِّر عقدة DOM معيّنة أو يزيل العقد التابعة لها. |
| XHR | يمكنك إيقاف الإجراء مؤقتًا عندما يحتوي عنوان URL الخاص بطلب XHR على نمط سلسلة. |
| أداة معالجة الحدث | يمكنك إيقاف الرمز مؤقتًا الذي يتم تشغيله بعد تنشيط حدث، مثل click. |
| الاستثناء | يمكنك إيقاف الفحص مؤقتًا عند سطر الرمز البرمجي الذي يُظهر استثناءً تم رصده أو لم يتم رصده. |
| الوظيفة | يمكنك إيقاف البث مؤقتًا عند استدعاء دالة معيّنة. |
| النوع الموثوق به | الإيقاف المؤقت عند حدوث انتهاكات Trusted Type |
نقاط الإيقاف في سطر الرمز البرمجي
استخدِم نقطة توقّف لسطر رمز عندما تعرف المنطقة الدقيقة من الرمز التي تحتاج إلى التحقيق فيها. تتوقف أدوات المطوّرين دائمًا قبل تنفيذ سطر الرمز البرمجي هذا.
لضبط نقطة توقّف لخط رمز في "أدوات مطوّري البرامج":
- انقر على لوحة المصادر.
- افتح الملف الذي يحتوي على سطر الرمز البرمجي الذي تريد التوقف عنده.
- انتقِل إلى سطر الرمز البرمجي.
- على يسار سطر الرمز البرمجي، يظهر عمود رقم السطر. انقر عليه. يظهر رمز أزرق في أعلى عمود رقم السطر.
يعرض هذا المثال نقطة توقّف لسطر رمز تم ضبطها على السطر 29.
نقاط التوقف لخطوط الرموز البرمجية في الرمز
اتصل بالرقم debugger من الرمز لإيقاف الترجمة مؤقتًا في ذلك السطر. ويعادل ذلك نقطة انقطاع في سطر من التعليمات البرمجية، باستثناء أنّ نقطة التوقف يتم ضبطها في الرمز البرمجي، وليس في واجهة مستخدم أدوات المطوّرين.
console.log('a');
console.log('b');
debugger;
console.log('c');
نقاط الإيقاف المشروطة لخطوط الرموز البرمجية
استخدِم نقطة توقّف مشروطة لسطر رمز برمجي عندما تريد إيقاف التنفيذ ولكن فقط عندما يكون بعض الشروط صحيحًا.
تكون نقاط التوقف هذه مفيدة عندما تريد تخطّي الفواصل غير ذات الصلة بحالتك، خاصةً في حلقة.
لضبط نقطة إيقاف مشروطة لسطر رمز:
- افتح لوحة المصادر.
- افتح الملف الذي يحتوي على سطر الرمز البرمجي الذي تريد التوقف عنده.
- انتقِل إلى سطر الرمز البرمجي.
- على يسار سطر الرمز البرمجي، يظهر عمود رقم السطر. انقر بزر الماوس الأيمن عليه.
- انقر على إضافة نقطة إيقاف مشروطة. يظهر مربّع حوار أسفل سطر التعليمة البرمجية.
- أدخِل حالتك في مربّع الحوار.
- اضغط على مفتاح Enter لتفعيل نقطة التوقف. يظهر رمز برتقالي مع علامة استفهام في أعلى عمود رقم السطر.
