70- دروس جافا سكربت – JS Style Guide

# دليل الأنماط في JavaScript

يعد اتباع دليل الأنماط (Style Guide) في JavaScript أمرًا حيويًا لكتابة كود نظيف، قابل للقراءة، وسهل الصيانة. هناك العديد من أدلة الأنماط المشهورة مثل AirBnB وGoogle، ولكن يمكن أيضًا تخصيص دليل خاص بك أو بفريقك. سنستعرض هنا بعض المبادئ العامة والأساسية مع أمثلة توضيحية.

## 1. التعريفات والتسميات

### 1.1. استخدام التعريفات الصحيحة

استخدم `let` و`const` بدلاً من `var` لتعريف المتغيرات. `const` للثوابت و`let` للمتغيرات القابلة للتغيير.

const MAX_USERS = 100;
let userCount = 0;

### 1.2. تسمية المتغيرات [شركة برمجة مصرية] والدوال

استخدم أسماء وصفية للمتغيرات والدوال لتوضيح الغرض منها. استخدم camelCase للتسمية.

let userName = 'John Doe';
function calculateTotalPrice(price, tax) {
    return price + tax;
}

## 2. التنسيق والترتيب

### 2.1. المسافات والمسافات البادئة

استخدم مسافة بادئة من 2 مساحة (spaces) بدلاً من استخدام التاب.

function greet(name) {
  console.log(`Hello, ${name}!`);
}

### 2.2. طول السطر

حافظ على طول السطر أقل من 80-100 حرفًا لسهولة القراءة.

const userMessage = "This is a long message that should be split into multiple lines for better readability.";

## 3. الأسلوب في كتابة الشيفرة

### 3.1. الأقواس والمسافات

ضع مسافة قبل الأقواس المتعرجة وداخل الأقواس العادية.

if (isValid) {
  console.log('Valid!');
}

### 3.2. الأقواس في الدوال

حتى لو كانت الدالة تتكون من سطر واحد، دائماً [شركة برمجة مصرية] استخدم الأقواس المتعرجة.

const add = (a, b) => {
  return a + b;
};

## 4. التعليقات

استخدم التعليقات لتوضيح أجزاء الكود المعقدة، وليس لشرح كل سطر. التعليقات يمكن أن تكون أحادية أو متعددة الأسطر.

// حساب مجموع الأعداد
function sum(a, b) {
  return a + b; // إرجاع النتيجة
}

/*
 * هذه دالة لعرض رسالة تحية للمستخدم
 */
function greetUser(userName) {
  console.log(`Hello, ${userName}!`);
}

## 5. التعامل مع الأخطاء

### 5.1. استخدام try/catch

استخدم `try/catch` للتعامل مع الأخطاء غير المتوقعة.

try {
  JSON.parse("Invalid JSON string");
} catch (error) {
  console.error("Parsing error:", error);
}

## 6. الممارسات الجيدة

### 6.1. استخدام strict mode

تفعيل “strict mode” يساعد في كتابة كود أكثر أمانًا عن طريق فرض قواعد صارمة.

"use strict";
function myFunction() {
  // الكود هنا سيخضع لقواعد strict mode
}

### 6.2. تجنب استخدام الكود غير المستخدم

حافظ على نظافة الكود عن طريق إزالة المتغيرات والدوال غير المستخدمة.

let activeUsers = 0; // متغير مستخدم
// let unusedVariable = 42; // متغير غير مستخدم

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