مُعدّل package.json ومرتب المفاتيح
مرشد
مُعدّل package.json ومرتب المفاتيح
لصق أي package.json في مجال الإدخال (أو انقر على "جرب مثالًا" لرؤية الأداة في العمل).
كيفية استخدام
- ألصق
package.jsonاختر نمط التسجيل المفضل: مسافتين، أربع مسافات، أو مُسَّمَّة. - بموجب تفعيل الترتيب الأبجدي للوحدات الاعتمادية وترتيب السكريبتات وفقًا لدورة الحياة.
- إيقاف "إزالة الحقول غير القياسية" إذا كنت ترغب في إزالة المفاتيح غير المعروفة على المستوى الأعلى.
- راجع النتيجة المُصاغة على اليمين بالإضافة إلى تقرير التحقق الذي يحتوي على الأخطاء، التحذيرات، والملاحظات.
- نسخ النتيجة أو تنزيلها مباشرة كـ
- ترتيب المفاتيح القياسي
package.json.
خصائص
- – ترتيب الحقول على المستوى الأعلى وفقًا للترتيب القياسي لـ npm بحيث تبقى التغييرات والتحقق في المراجع متسقة. التحقق من الحقول المطلوبة والمقترحة
- – يُشير إلى المفقود والمدخلات المقترحة مثل
name/versionالتحقق من نطاقات الإصدارdescription,licenseو، وrepository. - – يتحقق من كل مدخل في يستخدم نطاقًا صالحًا (مُستخدم، مُسَمَّى، نطاقات، بروتوكولات المكان، وما إلى ذلك).
dependencies,devDependencies,peerDependenciesو، وoptionalDependenciesتسلسل الاعتماد - – يُمكن ترتيب كل مجموعة من الاعتمادات بشكل أبجدي لضمان إخراج مريح للملف المُجمّع. تسلسل السكريبتات وفقًا لدورة الحياة
- – يُحتفظ بالسكريبتات المُتعلقة بدورة الحياة مُجمعة، ثم يُرتّب الباقي حسب الترتيب الأبجدي. إزالة الحقول غير القياسية
preX/X/postX– إزالة المفاتيح غير المعروفة على المستوى الأعلى لجعل ملفك المُصاغ خفيفًا، أو الحفاظ عليها (تُنقل إلى الأسفل). - تحكم في التسجيل – إصدار يحتوي على مسافتين، أربع مسافات، أو مُسَّمَّة لتتناسب مع قواعد تنسيق مشروعك.
- – يتم تنفيذ التحليل، التحقق، والتسلسل بالكامل في المتصفح. لا يتم إرسال أي شيء. لماذا يهم ترتيب المفاتيح في package.json؟
- من جانب العميل فقط يُعامل المعيار JSON الأشياء كغير مرتبة، لكن في الممارسة، يؤثر ترتيب المفاتيح على قابلية القراءة للإنسان، ووضوح التغييرات في طلبات التحديث، وكيف تُعرض الملفات من قبل الأدوات. الترتيب القياسي — الذي انتشر من خلال واجهة سطر الأوامر npm وتم اعتماده من قبل أدوات النظام — يضع الحقول المعرفية (الاسم، الإصدار) في المقدمة، ثم يليها البيانات المُتخصصة، والنقاط الدخول، ثم المجموعات الاعتمادية والتكوين. الترتيب المتسق يقلل من تعارضات التكامل ويُسهل قراءة الملفات.
التعليمات
-
ما هو semver وما أهمية نمط نطاق الإصدار؟
يُعرف التصنيف النسقي (semver) بثلاثة أجزاء (الإصدار الرئيسي، الإصدار الثانوي، الإصدار التصحيح)، مع قواعد صارمة حول ما يدل عليه كل جزء. تُستخدم مُؤشرات النطاق مثل (العَلامة، التمثيل، المقارنات) لتوجيه المُديرين إلى الإصدارات المستقبلية التي تقبلها دون أن تُفسد عقدك. قد يؤدي النطاق غير الصحيح أو غير المحدد إلى فشل في بناء المُكرر أو ترقية غير متوقعة. التحقق من النطاقات مبكرًا يُكتشف الأخطاء قبل أن تصل إلى ملف المُجمّع.
-
ما الذي يُعتبر حقلًا غير قياسي في package.json؟
يُحدد معيار npm مجموعة محددة من الحقول على المستوى الأعلى مع معاني مُوثقة (الاسم، الإصدار، السكريبتات، الاعتماد، الأجهزة، وما إلى ذلك). تضيف الأدوات أحيانًا مفاتيح على المستوى الأعلى الخاصة بها — مثل إعدادات ESLint أو مُراقبة Husky أو إعدادات أداة البناء. هذه المفاتيح مقبولة تقنيًا كـ JSON ولكن تقع خارج معيار npm. يفضل بعض المشاريع الاحتفاظ بها للراحة، بينما يُفضل آخرون نقلها إلى ملفات إعداد مُخصصة لجعل الملف المُصاغ مركّزًا حول مسائل التعبئة.
-
لماذا نُجمّع السكريبتات المُتعلقة بـ npm بدلًا من مجرد ترتيبها أبجديًا؟
يُنفذ السكريبتات المُتعلقة بـ npm في تسلسل مُحدد: قبل التثبيت قبل التثبيت، قبل النشر قبل النشر، وما إلى ذلك. عند قراءة قسم السكريبتات، يُمكن تجميع المجموعات المرتبطة بدور الحياة (قبل/الأساس/بعد) معًا لجعل تدفق التنفيذ واضحًا في البداية. الترتيب الأبجدي فقط سيُفرق هذه الأزواج — على سبيل المثال، وضع "postbuild" بعيدًا عن "build" — مما يجعل من الصعب فهم ما يُنفذ في أي وقت.
-
لصق package.json هنا...
مُصاغ package.json ومرتبط بترتيب المفاتيح
تثبيت ملحقاتنا
أضف أدوات IO إلى متصفحك المفضل للوصول الفوري والبحث بشكل أسرع
恵 وصلت لوحة النتائج!
لوحة النتائج هي طريقة ممتعة لتتبع ألعابك، يتم تخزين جميع البيانات في متصفحك. المزيد من الميزات قريبا!
