ما هي مدقق JSON؟
يتحقق مدقق JSON مما إذا كانت بيانات JSON الخاصة بك تتوافق مع بناء الجملة الصحيح المحدد في مواصفة RFC 8259. يقوم بتحليل سلسلة الإدخال في الوقت الفعلي والإبلاغ عن النجاح أو السطر والعمود الدقيقين لأول خطأ في بناء الجملة. تدقيق JSON خطوة حاسمة في أي خط أنابيب بيانات — يمكن لفاصلة واحدة في غير مكانها، أو مفتاح غير مقترن، أو فاصلة زائدة أن تسبب رفض نقطة نهاية API للحمولة، أو فشل تحميل ملف التكوين، أو إلغاء استيراد قاعدة البيانات. تشمل انتهاكات بناء الجملة الشائعة الفواصل الزائدة بعد آخر عنصر في المصفوفة أو الكائن، وعلامات الاقتباس المفردة بدلاً من المزدوجة على المفاتيح والقيم النصية، ونقاطتين مفقودتين بين المفاتيح والقيم، والأحرف الخاصة غير المهروسة داخل السلاسل النصية، والأرقام ذات الأصفار البادئة أو نقاط عشرية بادئة. بالإضافة إلى بناء الجملة الأساسي، يمكن لأدوات من هذا النوع مساعدتك في اكتشاف مشاكل غير مرئية مثل أحرف BOM UTF-8 المضافة إلى بداية الملف، أو الأحرف غير الإنجليزية التي تكسر الترميز، أو المفاتيح المكررة التي هي صالحة تقنيًا لكنها تشير غالبًا إلى خطأ نسخ ولصق. سواء كنت في وضع تشخيص تكامل API، أو التحقق من ملف تكوين CI/CD، أو فحص بيانات مصدرة من قاعدة بيانات، يمنحك هذا المدقق تغذية راجعة فورية وقابلة للتنفيذ حتى تتمكن من إصلاح الأخطاء قبل انتشارها.
متى تستخدم هذه الآلة الحاسبة
- التحقق من حمولة JSON قبل إرسالها إلى API لتجنب أخطاء 400 Bad Request.
- تصحيح سبب فشل تحميل ملف التكوين من خلال العثور على الموقع الدقيق للخطأ.
- التحقق من صحة البيانات المُصدَّرة من قاعدة بيانات أو جدول بيانات قبل استيرادها إلى نظام آخر.
- التحقق من أن إخراج JSON من مولد كود أو محرك قوالب صحيح من حيث بناء الجملة.
- اختبار حمولات webhook أو أجسام الطلبات أثناء تطوير API ودمجه.
- فحص ملف JSON بعد حل تعارض الدمج للتأكد من عدم إدخال أي خطأ في بناء الجملة.
الخطوات:
- الصق JSON الخاص بك في منطقة الإدخال.
- يتحقق المدقق من JSON الخاص بك تلقائيًا.
- شاهد شارة خضراء إذا كان صالحًا أو شارة حمراء مع تفاصيل الخطأ إذا كان غير صالح.
- أصلح أي أخطاء وأعد التحقق.
الصيغة
الإدخال: سلسلة JSON نصية → محاولة التحليل → صالح (أخضر) أو غير صالح (أحمر مع تفاصيل الخطأ)
حالات الاستخدام
- التحقق من صحة حمولات API قبل الإرسال
- فحص ملفات التكوين
- تصحيح أخطاء تحليل JSON
- التحقق من سلامة البيانات المُصدَّرة
الفوائد الرئيسية
- تحقق فوري من بناء الجملة مع وقت استجابة صفر
- موقع خطأ دقيق مع أرقام الأسطر والأعمدة
- تحقق تلقائي في الوقت الفعلي أثناء الكتابة
- مجاني دون الحاجة للتسجيل
- يكتشف مشاكل غير مرئية مثل BOM وأخطاء الترميز
- يعمل مباشرة في المتصفح دون رفع ملفات للخادم
نصائح احترافية
- تحقق دائمًا من JSON قبل النشر في بيئة الإنتاج أو الحفظ في التحكم في الإصدارات
- أصلح أول خطأ مُبلّغ عنه أولاً — غالبًا ما تُحل مشاكل التسلسل بعد إصلاح واحد
- استخدم أرقام الأسطر والأعمدة للقفز مباشرة إلى المشكلة في محرر الأكواد
- اجمع مع منسّق JSON لل=$('#visual') الفحص البصري للهيكل بعد اجتياز التحقق
- للملفات الكبيرة، تحقق من مقتطف أصغر أولاً لتحديد منطقة المشكلة
الأخطاء الشائعة التي يجب تجنبها
- استخدام علامات اقتباس مفردة بدلاً من المزدوجة للمفاتيح أو القيم النصية
- إضافة فاصلة زائدة بعد آخر عنصر في المصفوفة أو الكائن
- تضمين تعليقات (// أو /* */) غير جزء من مواصفة JSON
- نسيان الهروب من الأحرف الخاصة مثل أسطر جديدة أو تبويبات داخل القيم النصية
شرح المصطلحات الأساسية
- التحقق: فحص بيانات JSON مقابل مواصفة بناء الجملة RFC 8259
- التحليل (Parse): تفسير سلسلة JSON إلى بيانات هيكلية يمكن للبرامج استخدامها
- خطأ بناء الجملة: انتهاك لقواعد تنسيق JSON يُكتشف أثناء التحليل
- التحقق من صحة المخطط: التحقق من تطابق بيانات JSON مع بنية محددة تتضمن حقولًا مطلوبة وأنواعًا وقيودًا
- BOM (علامة ترتيب البايت): حرف UTF-8 غير مرئي في بداية ملف يمكن أن يسبب فشل تحليل JSON
مفاهيم ذات صلة
- منسّق JSON:
- مختبر Regex:
- مُرمّز/مُفكّك Base64:
- مُرمّز/مُفكّك URL:
- مولّد Hash:
مثال
الإدخال: {"name":"John","age":30,} يحتوي على فاصلة زائدة بعد 30. يبلغ المدقق: "Expected a value at line 1, column 26" مما يحدد بالضبط أين الإصلاح مطلوب.
تفسير نتائجك
يحلل المدقق إدخال JSON الخاص بك في الوقت الفعلي ويبلغ إما عن شارة خضراء 'صالح' أو شارة حمراء 'غير صالح' مع السطر والعمود الدقيقين للخطأ الأول. أصلح الخطأ المبلغ عنه وأعد التحقق — غالبًا ما تكون هناك أخطاء متتالية حيث يتسبب خطأ واحد في مشاكل متعددة لاحقة.
تشير أرقام الأسطر والأعمدة إلى الموضع الدقيق للحرف الذي فشل المحلل عنده. إذا قال الخطأ 'السطر 5، العمود 12'، انتقل إلى ذلك الموضع في إدخالك وتحقق من المشاكل الأكثر شيوعًا: فاصلة مفقودة، أو مفتاح بدون علامات اقتباس، أو فاصلة زائدة.
بالنسبة لـ JSON الذي يبدو صالحًا لكنه لا يزال يفشل، تحقق من الأحرف غير المرئية مثل BOM (علامة ترتيب البايت) في بداية الملف، أو المسافات غير القابلة للكسر داخل السلاسل النصية. يمكن أن يتم إدخال هذه بواسطة محررات النصوص أو عمليات النسخ واللصق.