منسق شيفرة تايب سكريبت

توسع تايب سكريبت جافا سكريبت بإضافة تعليقات توضيحية للأنواع، وواجهات، وأنواع عامة، وتعدادات، وميزات أخرى لنظام الأنواع. يحتاج منسق تايب سكريبت إلى التعامل مع جميع تنسيقات جافا سكريبت القياسية بالإضافة إلى بناء الجملة الخاص بالأنواع مثل النقطتين في التعليقات التوضيحية للأنواع (const x: string)، والأقواس الزاويّة في الأنواع العامة (Array)، وتعريفات الواجهات والأنواع، وتنسيق التعدادات. قد تؤدي منسقات جافا سكريبت القياسية إلى كسر أو تجاهل هذه التركيبات الخاصة بتايب سكريبت.

كلا النهجين صالحان ويستخدمان على نطاق واسع. تايب سكريبت (مثل جافا سكريبت) لديها إدراج تلقائي للفواصل المنقوطة (ASI) يضيف فواصل منقوطة عند التحليل، لذا فإن حذفها يعمل في معظم الحالات. يذكر الفرق التي تتجاوز الفواصل المنقوطة كودًا أنظف وضربات مفاتيح أقل. الفرق التي تتضمنها تذكر الوضوح وتجنب حالات ASI النادرة. المفتاح هو الاتساق - اختر نمطًا واحدًا وفرضه عبر المشروع بأكمله. تتضمن معظم أدلة الأنماط الرئيسية (Airbnb، Google) الفواصل المنقوطة، بينما يتجاوزها StandardJS.

يؤدي ترتيب الاستيراد المتسق إلى تحسين قابلية قراءة الكود وتقليل تعارضات الدمج. عندما يتم فرز الاستيرادات أبجديًا وتجميعها منطقيًا (حزم الطرف الثالث أولاً، ثم الوحدات الداخلية)، يمكن للمطورين العثور بسرعة على استيرادات محددة وتجنب التكرارات. تؤدي الاستيرادات غير المرتبة أيضًا إلى اختلافات git غير ضرورية - يؤدي مطوران يضيفان استيرادات في مواضع مختلفة إلى تعارض دمج حتى لو كان تغيير الكود الفعلي متطابقًا.

الفواصل اللاحقة هي فواصل توضع بعد العنصر الأخير في المصفوفات، الكائنات، معلمات الدالة، ومعلمات الأنواع. ينتج عن استخدام الفواصل اللاحقة اختلافات git أنظف لأن إضافة عنصر جديد يغير سطرًا واحدًا فقط بدلاً من سطرين (السطر الجديد بالإضافة إلى إضافة فاصلة إلى السطر الأخير السابق). كما أنها تجعل إعادة ترتيب العناصر أسهل. يسمح ES5 بالفواصل اللاحقة في المصفوفات والكائنات؛ يسمح ES2017 و تايب سكريبت بها في معلمات الدالة أيضًا.

الاختيارات الأكثر شيوعًا هي 80، 100، و 120 حرفًا. 80 حرفًا هو المعيار التقليدي، والذي نشأ من قيود عرض الطرفية، ولا يزال الافتراضي في Prettier. 100 حرفًا هو حل وسط حديث شائع يستوعب التعليقات التوضيحية لأنواع تايب سكريبت المطولة دون التفاف مفرط. يعمل 120 حرفًا بشكل جيد على الشاشات العريضة ولكنه قد يؤثر على قابلية القراءة على الشاشات الأصغر أو في عروض الاختلاف جنبًا إلى جنب. اختر بناءً على إعداد الشاشة النموذجي لفريقك وسير عمل مراجعة الكود.