التسمية وقابلية القراءة والمشكلات الشائعة

مقدمة

تجربة التسمية الواضحة

// Use descriptive names
// Avoid single letters or vague words
const itemCount = 3;
const unitPrice = 5;

const totalPrice = itemCount * unitPrice;

console.log("Items:", itemCount);
console.log("Unit price:", unitPrice);
console.log("Total price:", totalPrice);

إرشادات التسمية

لا أرقام سحرية

// Replace magic numbers with named constants
const TAX_RATE = 0.08;
const SUBTOTAL = 20;

const tax = SUBTOTAL * TAX_RATE;
const finalTotal = SUBTOTAL + tax;

console.log("Tax:", tax);
console.log("Final total:", finalTotal);

تجربة حجب الأسماء

// Shadowing: inner variable hides an outer one
let score = 10;

function addBonus() {
  // The next line creates a new "score" only inside this function
  let score = 5;
  console.log("Inner score:", score);
}

addBonus();
console.log("Outer score:", score);

قائمة التحقق من سهولة القراءة

اختبار أفضل ممارسات التسمية

مراجعة