فهم JSON: دليل المبتدئين للتنسيق والتحقق
إجابة سريعة
JSON هو تنسيق بيانات نصي يستخدم أزواج المفتاح والقيمة والمصفوفات. يدعم السلاسل والأرقام والقيم المنطقية وnull والكائنات والمصفوفات. استخدم أداة تنسيق JSON المجانية لتجميل والتحقق وتصغير بيانات JSON — تتم جميع المعالجة في متصفحك.
مقدمة
JSON (JavaScript Object Notation) هو تنسيق تبادل بيانات خفيف الوزن يسهل على البشر قراءته وكتابته، ويسهل على الآلات تحليله وتوليده. وهو تنسيق البيانات الأكثر شيوعاً المستخدم للتواصل بين خوادم الويب والمتصفحات، وقد حل إلى حد كبير محل XML في واجهات برمجة التطبيقات الحديثة.
خطوة بخطوة
-
فهم بناء الجملة JSON
يستخدم JSON الأقواس المتعرجة {} للكائنات، والأقواس المربعة [] للمصفوفات، وأزواج القيمة الرئيسية مفصولة بنقطتين. يجب أن تكون المفاتيح عبارة عن سلاسل ضمن علامات اقتباس مزدوجة. يمكن أن تكون القيم عبارة عن سلاسل أو أرقام أو منطقية أو فارغة أو كائنات أو صفائف.
-
قم بتنسيق JSON
الصق بيانات JSON في أداة التنسيق JSON. سيقوم تلقائيًا بتجميل JSON بالمسافات البادئة وفواصل الأسطر المناسبة، مما يسهل قراءته.
-
التحقق من صحة الهيكل
يقوم المنسق بفحص JSON بحثًا عن أخطاء في بناء الجملة. إذا كان صالحاً، فإنه يعرض الإخراج المنسق. إذا كان غير صالح، فإنه يظهر رسالة خطأ تشير إلى المشكلة.
-
انسخ أو استخدم النتيجة
انسخ JSON المنسق إلى الحافظة الخاصة بك لاستخدامه في التعليمات البرمجية أو الوثائق أو تصحيح الأخطاء.
أمثلة
كائن بسيط
مدخل: {"name":"Alice","age":30}
الإخراج: {
"name": "Alice",
"age": 30
}
مجموعة من الكائنات
مدخل: [{"id":1},{"id":2}]
الإخراج: [
{ "id": 1 },
{ "id": 2 }
]
هيكل متداخل
مدخل: {"user":{"name":"Bob","tags":["admin","user"]}}
الإخراج: {
"user": {
"name": "Bob",
"tags": ["admin", "user"]
}
}
المشاكل الشائعة
- يتطلب استخدام علامات الاقتباس المفردة للسلاسل —JSON علامات اقتباس مزدوجة للسلاسل والمفاتيح.
- الفواصل الزائدة —JSON لا تسمح بفاصلة بعد العنصر الأخير في كائن أو صفيف.
- التعليقات —JSON لا تدعم التعليقات (// أو /* */). استخدم JSONC أو JSON5 إذا كنت بحاجة إلى تعليقات.
- المفاتيح غير المقتبسة - يجب أن تكون جميع المفاتيح ضمن علامات اقتباس مزدوجة، على عكس القيم الحرفية لكائنات JavaScript.
نصائح
- استخدم منسق JSON لاكتشاف الأخطاء النحوية قبل إرسال البيانات إلى API.
- يعمل JSON المصغر على حفظ النطاق الترددي — استخدم التصغير في الإنتاج والتنسيق في التطوير.
- JSON لا يدعم الوظائف أو التواريخ غير المحددة كقيم - استخدم سلاسل فارغة أو ISO 8601.
- استخدم JSON.parse() في JavaScript لتحويل سلاسل JSON إلى كائنات، وJSON.stringify() لتحويل الكائنات إلى JSON.