تحقق من JSON الخاص بك

ما الذي يمنعه JSON فعلًا

قواعد JSON صغيرة جدًا عن قصد، وتكاد كل حالات فشل التحقق تكون واحدة من بضعة أشياء يستعيرها الناس من JavaScript ولم يعتمدها JSON قط. فاصلة زائدة بعد العنصر الأخير. علامات اقتباس مفردة بدل المزدوجة. مفاتيح غير محاطة بعلامات اقتباس. التعليقات — لا يوجد في JSON أي تعليقات، ولم يكن فيه قط. NaN وInfinity، وهما رقمان صالحان في JavaScript وغير صالحين في JSON. وعلامة ترتيب البايت (BOM) في البداية، غير المرئية في أي محرر، والتي تضيفها بعض أدوات Windows عند الحفظ بترميز UTF-8، فتجعل مستندًا سليمًا تمامًا يفشل عند أول حرف.

هناك أمران مسموح بهما لكنهما سيسببان لك المتاعب، ولهذا فإن «صالح» لا يعني «صحيح». المفاتيح المكررة ليست ممنوعة في المواصفة — لكن كل محلّل يحسمها بطريقة مختلفة، ومعظمها يأخذ الأخير، فالمستند الذي يتكرر فيه مفتاح ينجح في التحقق هنا ويعني أشياء مختلفة في لغات مختلفة. ولا يوجد حد دقة محدد للأرقام في JSON بينما تقرأها معظم المحللات كأعداد عشرية: فالعدد الصحيح الذي يتجاوز نحو تسعة كوادريليونات يُقرَّب بصمت، ولهذا كثيرًا ما تُحمل المعرّفات الكبيرة كسلاسل نصية.

ما تحصل عليه هو السطر والعمود والحرف بالضبط حيث توقف التحليل، وهذا عادةً أكثر فائدة من الرسالة نفسها. فالمحلّل يبلّغ عن النقطة التي توقف عندها المستند عن أن يكون منطقيًا، لا عن المكان الذي وقع فيه الخطأ — فالقوس المعقوف الختامي المفقود يُبلَّغ عنه في نهاية الملف، والفاصلة المفقودة يُبلَّغ عنها عند الرمز الذي يليها. والنظر قبل الموضع المُبلَّغ عنه مباشرةً هو العادة التي توفر أكثر وقت.

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

عندما تحتاج إلى شيء آخر

للتحقق من المستندات وفق مخطط لا وفق قواعد الصياغة، فإن JSON Schema هو المعيار وajv أسرع تطبيق له — سيخبرك بأن حقلًا مطلوبًا مفقود أو أن قيمة خارج النطاق، وهو السؤال الذي يشغلك عادةً فعلًا. وتُجري check-jsonschema الفحوص نفسها من سطر الأوامر وفي CI.

لأي شيء في سطر الأوامر، jq هي الأداة التي يجب أن تمتلكها: فالأمر jq empty file.json يتحقق ولا يطبع شيئًا عند النجاح، وهذا بالضبط ما يناسب سكربتًا، والأمر jq . ينسّق. وللملفات الأكبر من أن تُحفظ في الذاكرة، يحلل jq --stream وijson في Python بشكل تدريجي، وهذا ما لا تستطيعه أي صفحة تحمّل المستند كاملًا.