مدقق JSON
افحص صحة نصوص JSON واكتشف موضع الخطأ البرمجي بدقة.
تتعامل برمجيات تحليل نصوص JSON بصرامة شديدة مع قواعد التنسيق، وتكفي فاصلة غير صحيحة أو علامة تنصيص مفقودة لإيقاف معالجة البيانات بالكامل مع رسائل خطأ غير واضحة. يساعدك مدقق JSON في فحص النص وتحديد الموضع الدقيق للخلل لإصلاحه فوراً.
خطوات فحص كود JSON عبر الأداة
- الصق بيانات JSON في مربع الإدخال المخصص.
- انقر فوق زر التحقق لإرسال النص وفحصه.
- إذا ظهر تنبيه بوجود خطأ، راجع رقم الموضع والسطر الموضح في التقرير.
- ابحث مباشرة قبل النقطة المشار إليها، فالخلل الحقيقي يقع عادة قبل الموضع المحدد برمز واحد.
- صحح المشكلة ثم أعد الفحص مجدداً حتى تظهر رسالة التأكيد بصحة البنية.
أشهر أخطاء بنية كود JSON الشائعة
تتسبب فواصل العناصر الزائدة في نهاية الكائنات أو المصفوفات في معظم المشكلات. هذا التنسيق مقبول في JavaScript، ولكنه غير صالح نهائياً في معيار JSON ويعطل برامج التحليل تماماً.
استخدام علامات التنصيص الفردية بدلاً من المزدوجة خطأ متكرر آخر، إذ يشترط معيار JSON إحاطة جميع المفاتيح والقيم النصية بعلامات تنصيص مزدوجة دون استثناء. يضاف إلى ذلك كتابة المفاتيح دون علامات تنصيص، أو إدراج تعليقات برمجية مثل //، حيث لا يدعم JSON التعليقات إطلاقاً. تجنب أيضاً استخدام قيمة undefined لأنها غير معتمدة.
أمثلة توضيحية لصحة نصوص JSON
| المثال | الحكم | السبب |
|---|---|---|
| {"a": 1,} | غير صالح | فاصلة زائدة في النهاية |
| {'a': 1} | غير صالح | استخدام علامات تنصيص فردية |
| {a: 1} | غير صالح | مفتاح بدون علامات تنصيص |
| {"a": 1} // note | غير صالح | تنسيق JSON لا يدعم التعليقات |
| {"a": undefined} | غير صالح | القيمة undefined غير صالحة في JSON |
| {"a": null} | صالح | القيمة null مدعومة في معيار JSON |
كيف تتعامل مع موضع الخطأ في JSON
تشير محركات التحليل غالباً إلى الموضع الذي توقفت فيه عن المعالجة وليس إلى مكان المشكلة الفعلي. فإذا نسيت إغلاق قوس متعرج في بداية الملف، فقد يستمر المحلل في قراءة النص لأسطر كثيرة قبل أن يكتشف استحالة إكمال العملية.
لذلك، خذ موضع العطل كنقطة بداية ثم تفقد الأسطر السابقة تدريجياً. يساعد التحقق من كود منسق ومقسم على عدة أسطر بدلاً من كتلة نصية واحدة في معرفة الأقواس غير المغلقة ومقارنة البنية بسهولة تامة.
أسئلة شائعة حول مدقق JSON
لماذا يفشل تدقيق JSON مع أنه يعمل داخل كود JavaScript؟
تسمح كائنات JavaScript بكتابة نصوص أكثر مرونة مقارنة بالقواعد الصارمة لمعيار JSON. تمنع مواصفات JSON استخدام الفواصل الزائدة، وعلامات التنصيص الفردية، والمفاتيح غير المقتبسة، والتعليقات، وقيمة undefined.
هل يمكن كتابة تعليقات توضيحية داخل ملفات JSON؟
لا. لا تحتوي مواصفات المعيار الرسمي على أي صيغة لكتابة التعليقات. تتيح بعض التنسيقات المشتقة مثل JSON5 كتابة الملاحظات، لكن برامج المعالجة القياسية ترفضها تماماً. إذا كنت بحاجة لوصف حقل، أضف مفتاحاً عادياً يحتوي على نص الشرح.
ما الفرق بين تدقيق JSON وتنسيقه؟
يفحص التدقيق مدى التزام النص بالقواعد المعيارية وصحة تركيبه البرمجي، بينما يعيد التنسيق ضبط المسافات البادئة والأسطر لتسهيل القراءة. لا يمكن تنسيق أي مستند إلا إذا كان سليماً بالأساس.
هل يسمح بتكرار المفاتيح داخل نفس الكائن في JSON؟
لا تمنع المواصفات ذلك صراحة، لكن السلوك يظل غير محدد وغالباً ما تحتفظ محركات المعالجة بالقيمة الأخيرة وتتجاهل ما قبلها. يُنصح بتجنب تكرار المفاتيح لتفادي أخطاء غير متوقعة يصعب تعقبها.
هل يتم إرسال نصوص JSON إلى الخادم أثناء الفحص؟
نعم، يُرسل النص إلى الخادم للتحقق من بنيته البرمجية ثم تظهر النتيجة لك دون أن يتم حفظ النص أو تخزينه. يمكنك مراجعة صفحة سياسة الخصوصية لمعرفة المزيد.