دليل الأسلوب وأفضل الممارسات

لماذا دليل أسلوب؟

الكود يُقرأ أكثر مما يُكتب. كود نظيف ومتّسق أسهل في الفهم والصيانة والعمل الجماعي. هذه قواعد المحترفين.

1) استخدم const و let — لا var

const PI = 3.14;      // لا يتغيّر → const (الافتراضي)
let count = 0;         // يتغيّر → let
// تجنّب var (سلوك نطاق قديم مربك)

🔑 ابدأ بـ const دائمًا، وحوّل إلى let فقط إن احتجت إعادة الإسناد.

2) أسماء واضحة وذات معنى

let d = 86400;                    // ❌ غامض
const secondsPerDay = 86400;      // ✅ واضح

function calc() {}                // ❌
function calculateTotal() {}      // ✅

اصطلاحات: camelCase للمتغيّرات والدوال، PascalCase للأصناف، UPPER_CASE للثوابت.

3) دوال صغيرة تؤدّي مهمة واحدة

// ❌ دالة تفعل كل شيء
// ✅ دوال صغيرة واضحة، كل واحدة لها غرض واحد

4) استخدم === دائمًا

if (x === 5) {}   // ✅ يقارن النوع والقيمة
// تجنّب == (تحويل تلقائي خادع)

5) فضّل الدوال التحويلية على الحلقات

// بدل حلقة for لمعالجة مصفوفة:
const doubled = numbers.map(n => n * 2);
const adults = users.filter(u => u.age >= 18);

6) عالج الأخطاء ولا تتجاهلها

try {
  await riskyOperation();
} catch (e) {
  console.error("فشل:", e.message);   // لا تتركه فارغًا
}

7) تجنّب التلوّث العام

استخدم الوحدات (import/export) ونطاقات الدوال بدل متغيّرات عامة كثيرة.

8) علّق على "لماذا" لا "ماذا"

// ❌ // نزيد العدّاد
count++;

// ✅ // نتخطّى العنصر الأول لأنه عنوان الجدول

أخطاء شائعة يجب تجنّبها

• استخدام var بدل const/let.
• == بدل ===.
• دوال ضخمة تفعل أشياء كثيرة.
• تجاهل الأخطاء بـ catch فارغ.
• أسماء غامضة (x, temp, data2).

خلاصة

اكتب JavaScript نظيفًا: const/let (لا var)، أسماء واضحة، دوال صغيرة، === دائمًا، دوال تحويلية، معالجة أخطاء، وتعليقات هادفة. الكود النظيف استثمار في مستقبلك وفريقك.