منسّق JSON
نسّق JSON واضغطه وتحقق منه واستكشفه في عرض شجري قابل للطي، مع تلوين بناء الجملة وإحصاءات مفصلة، كل ذلك محليًا في متصفحك.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
ما هو JSON؟
JSON اختصار لـ JavaScript Object Notation، أي ترميز كائنات JavaScript. وهو صيغة نصية للبيانات المنظمة ابتكرها دوغلاس كروكفورد في أوائل الألفية، وأصبحت الطريقة الافتراضية لتبادل المعلومات بين البرمجيات عبر الويب. وقواعده كلها تتسع في صفحة واحدة: كائنات بين قوسين معقوصين تحمل أزواج مفتاح وقيمة، ومصفوفات بين قوسين مربعين، وأربعة أنواع أولية هي النص والرقم والقيمة المنطقية وnull. وهذا الصغر المتعمد هو سبب أن كل لغة من Python إلى Java إلى Go تستطيع قراءته، وأن كل واجهة API تقريبًا تتحدث به.
ولأن JSON يتجاهل المسافات، فالمستند نفسه قد يكون سطرًا واحدًا متصلًا بحجم 40 كيلوبايت أو شجرة مرتبة بإزاحات. والخوادم ترسل النسخة المضغوطة لتوفير البيانات، أما البشر فيحتاجون النسخة المزاحة ليقرؤوا أي شيء. والتنسيق، ويسمى أيضًا التجميل، يحلل النص إلى بنية بيانات حقيقية ثم يعيد كتابتها بإزاحات وفواصل أسطر متسقة، وهذا يثبت أيضًا أن المستند صحيح نحويًا.
لماذا أنشأنا هذه الأداة
يواجه كل مطوّر هذا يوميًا: استجابة API ملصوقة من الطرفية، أو ملف إعدادات من حاوية، أو سطر سجل فيه حمولة مضمّنة؛ كلها قابلة للقراءة تقنيًا، ولا شيء منها مقروء فعلًا.
والمحرج أن تلك الحمولات تحتوي باستمرار على رموز وصول وسجلات عملاء ونقاط نهاية داخلية ومفاتيح API. ولصقها في منسّق عشوائي على الإنترنت يعني لصق أسرار بيئة الإنتاج في سجلات خادم شخص آخر. بنينا أداتنا لتعمل بالكامل داخل متصفحك: التحليل وإعادة الكتابة يجريان بلغة JavaScript على جهازك في تبويبك. لا يُرسل شيء إلى أي مكان، فلا رفع لتدقيقه ولا سياسة احتفاظ لتثق بها. وتعمل دون اتصال بعد تحميل الصفحة، وهذا مفيد حين تتتبع الأخطاء على شبكة مقيدة.
نصائح وأخطاء شائعة
- إذا فشل التنسيق، فموضع الخطأ يكون غالبًا فاصلة زائدة في النهاية، أو علامة اقتباس مفردة مكان المزدوجة، أو علامة اقتباس غير مهرّبة داخل نص.
- الإزاحة بمسافتين هي العرف في معظم مشاريع JavaScript والويب؛ وأربع مسافات شائعة في الشيفرات القريبة من Python.
- الحمولات الكبيرة جدًا أسهل في القراءة مطوية؛ افتح الفرع الذي تبحث فيه فقط.
- احذف بيانات الدخول من الحمولة قبل لصقها في بلاغ خطأ، حتى لو لم يغادر شيء متصفحك هنا.
بداية سريعة: استخدام منسّق JSON
- الصق JSON في مربع الإدخال أعلاه، أو حمّله من ملف.
- اختر الإزاحة: مسافتان هي الافتراضي الشائع، وأربع إن كان فريقك يفضلها.
- نسّق المستند؛ وإن كان غير صالح، فسيشير الخطأ إلى الموضع المسبب.
- اقرأ الشجرة أو اطوها لتجد الجزء الذي يهمك.
- انسخ الناتج المنسق أو نزّله كملف .json.
أدوات ذات صلة: مدقق JSON للتحقق الصارم، ومقارنة JSON لمقارنة حمولتين، وتحويل JSON إلى YAML للتحويل إلى ملفات الإعدادات.
ماذا يفعل التنسيق
يأخذ منسّق JSON نص JSON صالحًا ويعيد طباعته بإزاحة متسقة، مسافتين أو أربع لكل مستوى عادةً، وعنصر واحد في كل سطر. البيانات متطابقة؛ فقط المسافات تتغير. وفجأة يصبح التداخل واضحًا: الكائنات والمصفوفات وعلاقاتها تصطف بصريًا فتستطيع قراءة الشيء فعلًا.
التنسيق كأداة لتتبع الأخطاء
كثيرًا ما يحل التجميل المشكلة قبل أن تقرأ البيانات. فحين لا يُحلَّل JSON، يتوقف المنسّق عند النقطة التي تنكسر فيها البنية بالضبط: فاصلة ناقصة، أو قوس غير مغلق، أو فاصلة زائدة في النهاية يرفضها معظم المحللين. ورؤية البنية المزاحة تُبرز الأقواس غير المتطابقة والقيم في غير موضعها بطريقة لن يفعلها النص الخام أبدًا.
التنسيق مقابل التحقق مقابل الضغط
كثيرًا ما تُجمع هذه الثلاثة معًا لكنها تؤدي مهام مختلفة:
- التنسيق: يجعل JSON الصالح مقروءًا بالإزاحات.
- التحقق: يفحص هل JSON سليم أصلًا ويبلغ عن الأخطاء. استخدم مدقق JSON حين تحتاج إلى تأكيد الصحة.
- الضغط: عكس التنسيق، يزيل كل المسافات لتصغير الحمولة عند الإرسال.
وسير عمل شائع: الصق استجابة API، ونسّقها لتقرأها، وتحقق منها إن بدت معطوبة، ثم اضغط النسخة النهائية لبيئة الإنتاج.
استخدامات شائعة
- قراءة استجابة API وصلت مضغوطة.
- تتبع خطأ في ملف إعدادات برؤية بنيته بوضوح.
- اكتشاف خطأ نحوي يشكو منه المحلل.
- ترتيب JSON معدّل يدويًا قبل اعتماده في المستودع.