منسّق JSON

ما هو منسّق JSON؟

أداة تنسيق JSON (تسمى أيضاً مجمل أو pretty-printer) تأخذ JSON مضغوط أو مصغر وتعيد إخراجه بمسافات بادئة متسقة، وفواصل أسطر، ومسافات لكي يتمكن البشر من قراءته. JSON (JavaScript Object Notation) هو تنسيق تبادل البيانات الفعلي لواجهات برمجة التطبيقات. أداة التنسيق تكشف أيضاً أخطاء النحو — إذا لم يكن الإدخال JSON صالحاً، يبلغ المحلل عن موقع وطبيعة المشكلة، مما يجعها تعمل أيضاً كأداة تحقق.

كيف يعمل

تحلل الأداة سلسلة الإدخال باستخدام محلل JSON (JSON.parse أو محلل متسامح يقبل الفواصل الزائدة والتعليقات). إذا نجح التحليل، تُعاد تسلسل القيمة الناتجة بمسافة بادئة قابلة للتكوين (عادة مسافتين) وخيار ترتيب المفاتيح. إذا فشل التحليل، يُعرض رسالة خطأ المحلل مع إزاحة الحرف لكي يتمكن المستخدم من تحديد موقع المشكلة. تتم جميع المعالجة محلياً؛ لا تُرسل أي بيانات إلى خادم.

حالات الاستخدام الشائعة

• قراءة استجابات API المصغرة — توسيع حمولة JSON من سطر واحد إلى مخرجات مقروءة ومسافات بادئة
• تصحيح JSON تالف — تحديد الموقع الدقيق لفاصلة أو قوس مفقود
• مقارنة ملفات التكوين — المسافات البادئة المتسقة تسهل الفروقات والمراجعات
• تجهيز JSON للتوثيق — الأمثلة المجملة أوضح في READMEs والمواصفات

التفاصيل الفنية

المحلل: JSON.parse الأصلي (صارم، متوافق مع RFC 8259). المسافة البادئة: مسافتان افتراضياً، قابلة للتكوين. المخرجات UTF-8. لا تقوم أداة التنسيق بترتيب المفاتيح افتراضياً للحفاظ على ترتيب الإدراج. الفواصل الزائدة والتعليقات ليست JSON صالحاً؛ إذا كانت موجودة، يفشل التحليل بخطأ نحوي. الحد الأقصى العملي لحجم الإدخال مقيد بذاكرة المتصفح (عادة عدة ميغابايت).