تنسيق JSON والتحقق منه: دليل كامل

ما الذي يُعد JSON

• يجب أن تكون أسماء الخصائص سلاسل بين علامتي اقتباس مزدوجتين.
• السلاسل تستخدم علامات اقتباس مزدوجة لا مفردة.
• لا تعليقات ولا فواصل زائدة.
• الأعداد عشرية بالأساس 10 (لا أصفار بادئة تُقرأ نظاماً ثمانياً، ولا NaN أو Infinity في JSON الصارم).
• المستند قيمة واحدة — عادة كائن أو مصفوفة — لا عدة قيم في المستوى الأعلى.

التنسيق (الطباعة الجميلة)

يحلّل المنسّق النص إلى قيمة، ثم يطبعها من جديد بمسافة بادئة وتباعد متسقين. هذه العملية تطبّع المسافات البيضاء غير المؤثرة. عند تكرار المفاتيح تُبقى آخر قيمة احتفظ بها المحلّل.

التحقق

التحقق هو خطوة التحليل وحدها: إما أن يصبح النص قيمة، أو يرفع المحلّل خطأ. أداة «المدقق» المنفصلة مفيدة حين تريد نجاحاً أو فشلاً واضحاً من غير إعادة كتابة المستند.

كيف تتصرف أدوات SmartKitio

• يطبع منسّق JSON طباعة جميلة بمسافة بادئة من مسافتين، أو يصغّر الناتج إلى سطر واحد.
• تُظهر أخطاء التحليل رسالة خطأ JSON الصادرة عن المتصفح حتى تحدد موضع المشكلة.
• لا يُقبل إلا JSON الصارم — لا JSON5، ولا JSON Lines كملف كامل.
• التحليل والتنسيق يعملان محلياً في متصفحك؛ ولا يُرفع المحتوى إلى SmartKitio للمعالجة.
• الأعداد الصحيحة خارج النطاق الآمن في JavaScript تفقد دقتها لأنها تُقرأ أعداد IEEE-754 — أرسل المعرّفات الكبيرة سلاسل حين يكون ذلك مهماً.

أخطاء شائعة