مُنسِّق JavaScript

Prettier ليس مجرد الإلهام لإخراج تنسيق هذه الأداة — إنه حزمة Prettier نفسها، مُنزَّلة ومُشغَّلة في متصفحك بدلًا من عبر Node على خادم، لذا النتيجة مطابقة بايت لبايت لما سينتجه تشغيل `npx prettier` محليًا بنفس التكوين. ذلك التمييز مهم لأن تنسيق JavaScript صعب حقًا تقريبه: فعله بشكل صحيح يتطلب تحليل اللغة بالكامل، لا مطابقة أنماط، ومُنسِّق يُقارب فقط سلوك Prettier سيختلف عن تكوين Prettier الفعلي لمشروع بالضبط في الحالات الحدّية التي تهم — داخل مُزخرِف، نوع عام معقد، أو تعبير JSX غير عادي.

يحتوي JavaScript عدة تراكيب تجعل نهج عد الأقواس والفاصلات المنقوطة البسيط يفشل مباشرة. يمكن أن تحتوي القوالب النصية نصًا عشوائيًا بين علامات التنصيص الخلفية، بما في ذلك أحرف تبدو بالضبط ككود — `` `function() { return "not real code"; }` `` قيمة سلسلة واحدة، لا ثلاث جمل، ومُنسِّق لا يتتبع حدود القوالب النصية سيُسيء تفسيرها. تعبيرات نمطية حرفية أسوأ: `/{}/` يحتوي أحرفًا تبدو كأقواس معقوفة لكنها جزء من نمط التعبير النمطي نفسه، لا صياغة بنيوية. يُضيف الإدراج التلقائي للفاصلة المنقوطة طبقة ثالثة من الصعوبة، بما أن JavaScript يسمح بحذف الفاصلات المنقوطة في سياقات كثيرة ويستنتج أين تنتهي جملة وفقًا لقواعد ليس لدى مُنسِّق ساذج قائم على الأسطر طريقة لتكرارها بشكل صحيح. تحليل اللغة فعليًا في شجرة صياغة مناسبة، كما يفعل Prettier، هو ما يتجنب أنماط الفشل الثلاثة — مُنسِّق اختصار يُخطئ حتى في واحد منها في كود إنتاج خطر، لا راحة.

يُنسِّق Prettier الكود — يُوحِّد المسافات البيضاء والأسطر الجديدة ونمط علامات الاقتباس واختيارات عرضية مماثلة — ولا يتحقق صراحة من صحة الكود أو سلامة أنواعه أو خلوّه من الأخطاء. ملف بخطأ نوع، مرجع لمتغير غير مُعرَّف، أو خطأ منطقي يُنسَّق دون شكوى ما دام صحيحًا نحويًا، لأن التنسيق والتحقق من الأنواع اهتمامان منفصلان تتعامل معهما أدوات منفصلة. مُترجم TypeScript نفسه، أو أداة فحص مثل ESLint، هو حيث يُتحقَّق من الصحة؛ ينتهي عمل هذه الأداة عند جعل الكود ذا نمط متسق وقابل للقراءة.

تبويبات مقابل مسافات، علامات اقتباس مفردة مقابل مزدوجة، فاصلة منقوطة أو لا — لا يؤثر أي من هذه الاختيارات بشكل ملموس على كيفية تشغيل الكود، وكانت الخلافات حولها تستهلك وقتًا حقيقيًا في نقاشات مراجعة الكود لا علاقة لها بالصحة. القيمة الحقيقية المُقدَّمة من Prettier هي إزالة ذلك النقاش من الطاولة تمامًا: مجموعة صغيرة وحاسمة من قواعد التنسيق مُطبَّقة تلقائيًا ومتطابقة في كل مكان تعني أن النقاش يُحسَم مرة واحدة، في التكوين، بدلًا من تكراره في كل طلب سحب من ذلك الحين فصاعدًا.

كل خيار مُعرَض هنا — عرض المسافة البادئة، الفاصلة المنقوطة، نمط علامات الاقتباس — يعكس إعداد تكوين Prettier حقيقيًا، لذا لصق كود من مشروع بملف `.prettierrc` معروف ومطابقة نفس تلك الإعدادات هنا يُعيد إنتاج بالضبط ما ستنتجه أداة ذلك المشروع نفسها، دون الحاجة لتثبيت أي شيء محليًا فقط للتحقق من كيفية تنسيق مقتطف.