طريقة استخدام أداة منسّق JSON
- الصق JSON أو افتحهالصق JSON من استجابة API أو ملف سجل أو إعدادات، أو افتح ملف .json من جهازك.
- اختر خيارات التنسيقاختر مسافتين أو 4 مسافات أو جدولة، ورتّب مفاتيح الكائنات أبجديًا إن شئت.
- نسّق أو صغّر أو تحققانقر “تنسيق / تجميل” لنتيجة مقروءة، أو “تصغير” لأصغر حجم، أو “التحقق فقط” لفحص الصياغة.
- انسخ أو نزّلانسخ النتيجة إلى الحافظة أو نزّلها كملف .json.
لماذا يستخدم المطورون منسّق JSON هذا
- تحديد الأخطاء بدقةيعرض JSON غير الصالح سطر المشكلة وعمودها مع تلميح للأخطاء الشائعة مثل علامات الاقتباس المفردة أو الفواصل الزائدة.
- تجميل وتصغيربدّل بنقرة بين مسافات بادئة مقروءة ونتيجة مضغوطة في سطر واحد.
- ترتيب المفاتيحيسهّل الترتيب الأبجدي للمفاتيح مقارنة مستندي JSON في أداة مقارنة.
- خاص بطبيعتهيستخدم التحليل محرك JSON المدمج في متصفحك. لا تغادر الرموز وبيانات العملاء ومفاتيح API جهازك.
ما هو JSON؟
JSON (JavaScript Object Notation) صيغة نصية خفيفة للبيانات المنظمة. هي الطريقة القياسية التي ترسل بها واجهات API البيانات، وتظهر في ملفات الإعدادات وقواعد البيانات مثل MongoDB وفي تبادل البيانات بين كل لغات البرمجة تقريبًا. تتكون من كائنات ({ }) ومصفوفات ([ ]) ونصوص وأرقام وقيم منطقية (true/false) وnull.
تعيد واجهات API عادةً JSON مضغوطًا في سطر واحد لتوفير البيانات. هذا ممتاز للآلات لكنه صعب على البشر. المنسّق يضيف أسطرًا ومسافات بادئة لترى البنية بنظرة واحدة.
أكثر أخطاء الصياغة شيوعًا
JSON أكثر صرامة من JavaScript. هذه الأخطاء التي يجدها المدقق عندنا أكثر من غيرها:
- علامات اقتباس مفردة. النصوص والمفاتيح تستخدم علامات مزدوجة:
{"name": "Ahmed"}لا{'name': 'Ahmed'}. - فاصلة في النهاية. الفاصلة بعد العنصر الأخير، كما في
[1, 2, 3,]، غير مسموحة. - مفاتيح دون علامات اقتباس.
{name: "Ahmed"}صحيحة في JavaScript لكنها JSON غير صالح. - التعليقات. JSON القياسي لا يعرف التعليقات. احذف أسطر
//و/* */. - قيم خاصة. undefined وNaN وInfinity غير صالحة. استخدم null أو رقمًا.
- أحرف دون تهريب. أسطر الانتقال وعلامات الاقتباس المزدوجة داخل النص يجب أن تُكتب
\nو\".
النصوص العربية داخل JSON صالحة تمامًا كما هي، ولا تحتاج إلى تحويلها إلى رموز مثل ا.
تنسيق أم ضغط؟
استخدم JSON المنسّق أثناء التطوير ومراجعة ردود API وحفظ ملفات الإعدادات في Git، فالملفات المقروءة تعطي فروقات أوضح. واستخدم JSON المضغوط للإرسال عبر الشبكة أو التخزين في بيئة الإنتاج حيث يهم كل بايت. الضغط يحذف المسافات فقط، والبيانات لا تتغير.
هل من الآمن لصق ردود API هنا؟
نعم. كثير من المنسّقات على الإنترنت ترسل بياناتك إلى خادم، أما هذا فلا: التنسيق والتحقق يتمان داخل المتصفح بمحرك JSON نفسه الذي يستخدمه المتصفح في أي موقع. يمكنك حتى فصل الإنترنت بعد فتح الصفحة وستستمر الأداة في العمل. ومع ذلك، من العادات الجيدة حذف كلمات المرور ومفاتيح API الحقيقية قبل مشاركة أي JSON.