قراءة رسالة الخطأ
لست مضطرًا إلى فهمها
رسالة الخطأ (Error message) ليست مكتوبة لك، ولست بحاجة إلى فهمها حتى تكون مفيدة. المطلوب أن تنقلها بدقة وتمرّرها. هذه هي المهارة كلها، وهي كافية. معظم الرسائل تحتوي على ثلاثة أشياء تستحق الملاحظة: جملة قصيرة تقول ما الخطأ، واسم ملف ورقم سطر يقولان أين، وقائمة طويلة في الأسفل تُظهر سلسلة الخطوات التي أوصلت إلى هناك. السطر العلوي هو عادةً المفيد؛ أما القائمة الطويلة فمعظمها ضجيج بالنسبة إليك. اقرأ «cannot read property name of undefined» وفكّر: «شيء ما كان يتوقّع وجود شيء لم يكن موجودًا». هذا مستوى فهم محترم تمامًا لما تفعله.
- النقل الدقيق أهم من الفهم العميق — تحتاج النص، لا النظرية
- السطر العلوي يقول ماذا، واسم الملف ورقم السطر يقولان أين
- القائمة الطويلة في الأسفل هي المسار الذي سلكه، ومعظمها ضجيج بالنسبة إليك
- إحساس تقريبي بشكل الخطأ يكفي لتتصرّف
انسخ الرسالة كاملة
الصق الرسالة كلها، لا ملخصًا عنها. إعادة كتابتها بعبارة مثل «تقول شيئًا عن undefined» تُضيّع اسم الملف ورقم السطر والصياغة الدقيقة، وهي بالضبط الأجزاء التي تحوّل التخمين إلى إصلاح موجّه. حدّدها، وانسخها، والصقها. لقطة الشاشة تكفي إن لم تستطع تحديد النص، لكن النص القابل للتحديد أفضل لأنه قابل للبحث. وأضف الأسطر التي فوق الجزء الذي يبدو مهمًا والتي تحته؛ فالتفصيل المهم يكون غالبًا خارج الجزء الذي لفت نظرك مباشرة. هذه العادة الواحدة — الصق كل شيء — توفّر على الأرجح وقتًا أكثر من أي شيء آخر في هذه الوحدة، ولا تتطلّب أي فهم على الإطلاق.
- الصق الرسالة كاملة بما فيها أسماء الملفات وأرقام الأسطر
- لا تعِد صياغة رسالة الخطأ أبدًا؛ الصياغة الدقيقة هي الجزء المفيد
- خذ بضعة أسطر قبل الجزء الذي يبدو مهمًا وبعده
- النص القابل للتحديد أفضل من لقطة الشاشة لأنه قابل للبحث
أين تختبئ الرسائل
أحيانًا لا يظهر شيء على الشاشة، والصفحة ببساطة لا تعمل. لكن الرسالة غالبًا موجودة، في مكان لم تنظر إليه بعد. تحتفظ المتصفحات بلوحة مخفية، تُسمّى غالبًا أدوات المطوّر أو وحدة التحكم (Console)، تسجّل الأخطاء التي تحدث في الصفحة. فتحها مجرد خيار في القائمة، لا عمل تقني. والأدوات التي تشغّل الكود تحتوي على سجل أو منطقة مخرجات تُظهر ما حدث أثناء التشغيل. ومنصّات البناء المستضافة تحتفظ بسجلات البناء وسجلات التشغيل. تعرّف إلى أماكنها في الأداة التي تستخدمها، وابحث عنها مبكرًا، حين لا يكون هناك حريق. «لم يحدث شيء» بلاغ أضعف بكثير من سطرين من النص الأحمر في لوحة لم تكن تعرف بوجودها.
- المتصفحات تحتفظ بلوحة Console تسجّل أخطاء لا تظهر على الصفحة
- المحرّرات ومنصّات البناء تحتفظ بسجلات لما حدث أثناء التشغيل
- اعثر على هذه الأماكن مرة واحدة، مبكرًا، حين لا يكون هناك حريق
- «لم يحدث شيء» تعني غالبًا «لم أجد الرسالة بعد»
بعض الأخطاء ليست أخطاء
ليس كل ما هو أحمر مشكلة. لوحات Console مليئة بالتحذيرات والتنبيهات والشكاوى من أجزاء لا علاقة لها بمشكلتك: أيقونة مفقودة، أو إعداد قديم، أو شيء من إعلان أو إضافة في المتصفح. هذه تبقى هناك دائمًا ولا علاقة لها بمشكلتك. الانضباط المفيد هنا هو التوقيت: أعِد إحداث المشكلة وأنت تراقب، وانتبه لما يظهر في تلك اللحظة. كل ما كان موجودًا قبل أن تضغط هو ضجيج في الخلفية. هذا التمييز وحده يوفّر جهدًا ضائعًا كثيرًا. فبدونه ستطارد تحذيرات موجودة بلا ضرر منذ يوم إنشاء المشروع، وستبقى موجودة حين يعمل كل شيء.
- التحذيرات ليست أعطالًا؛ كثير منها دائم وغير ضار
- امسح اللوحة، وأعِد إحداث المشكلة، واقرأ ما يظهر في تلك اللحظة
- الرسائل الموجودة قبل أن تتصرّف هي ضجيج في الخلفية
- مطاردة التحذيرات القديمة مضيعة وقت كلاسيكية للمبتدئين