تنسيق والتحقق من JSON: إصلاح الأخطاء الشائعة في 5 دقايق

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

ليه بيظهر «invalid JSON»؟

المحلل (parser) بيقرأ النص حرف بحرف وفق قواعد صارمة؛ أي انحراف — فاصلة زيادة، نص غير مقفول، محرف تحكم — بيقف عنده ويبلّغ بالسطر والعمود. المشكلة مش في «الـJSON» كمفهوم، المشكلة إن الملف خرج من يد بشر أو من قالب بيلصق قيم بدون تهريب صحيح.

الإصلاح في خمس دقايق

1. الصق في أداة التنسيق وخليها تقولك السطر والعمود بالضبط.
2. بص على المحرف السابق للعلامة — الغالب الساحق من الأخطاء هناك مش عند العلامة.
3. أصلح النوع الواحد (نصوص/فواصل/أقواس) وأعد الفحص.
4. قارن بنسخة شغالة بأداة المقارنة لو التغيير دخل من تعديل حديث.
5. صغّر الناتج النهائي بـأداة التصغير قبل النشر.

الأخطاء اللي بتسبب 90٪ من الأعطال

• فاصلة زائدة قبل قفل قوس (,} أو ,]).
• نص بمشكال فردية أو بدون تهريب للاقتباس الداخلي.
• محارف تحكم خام (سطر جديد داخل نص) بدل \n.
• قيم غير مسموحة زي undefined أو تعليقات أو فواصل عشرية بأرقام محلية.
• ترميز ملف غلط (BOM أو Latin-1) بيكسر أول محارف.

JSON-LD والبيانات المنظمة

نفس القواعد بتطبق على سكربتات application/ld+json في صفحات المواقع — بس هنا الخطأ بيكلفك فقدان النتائج المنسقة في جوجل. اختبر كل بلوك بعد التعديل، وتأكد إن الأنواع والتواريخ بصيغة ISO، وإن الـcanonical والروابط مطلقة ومش نسبية.