JavaScript: الأخطاء والتصحيح في JavaScript

آخر تحديث: 2026-10-13

كتابة كود خالٍ من الأخطاء مستحيل — حتى مبتكر JavaScript أنتج خطأ typeof null === "object" في 10 أيام فقط. لذا تعلم العثور على الأخطاء ومعالجتها أهم من تعلم كتابة الكود.

دوال BOM ذات صلة：console.error() console.table() console.log() try...catch JSON.parse finally return error catch

1. معالجة الأخطاء والتصحيح

SyntaxError يُ catch قبل تنفيذ الكود (مرحلة التحليل). الأخطاء الأخرى هي أخطاء وقت التشغيل.

(2) try...catch...finally

استخدم try...catch ل catch أخطاء الوقت التشغيل ومنع تعطل برنامجك:

<script>
try {
  const data = JSON.parse('{bad json}');
} catch (error) {
  console.log("فشل التحليل:", error.message);
} finally {
  console.log("عملية التنظيف");
}
</script>

كائن error في catch لديه خاصيتان مستخدمتان بشكل شائع:

• error.message — وصف الخطأ
• error.name — اسم نوع الخطأ

(3) throw — إلقاء الأخطاء يدوياً

try...catch يمكنه فقط catch أخطاء الوقت التشغيل، لكن أخطاء المنطق التجاري تحتاج إلى إلقائها يدوياً:

<script>
function setAge(age) {
  if (typeof age !== "number" || age < 0) {
    throw new Error("العمر يجب أن يكون رقماً موجباً");
  }
  console.log("تم تعيين العمر إلى: " + age);
}

try {
  setAge(-5);
} catch (e) {
  console.log(e.message);
}
</script>

throw يمكن أن تلقي أي قيمة، لكن يُنصح باستخدام new Error() أو فرعياتها — تتضمن معلومات تتبع المكدس.

(4) رسائل الأخطاء المخصصة

استخدم فرعيات Error أو خصائص مخصصة لتوفير معلومات أكثر ثراءً عن الأخطاء:

<script>
class ValidationError extends Error {
  constructor(field, message) {
    super(message);
    this.name = "ValidationError";
    this.field = field;
  }
}

try {
  throw new ValidationError("email", "تنسيق بريد إلكتروني غير صالح");
} catch (e) {
  console.log(e.name + " [" + e.field + "]: " + e.message);
}
</script>

(5) أدوات المتصفح (F12)

تصحيح نقاط التوقف هو أقوى تقنية تصحيح: انقر على رقم السطر في لوحة Sources لتعيين نقطة توقف، حدث الصفحة، يتوقف الكود عند تلك النقطة — تنفيذ سطر بسطر، فحص المتغيرات، وفحص مكدس الاتصال.

(6) عائلة console

console.table مفيد بشكل خاص لعرض مصفوفات الكائنات — أكثر قابلية للقراءة من log.

(7) نصائح التحيح

• تعليق النصف: علّق نصف الكود، انظر أي نصف فيه المشكلة، وضيقها خطوة بخطوة
• console.log في كل مكان: اطبع قيم المتغيرات في النقاط المهمة — بدائي لكن فعال
• تصحيح نقاط التوقف: أقوى من console.log — أوقف التنفيذ وعدّل المتغيرات في الوقت الفعلي
• تصحيح البطة المطاطية: اشرح الكود سطر بسطر لبطة مطاطية (أو زميل). غالباً، ستجد الخطأ في منتصف الشرح.

▶ مثال: try/catch لتحليل JSON

▶ مثال: أخطاء مخصصة والتحقق من النماذج

▶ مثال: مرجع سريع لأنواع الأخطاء وطرق console

دوال BOM ذات صلة：console.error() console.table() console.log() try...catch JSON.parse finally return error catch

❓ أسئلة شائعة

📖 ملخص

• try/catch يلتقط أخطاء وقت التشغيل؛ finally يُنفذ دائماً، مثالي للتنظيف
• throw يرفع الأخطاء يدوياً — الأفضل استخدام throw new Error("رسالة")
• كائنات Error لها خصائص name و message؛ وحدة التحكم تظهر تتبع المكدس الكامل
• أدوات المطور (F12): لوحة Sources لنقاط التوقف، Watch للمتغيرات، التنفيذ خطوة بخطوة
• دوال وحدة التحكم: log/warn/error/table/group/time/timeEnd تعزز كفاءة التصحيح

📝 تمارين

1. اكتب دالة safeDivide(a, b) تستخدم try...catch لمعالجة القسمة على صفر (تلميح: القسمة على صفر في JS لا تلقي خطأ — تحتاج للتحقق والإلقاء بنفسك). تُرجع النتيجة أو رسالة خطأ.
2. اكتب دالة safeJSONParse(str) تحلل سلسلة JSON. عند الفشل، تُرجع { success: false, error: <رسالة الخطأ> }. عند النجاح، تُرجع { success: true, data: <نتيجة التحليل> }.
3. اكتب دالة retry(fn, times): نفّذ fn، وإذا ألقت خطأ، أعد المحاولة حتى times مرات. إذا فشلت جميع المحاولات، اطرح الخطأ الأخير. نفّذ باستخدام try...catch.

فريق Web-Tutorial التقني

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

من نحن