كيفية تنسيق والتحقق وضغط JSON (مجاني، داخل المتصفح)

JSON هي لغة التواصل المشتركة للويب الحديث، لكن الطريقة التي تعيدها بها API، مضغوطة في سطر واحد متصل، غير قابلة للقراءة للبشر. يشرح هذا الدليل كيفية التنسيق (الطباعة الجميلة) والتحقق والضغط لـ JSON، ولماذا يهم القيام بذلك داخل متصفحك دون رفع أي شيء للبيانات الحساسة.

ما هو تنسيق JSON؟

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

كيفية تنسيق JSON

1. الصق JSON الخاص بك في منطقة الإدخال.
2. انقر على "تنسيق" لتجميله بمسافات بادئة مناسبة.
3. تحقق من حالة التحقق؛ تُبرز الأداة أي خطأ نحوي فورًا.
4. استخدم "ضغط" لضغط JSON للإنتاج، أو "نسخ" لنسخ النتيجة.

أخطاء JSON الشائعة وكيفية إصلاحها

عندما يحتوي JSON على أخطاء نحوية، يشير المدقق الجيد إلى السطر وموضع الحرف بالضبط. هذه هي الأخطاء التي تسبب معظم الإخفاقات:

• فواصل زائدة قبل قوس أو قوس مربع إغلاق، مثلاً {"a": 1,}.
• مفاتيح بدون علامات اقتباس: يجب تغليف المفاتيح بعلامات اقتباس مزدوجة ({ "a": 1 }، وليس { a: 1 }).
• علامات اقتباس مفردة بدلاً من المزدوجة: يتطلب JSON علامات اقتباس مزدوجة للسلاسل.
• فواصل مفقودة بين العناصر في كائن أو مصفوفة.

متى تضغط JSON

الضغط يزيل كل المسافات وفواصل الأسطر والمسافات البادئة غير الضرورية، مضغطًا JSON إلى أصغر تمثيل ممكن. هذا ضروري للإنتاج حيث يكون كل بايت مهمًا: ملف منسق بحجم 50 KB يمكن غالبًا أن يتقلص إلى حوالي 30 KB، أي تخفيض بحوالي ~40% في حجم النقل. اقرأ بالتنسيق أثناء التطوير، ثم اضغط للنشر.

لماذا يكون المنسق القائم على المتصفح أكثر أمانًا

يُلصق المطورون بشكل متكرر ملفات التكوين واستجابات API وبيانات الاعتماد كـ JSON. إذا رفع المنسق تلك البيانات إلى خادم، فإنها تغادر جهازك. يعالج المنسق من جانب العميل كل شيء في متصفحك باستخدام JavaScript، لذلك لا يتم نقل أي شيء. يمكنك التحقق من ذلك بنفسك بفتح DevTools؛ ستُظهر علامة التبويب Network عدم وجود طلبات صادرة تحتوي على بياناتك.

جاهز للتجربة؟ افتح منسق ومدقق ومحول JSON والصق بياناتك. كل شيء يعمل محليًا في متصفحك.