مدقق JSON
تحقق من بيانات JSON ونسّقها فورًا بهذه الأداة المجانية التي تعمل في المتصفح. افحص بناء الجملة واكتشف الأخطاء وجمّل JSON مباشرة داخل متصفحك.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
ما الذي يجعل JSON صالحًا أو غير صالح
مواصفة JSON (RFC 8259) صارمة بطرق تفاجئ الناس، غالبًا لأنه يشبه JavaScript لكنه ليس JavaScript. فالمفاتيح يجب أن تكون نصوصًا بين علامتي اقتباس مزدوجتين: لا اقتباس مفرد، ولا معرّفات مجردة. والفواصل بعد العنصر الأخير ممنوعة. والتعليقات غير موجودة. والأرقام لا تقبل الأصفار البادئة ولا الصيغة الست عشرية. وNaN وInfinity ليستا قيمًا. والمستند كله يجب أن يكون قيمة واحدة، وبترميز UTF-8.
ويحلل المدقق النص وفق تلك القواعد ويبلغ عن أول موضع ينكسر فيه، مع رقم السطر والعمود. وهذا مهم لأن الإخفاق اللاحق يكون عادةً غامضًا: ملف إعدادات لا يُحمّل، أو نشر يفشل مع تتبع أخطاء يشير إلى محلل، أو واجهة API تعيد الخطأ 400 دون تفسير. والتحقق من المستند أولًا يحوّل إخفاقًا غامضًا إلى إصلاح محدد من حرف واحد.
لماذا أنشأنا هذه الأداة
الملفات المعدّلة يدويًا هي مصدر JSON غير الصالح: ملف تعريف حزمة، أو تعريف خط تكامل مستمر، أو مستند سياسة سحابية، أو ملف ترجمة. فاصلة شاردة واحدة ويتوقف كل شيء.
وتلك الملفات نفسها كثيرًا ما تحمل بيانات دخول وأسماء خوادم داخلية وتفاصيل بنية تحتية. وفحصها لا ينبغي أن يتضمن رفعها إلى أي مكان، لذا يجري مدققنا التحليل داخل متصفحك دون أي اتصال بالشبكة. يبقى مستندك في التبويب، ويُنشأ تقرير الخطأ محليًا، ولا يُخزّن شيء. وهذا يجعله سريعًا بما يكفي لاستخدامه بعفوية، الصق وافحص وأصلح، ويعمل دون اتصال أيضًا.
نصائح وأخطاء شائعة
- لا تعليقات في JSON؛ وسطر
//منسوخ من ملف JavaScript سيفشل التحقق دائمًا. - المفاتيح المكررة مسموحة تقنيًا في القواعد، لكن معظم المحللين يحتفظون بالأخير بصمت، وهذا يخفي أخطاء حقيقية.
- تحقق من ترميز الملف إذا فشل التحقق لمستند يبدو مثاليًا؛ فعلامة ترتيب البايتات في بدايته تُفشل المحللين الصارمين.
- الأرقام بأصفار بادئة، والقيم الست عشرية، وNaN، وInfinity، كلها غير صالحة مهما بدت معقولة.
بداية سريعة: استخدام مدقق JSON
- الصق JSON الذي تريد فحصه في مربع الإدخال أعلاه.
- شغّل التحقق؛ فالمستندات الصالحة تُؤكد فورًا.
- إذا فشل، فاقرأ رقم السطر والعمود في رسالة الخطأ وانتقل إلى ذلك الموضع.
- أصلح المشتبه بهم المعتادين أولًا: الفواصل الزائدة، والاقتباس المفرد، والاقتباس غير المهرّب داخل النصوص.
- أعد التحقق حتى ينجح، ثم انسخ المستند المصحح إلى مكانه.
بعد أن يصبح صالحًا، تجعله أداة منسّق JSON مقروءًا، وتحوّله أداة تحويل JSON إلى YAML للأدوات التي تفضّل YAML.
ما الذي يفحصه التحقق
يؤكد التحقق أن نصك JSON سليم: كل قوس معقوص ومربع مطابق ومغلق، والنصوص بعلامات اقتباس مزدوجة، والمفاتيح والقيم مفصولة بشكل صحيح، ولا توجد فواصل زائدة ممنوعة في النهاية. وإذا كان هناك خلل، يشير المدقق إلى موضعه فلا تبحث عشوائيًا.
الأخطاء التي يقع فيها الجميع
قواعد JSON بسيطة لكنها لا تتسامح. والمتهمون المعتادون:
- الفواصل الزائدة في النهاية. فاصلة بعد آخر عنصر في مصفوفة أو كائن ممنوعة في JSON، مع أن JavaScript تسمح بها. وهذا أكثر الأخطاء شيوعًا على الإطلاق.
- الاقتباس المفرد. يتطلب JSON علامات اقتباس مزدوجة للمفاتيح وقيم النصوص.
'name'غير صالح، و"name"صحيح. - المفاتيح دون اقتباس. مفاتيح الكائنات يجب أن تكون نصوصًا مقتبسة.
{name: "x"}يفشل، و{"name": "x"}ينجح. - فواصل ناقصة بين العناصر، أو فاصلة شاردة حيث لا مكان لها.
- التعليقات. JSON القياسي لا يسمح بتعليقات
//أو/* */إطلاقًا. - أحرف غير مهرّبة داخل النصوص، كسطر جديد خام أو علامة اقتباس غير مهرّبة.
لماذا لا تعتمد على شيفرتك فقط؟
حين يرمي تطبيقك خطأ JSON، يكون في منتصف الانهيار والرسالة عامة غالبًا ("unexpected token"). أما التحقق من النص الخام أولًا فيعزل المشكلة بوضوح قبل أن تصل إلى شيفرتك، ويُظهر الحرف المسبب بدقة.
نسّق وأنت تصلح
لصق JSON الفوضوي في منسّق JSON يجعل الأخطاء البنيوية واضحة بصريًا؛ فالإزاحة تكشف القوس غير المغلق فورًا. تحقق لتجد الخطأ، ونسّق لتراه في سياقه. وبعد التنظيف، تستطيع أداتا تحويل JSON إلى CSV وتحويل JSON إلى YAML تحويله.
استخدامات شائعة
- فحص ملف إعدادات قبل النشر.
- التحقق من حمولة API عدّلتها يدويًا.
- تتبع خطأ «JSON غير صالح» في تطبيقك.