منسق JSON

كيفية تنسيق JSON

1. الصق JSON الخام أو المصغر في منطقة الإدخال.
2. انقر على تنسيق لتطبيق المسافة البادئة والهيكل.
3. راجع الإخراج المنسق في اللوحة اليمنى.
4. انسخ النتيجة أو قم بتنزيلها كملف .json.
5. استخدم مؤشر الخطأ لتحديد وإصلاح مشكلات التركيب على الفور.

كيف يعمل تنسيق JSON

شرح التنسيق الجميل

يضيف التنسيق الجميل مسافة بادئة متسقة، وفواصل أسطر، وتباعد إلى سلسلة JSON بحيث تصبح تسلسل البيانات قابلاً للقراءة. RFC 8259، المعيار الحالي لـ IETF لـ JSON، لا يحدد متطلبات المسافات بين الرموز - أي كمية من المسافات صالحة. يستغل التنسيق الجميل تلك المرونة لتحسين قابلية القراءة دون تغيير الدلالات.

خيارات المسافة البادئة

المسافة البادئة بمقدار مسافتين هي الافتراضية في معظم أدوات JavaScript (Prettier، ESLint) وتنتج إخراجًا مضغوطًا للهياكل المتداخلة بعمق. تتطابق المسافة البادئة بمقدار 4 مسافات مع الإخراج الافتراضي لـ json.dumps(data, indent=4) في Python. تدعم هذه الأداة كلا الأسلوبين لتتناسب مع تقاليد فريقك.

مثال

الإدخال (مصغر)

{"user":{"id":1,"name":"Alice","roles":["admin","editor"],"active":true}}

الإخراج (مسافة بادئة بمقدار 2)

{
  "user": {
    "id": 1,
    "name": "Alice",
    "roles": [
      "admin",
      "editor"
    ],
    "active": true
  }
}

متى توفر المنسقات الوقت

• تصحيح API - الصق استجابة API الخام لقراءة الكائنات والمصفوفات المتداخلة بسرعة
• ملفات التكوين - package.json، tsconfig.json، أو تكوين التطبيق قبل الالتزام إلى التحكم في الإصدار
• تصديرات قاعدة البيانات - غالبًا ما تصل أعمدة JSON في MongoDB وPostgreSQL، أو استجابات Elasticsearch مصغرة
• مراجعة الكود - قم بتحسين JSON المصغر من الطرف الثالث قبل المقارنة في git

الأخطاء الشائعة

• الفواصل الزائدة - {"a": 1,} هو JavaScript صالح ولكنه ليس JSON صالح وفقًا لـ RFC 8259؛ قم بإزالة الفاصلة الأخيرة
• السلاسل ذات الاقتباسات المفردة - {'key': 'value'} غير صالح؛ يتطلب JSON الاقتباسات المزدوجة
• تعليقات JavaScript - // comment و/* comment */ ليس لهما معادل في بناء جملة JSON؛ قم بإزالتها أولاً
• حروف التحكم غير الهاربة - يجب أن تكون حروف التبويب وفواصل الأسطر داخل قيم السلاسل هاربة كـ و

بعد التحقق من الصحة باستخدام مدقق JSON، استخدم هذا المنسق لتنسيق الإخراج. لضغط JSON المنسق مرة أخرى للأحمال الإنتاجية، يقوم مضغوط JSON بعكس العملية. لترميز JSON داخل رؤوس HTTP أو سلاسل الاستعلام، يتعامل المشفر Base64 مع النقل الآمن للبيانات الثنائية.