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