مدقق JSON

التحقق من صحة بناء جملة وهيكل JSON

جرب مثالاً
يعمل محليًا · آمن للصق الأسرار

ما هو التحقق من JSON؟

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

JSON صحيح
json
{
  "user": "alice",
  "age": 30,
  "active": true,
  "tags": ["admin", "editor"]
}
JSON غير صحيح — فاصلة نهائية
json
{
  "user": "alice",
  "age": 30,
}

لماذا نتحقق من JSON؟

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

📍
تحديد موضع الخطأ بدقة
لا يكتفي المُتحقِّق بإخبارك بأن JSON غير صحيح، بل يُحدد السطر والعمود اللذين وقع فيهما الخطأ، حتى تذهب مباشرةً إلى المشكلة.
التحقق أثناء الكتابة
يوفر التحقق في الوقت الفعلي ردود فعل فورية أثناء التحرير. سترى الأخطاء تختفي لحظة تصحيحها، دون الحاجة لضغط أي زر.
🔍
التمييز بين الصياغة والمنطق
يكتشف التحقق من JSON أخطاء الصياغة فحسب. يؤكد أن المستند قابل للتحليل، بمعزل عن صحة القيم دلاليًا في تطبيقك.
🔒
الخصوصية في صميم التصميم
يعمل كل التحقق داخل متصفحك. بيانات الاعتماد ومفاتيح API والبيانات الحساسة لا تُرسَل أبدًا إلى أي خادم.

أخطاء التحقق من JSON الشائعة

هذه الأخطاء الأربعة تُشكّل الغالبية العظمى من حالات فشل التحقق من JSON:

الفاصلة النهائية
فاصلة بعد آخر عنصر في كائن أو مصفوفة. مقبولة في JavaScript لكنها مُحظَّرة تمامًا في JSON.
json
{ "a": 1, "b": 2, }
النصوص بعلامات اقتباس مفردة
علامات الاقتباس المفردة غير صحيحة في JSON. يجب أن تستخدم كلٌّ من المفاتيح والقيم علامات الاقتباس المزدوجة.
json
{ 'key': 'value' }
Undefined وNaN
undefined وNaN وInfinity قيمٌ في JavaScript، لكنها ليست JSON صحيحًا. استخدم null أو سلسلة رقمية بدلًا منها.
json
{ "val": undefined }
المفاتيح بلا علامات اقتباس
يشترط JSON أن تكون جميع مفاتيح الكائنات نصوصًا بين علامات اقتباس مزدوجة. لا يُسمح بالمُعرِّفات المجردة كما في كائنات JavaScript.
json
{ key: "value" }

حالات الاستخدام الشائعة

التحقق من عقود API
تحقق من أجسام الطلبات والاستجابات مقارنةً بالأشكال المتوقعة لاكتشاف أخطاء التكامل قبل وصولها إلى الإنتاج.
ضمان جودة ملفات الإعدادات
تحقق من package.json وtsconfig.json وسائر ملفات الإعدادات قبل الإيداع للتأكد من تحليلها بشكل صحيح.
التحقق من خط أنابيب البيانات
تأكد من صحة صياغة البيانات المُستقاة من مصادر خارجية أو رفوعات المستخدمين قبل معالجتها.
فحص ما قبل التشغيل في CI/CD
شغِّل التحقق من JSON كخطوة في عملية البناء لمنع نشر ملفات الإعدادات غير الصحيحة.
التعلم وتصحيح الأخطاء
استخدم المُتحقِّق أداةً للتعلم لفهم سبب صحة أو عدم صحة أنماط معينة من صياغة JSON.
ضمان جودة JSON المُولَّد
تحقق من أن JSON المُنتَج بواسطة مولدات الكود أو القوالب أو برامج التسلسل قد تشكّل بصورة صحيحة قبل الاستخدام.

الأسئلة الشائعة

ما الفرق بين التحقق من JSON والتحقق من مخطط JSON؟
التحقق من JSON (ما تفعله هذه الأداة) يفحص الصياغة — أي ما إذا كان المستند JSON قابلًا للتحليل. أما التحقق من مخطط JSON فهو خطوة منفصلة تفحص مدى توافق القيم مع بنية وأنواع وقيود محددة.
هل JSON5 أو JSONC هو JSON صحيح؟
لا. JSON5 (يسمح بعلامات الاقتباس المفردة والتعليقات والفواصل النهائية) وJSONC (يسمح بالتعليقات) مجموعات شاملة لـ JSON لكنها ليست JSON قياسيًا صحيحًا. تتحقق هذه الأداة وفق مواصفات JSON الصارمة (RFC 8259).
لماذا يفشل تحليل JSON الخاص بي رغم صحة مظهره؟
الأسباب الخفية الأكثر شيوعًا هي: فاصلة نهائية بعد الخاصية الأخيرة، أو علامة ترتيب البايتات (BOM) في بداية الملف، أو نص بعلامات اقتباس مفردة. الصق JSON في المُتحقِّق لتحديد الموضع الدقيق.
هل يمكن أن يحتوي JSON على تعليقات؟
لا — تحظر مواصفات JSON (RFC 8259) التعليقات صراحةً. إن احتجت تعليقات في ملفات الإعدادات، استخدم JSONC أو JSON5 محليًا، ثم احذف التعليقات قبل التسلسل.
ما القيمة الجذرية الصحيحة في JSON؟
أي قيمة JSON يمكن أن تكون جذرًا: كائن {} أو مصفوفة [] أو نص أو رقم أو true أو false أو null. عمليًا تستخدم معظم واجهات API كائنًا أو مصفوفةً كجذر، لكن الأنواع الستة جميعها صحيحة من ناحية الصياغة.