كيفية تنسيق والتحقق من JSON
إجابة سريعة
استخدم JSON.parse() للتحقق وJSON.stringify(obj, null, 2) للتنسيق بمسافتين بادئة. استخدم منسّق JSON المجاني — يكشف أخطاء النحو مع موقع الخطأ، ويعمل في متصفحك بدون رفع.
مقدمة
تنسيق JSON يضيف مسافات بادئة وفواصل أسطر لجعل البيانات مقروءة. التحقق يتضمن JSON.parse() الذي يلقي خطأ إذا كان النحو غير صالح. الأخطاء الشائعة تشمل الفواصل الزائدة، علامات الاقتباس المفردة، والتعليقات — كلها غير صالحة في JSON.
خطوة بخطوة
-
افتح أداة التنسيق JSON
انتقل إلى صفحة أداة التنسيق JSON. تقبل الأداة أي سلسلة JSON كمدخلات - كائنات أو صفائف أو بنيات متداخلة.
-
الصق بيانات JSON الخاصة بك
الصق JSON الذي تريد تنسيقه أو التحقق من صحته في منطقة نص الإدخال. يمكن أن يكون هذا استجابة API، أو ملف تكوين، أو سلسلة JSON من التعليمات البرمجية الخاصة بك.
-
قم بمراجعة الإخراج المنسق
تقوم الأداة بتوزيع JSON الخاص بك وإعادة تسلسله باستخدام مسافة بادئة بمسافتين وفواصل أسطر. يظهر الإخراج المنسق على الفور في حقل النتيجة. إذا كان JSON غير صالح، فستظهر رسالة خطأ توضح موقع مشكلة بناء الجملة.
-
التحقق من حالة التحقق من الصحة
إذا كان JSON صالحًا، فستعرض الأداة مؤشر النجاح والمخرجات المنسقة. إذا كان غير صالح، فإنه يعرض خطأ التحليل - مثل "رمز مميز غير متوقع في الموضع 42" - حتى تتمكن من إصلاح مشكلة بناء الجملة في المصدر الخاص بك.
-
نسخ أو تصغير النتيجة
استخدم زر النسخ لنسخ JSON المنسق إلى الحافظة الخاصة بك. توفر بعض الأدوات أيضًا زر Miniify لإزالة جميع المسافات البيضاء، وهو أمر مفيد لتقليل حجم الحمولة في الإنتاج.
أمثلة
تم تصغير التنسيق JSON
مدخل: {"name":"Alice","age":30,"roles":["admin","user"]}
الإخراج: {
"name": "Alice",
"age": 30,
"roles": ["admin", "user"]
}
اكتشاف JSON غير صالح (فاصلة زائدة)
مدخل: {"a":1,"b":2,}
الإخراج: Error: Unexpected token } at position 11
اكتشاف JSON غير صالح (علامات الاقتباس المفردة)
مدخل: {'name':'Alice'}
الإخراج: خطأ: رمز مميز غير متوقع ' في الموضع 1
المشاكل الشائعة
- يتطلب استخدام علامات الاقتباس المفردة للسلاسل —JSON علامات اقتباس مزدوجة لجميع السلاسل والمفاتيح.
- الفواصل الزائدة بعد العنصر الأخير —JSON لا تسمح بفاصلة قبل } أو ].
- التعليقات في JSON — المعيار JSON لا يدعم // أو /* */ التعليقات. استخدم JSONC أو JSON5 إذا كنت بحاجة إلى تعليقات.
- المفاتيح غير المقتبسة — على عكس القيم الحرفية لكائنات JavaScript، يتطلب JSON أن تكون جميع المفاتيح بين علامات اقتباس مزدوجة.
- القيم غير المحددة أو NaN أو Infinity —JSON تدعم القيم الخالية فقط، وليست غير محددة أو NaN.
نصائح
- قم دائمًا بالتحقق من صحة JSON قبل إرساله في طلب API - يمكن أن يتسبب خطأ في بناء الجملة في استجابة 400 طلب غير صحيح.
- استخدم JSON المصغر في الإنتاج لتوفير النطاق الترددي، وتنسيق JSON في التطوير لسهولة القراءة.
- JSON لا يدعم كائنات التاريخ - قم بتسلسل التواريخ كسلاسل ISO 8601 (على سبيل المثال، "2026-09-02T00:00:00Z").
- استخدم JSON.parse() في JavaScript لتحويل سلسلة JSON إلى كائن، وJSON.stringify() لتحويل كائن إلى سلسلة JSON.