منسّق JavaScript

ما الذي يغيّره المنسّق أو المضغّط في الكود؟

يغيّر المنسّق التخطيط — المسافات وفواصل الأسطر والمسافات البادئة — ليصبح HTML أو CSS أو JavaScript متسقاً في القراءة، وبعض المنسّقات يوحّد أيضاً تفاصيل تعدّها اللغة متكافئة، مثل حالة أحرف أسماء الوسوم في HTML أو علامات اقتباس السمات؛ والمضغّط يزيل ما لا يحتاجه المتصفح — التعليقات والمسافات والفواصل المنقوطة الاختيارية — وقد يعيد كتابة القيم بصيغ أقصر مكافئة مثل #fff بدلاً من #ffffff. لا يُقصد بأيٍّ منهما تغيير ما يفعله الكود، لكن راجع الفروق قبل اعتمادها: فالخيار الذي يعيد ترتيب الكود، مثل ترتيب خصائص CSS، قد يغيّر التصريح الذي يسري، وتحويل اسم الوسم إلى أحرف صغيرة يُفسد مكوّناً في إطار عمل يميّز حالة الأحرف مثل <MyComponent>.

كيفية استخدام منسّق JavaScript

1. الصق كود JavaScript أو TypeScript (يعمل مع الكود المصغّر أيضاً).
2. اختر المسافة البادئة وعدد الأسطر الفارغة التي تريد الاحتفاظ بها.
3. انسخ الكود المنسّق من لوحة الإخراج.

مزايا منسّق JavaScript

• إعادة تنسيق المسافات البادئة لكود JavaScript وTypeScript المصغّر أو غير المرتّب
• فهم السلاسل النصية والقوالب النصية ذات ${} المتداخلة وتعابير regex الحرفية والتعليقات
• توحيد التباعد حول العوامل والكلمات المفتاحية والأقواس والفواصل
• التعامل مع switch/case والدوال السهمية والأصناف (classes) والأنواع العامة (generics) والكائنات الحرفية
• الحفاظ على فواصل الأسطر ونمط الفواصل المنقوطة لديك (آمن مع ASI — لا يغيّر السلوك أبداً)
• الاحتفاظ بعدد محدد من الأسطر الفارغة كحدّ أقصى؛ وخيار وضع else/catch في سطر جديد

مثال على منسّق JavaScript

function sum(a,b){if(!a)return b;return a+b}

function sum(a, b) {
  if (!a) return b;
  return a + b
}

الأسئلة الشائعة حول منسّق JavaScript

ملاحظات تقنية

هذا منسّق للمسافات البيضاء وليس محلّلاً كاملاً: فهو لا يعيد كتابة الرموز أبداً، ولذلك فهو آمن مع الصياغات التي لا يفهمها تماماً (JSX، والمزخرفات، والمقترحات الأحدث). ولأن JavaScript تعتمد الإدراج التلقائي للفاصلة المنقوطة، تُحفظ فواصل الأسطر الموجودة ولا تُضاف فواصل جديدة إلا بعد ; و{ و}.

المراجع

• HTML Living StandardWHATWGلغة HTML، بما فيها مراجع المحارف المسماة (الكيانات) وقواعد التحليل التي تتبعها المتصفحات.
• ECMAScript® Language Specification (ECMA-262)Ecma International / TC39معيار لغة JavaScript، بما فيه قواعد RegExp ودلالاتها، وJSON.parse/JSON.stringify، وكائن Date.