منسق JSON

مُنسّق JSON

الصق JSON من استجابة API أو ملف إعدادات أو webhook أو عينة من السجلات، ثم اختر التنسيق أو التصغير أو التحقق. يوسع المنسق الكائنات والمصفوفات المتداخلة بمسافتين أو أربع مسافات، ويزيل المصغر المسافات غير الضرورية، ويتأكد التحقق من أن النص JSON صالح قبل نسخ النتيجة.

طريقة تنسيق JSON

  1. 1

    الصق JSON

    أضف قيمة JSON كاملة: كائنًا أو مصفوفة أو سلسلة نصية أو رقمًا أو قيمة منطقية أو `null`.

  2. 2

    اختر الإجراء

    استخدم التنسيق لنتيجة سهلة القراءة، أو التصغير لنتيجة مضغوطة، أو التحقق لفحص البنية.

  3. 3

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

    للناتج المنسق، اختر مسافتين لمشروعات الويب أو أربع مسافات إذا كان هذا هو نمط المستودع.

  4. 4

    انسخ النتيجة

    راجع رسالة المحلل أو الناتج المنسق، ثم انسخ النتيجة إلى المحرر أو عميل API أو الوثائق.

ما الذي يفعله منسق JSON هذا

  • تنسيق JSON: يحول إدخالًا مضغوطًا مثل {"a":1,"b":[1,2,3]} إلى JSON مقروء مع مسافات بادئة.
  • تصغير JSON: يزيل المسافات الموجودة للقراءة فقط، وهو مفيد للأمثلة المختصرة والتضمين و payloads النقل.
  • التحقق من البنية: يفحص ما إذا كان النص الملصق قابلًا للتحليل كـ JSON. هذا فحص بنية، وليس تحققًا عبر JSON Schema.
  • دعم أي قيمة جذر في JSON: الكائنات والمصفوفات هي الأكثر شيوعًا، لكن نص JSON قد يكون أيضًا سلسلة نصية أو رقمًا أو true أو false أو null.
  • إبقاء سير العمل بسيطًا: الصق، اختر الإجراء، راجع الناتج، ثم انسخ النتيجة.

ما الذي لا يغيره عمدًا

  • لا يصلح JSON غير الصحيح تلقائيًا. رسالة المحلل تخبرك بما يجب تعديله.
  • لا يقبل أغلفة JSONP مثل callback({...}).
  • لا يقبل التعليقات أو الفواصل الأخيرة من JSONC ما لم تزلها أولًا.
  • لا يرتب مفاتيح الكائنات. يتم الحفاظ على الترتيب الحالي قدر ما يسمح به المحلل والمسلسل.
  • لا يتحقق من قواعد العمل أو الحقول المطلوبة أو مخططات API. استخدم مدقق JSON Schema لهذه الخطوة.

خيارات التنسيق

الحالة أفضل إجراء لماذا يفيد
قراءة استجابة API تنسيق بمسافتين تصبح الكائنات والمصفوفات المتداخلة أسهل في القراءة السريعة.
مطابقة نمط المستودع تنسيق بمسافتين أو أربع مسافات المسافة البادئة المتسقة تجعل مراجعات الكود أوضح.
تضمين payload داخل طلب تصغير يزيل المسافات من دون تغيير قيم JSON.
فحص بيانات منسوخة من السجلات تحقق يؤكد أن المقطع الملصق JSON كامل قبل إعادة استخدامه.
تجهيز وثائق API تنسيق تصبح الأمثلة أسهل في المراجعة والنسخ.

مشكلات بنية JSON التي يكتشفها

رسالة المحلل السبب الشائع ما الذي تفعله
Unexpected token ' at position X استخدام علامات اقتباس مفردة حول مفتاح أو سلسلة استخدم علامات اقتباس مزدوجة لسلاسل JSON.
Unexpected end of JSON input نقص قوس إغلاق أو قوس مربع أو علامة اقتباس راجع نهاية النص الملصق.
Unexpected token , at position X فاصلة بعد العنصر الأخير احذف الفاصلة الأخيرة.
Unexpected token a at position X مفتاح من دون علامات اقتباس أو NaN أو undefined ضع المفاتيح بين علامات اقتباس واستخدم قيم JSON صالحة فقط.
Unexpected token / at position X تعليق منسوخ من JSONC أو JavaScript احذف تعليقات // و/* */ قبل التحقق.

نصائح عملية

  • نسق أولًا عند مراجعة استجابة، ولا تصغر إلا عندما تحتاج فعلًا إلى payload مضغوط.
  • تحقق قبل لصق JSON في الوثائق أو التذاكر أو عملاء API، خصوصًا إذا كان المصدر جزءًا من سطر سجل.
  • حافظ على نمط المسافة البادئة في المشروع. تحويل ملف قائم من مسافتين إلى أربع مسافات قد ينتج diff مزعجًا للمراجعة.
  • تجنب لصق الأسرار أو بيانات اعتماد الإنتاج أو بيانات العملاء في أي أداة ويب عامة. للـ payloads الحساسة، استخدم أداة داخلية أو غير متصلة معتمدة من مؤسستك.

الأسئلة الشائعة

لا. هذه الأداة تفحص بنية JSON فقط. إذا كنت بحاجة إلى تأكيد الحقول المطلوبة أو القيم المسموح بها أو شكل الكائنات، فمرر النتيجة إلى مدقق JSON Schema بعد أن يتم تحليلها بنجاح.

JSON الصارم لا يسمح بالتعليقات أو الفواصل الأخيرة. احذف تعليقات JSONC والفواصل الأخيرة قبل التحقق أو التنسيق.

استخدم النمط المعتمد في مشروعك. المسافتان شائعتان في JavaScript وملفات إعدادات الويب، بينما قد تكون الأربع مسافات أوضح في بعض مستودعات backend.

تجنب لصق الأسرار أو رموز الوصول أو بيانات الاعتماد أو سجلات العملاء في منسق ويب عام. للـ payloads الحساسة، استخدم أداة داخلية أو غير متصلة معتمدة.

أدوات ذات صلة