منسق JSON
الصق نص JSON للتحقق من صحته، وعرضه بتنسيق منظم، والحصول على مقاييس البنية الأساسية.
كيفية استخدام منسق JSON هذا
- الصق JSON في حقل الإدخال
الصق أو اكتب سلسلة JSON الخاصة بك في حقل الإدخال.
- تحقق من صحة البيانات
تشير نتيجة الحالة إلى ما إذا كان الإدخال بتنسيق JSON صالحاً أو تعرض خطأ في التحليل.
- اقرأ المخرجات المنسقة
يتم عرض JSON الصالح بتنسيق منظم مع مسافة بادئة بمقدار مسافتين في قسم المخرجات المنسقة.
- مراجعة مقاييس الهيكل
استخدم إجمالي المفاتيح وأقصى عمق للتداخل لفهم هيكل المستند.
كيف يعمل منسق JSON هذا
تستخدم هذه الأداة وظيفة JSON.parse الأصلية في المتصفح للتحقق من صحة المدخلات ووظيفة JSON.stringify مع المسافة البادئة لإنتاج مخرجات منسقة بشكل جميل. كما تقوم بفحص الهيكل الذي تم تحليله لحساب إجمالي المفاتيح وقياس أقصى عمق للتداخل.
JSON.parse(input) → JSON.stringify(parsed, null, 2) المدخل: {"name":"test","value":42} ← منسق بمسافة بادئة من مسافتين، مفتاحين، وعمق 1.
المدخلات {"a":1,"b":[2,3],"c":{"d":4}} ← 4 مفاتيح، العمق 2. يضيف الكائن المتداخل c مستوى واحدًا من العمق.
المدخلات غير الصالحة {"key": undefined} تفشل في التحقق — لا يوجد undefined في JSON؛ استخدم null أو احذف المفتاح.
- ✓ يجب أن يكون المدخل بتنسيق JSON صالح (ليس كائنات JavaScript أو فواصل زائدة).
- ✓ المدخلات الكبيرة قد تؤثر على أداء المتصفح.
- تعمل هذه الأداة بالكامل في متصفحك. لا يتم إرسال أي بيانات إلى أي خادم.
فهم التحقق من صحة JSON
إن JSON (JavaScript Object Notation) هو مجموعة فرعية صارمة من بناء جملة JavaScript الحرفي. يتطلب JSON الصالح مفاتيح وقيم نصية محاطة بعلامات اقتباس مزدوجة، وعدم وجود فاصلات زائدة في النهاية، وعدم وجود تعليقات، وعدم استخدام علامات اقتباس مفردة. يقرأ المحلل السلسلة حرفاً بحرف ويبني شجرة تحليل؛ وأي خطأ في بناء الجملة — مثل فاصلة مفقودة، أو علامة اقتباس غير مهربة، أو رقم غير صالح — يؤدي إلى فشل التحقق مع رسالة خطأ وموقع محددين. تساعد معرفة الأخطاء الشائعة: الفاصلات الزائدة بعد آخر عنصر في المصفوفة أو خاصية الكائن غير صالحة، وكذلك التعليقات بأسلوب JavaScript (// أو /* */). يجب ألا تحتوي القيم الرقمية على أصفار بادئة باستثناء الرقم 0 نفسه، ويجب أن تستخدم النصوص تسلسلات هروب صالحة.
حالات استخدام عملية للمطورين لتنسيق JSON
يستخدم المطورون منسقات JSON عند تصحيح استجابات API، وفحص ملفات التكوين، وإعداد البيانات للتوثيق. يصعب قراءة ملفات JSON المضغوطة من واجهات برمجة التطبيقات الإنتاجية؛ لذا فإن التنسيق الجمالي يكشف الهيكل ويسهل اكتشاف الحقول غير الصحيحة أو غير المتوقعة. تساعد مقاييس الهيكل مثل عدد المفاتيح وعمق التداخل في تقييم التعقيد وتحديد الحمولات المتداخلة بشكل مفرط والتي قد تسبب مشكلات في الأداء. عند كتابة الاختبارات أو النماذج، يسهل مراجعة ومقارنة ملفات JSON المنسقة في أنظمة التحكم في الإصدار. يكتشف المدقق أخطاء الصيغة بسرعة قبل إرسال الطلبات أو اعتماد ملفات التكوين، مما يوفر الوقت في عملية التصحيح.
الأسئلة الشائعة
هل تدعم هذه الأداة JSON5 أو JSONC؟
لا. يتم دعم JSON القياسي (RFC 8259) فقط. ستؤدي التعليقات والفواصل الزائدة إلى أخطاء في التحقق.
هل هناك حد للحجم؟
لا يوجد حد أقصى ثابت، ولكن نصوص JSON الكبيرة جداً قد تبطئ المتصفح.