Softonic

مدقّق JSON

خطوة 1 / 2
التحقق من JSON

الصق أي مستند JSON واطّلع على ما إذا كان يُحلَّل بنظافة وفق RFC 8259. يعود الإدخال غير الصالح بالمشكلة الدقيقة، فاصلة زائدة بعد آخر عنصر مصفوفة، مفتاح بلا اقتباس، سلسلة غير مغلقة، علامات اقتباس مفردة حيث يطلب JSON المزدوجة، تسلسلات هروب خاطئة، إضافة إلى السطر والعمود حيث استسلم المحلل. مفيد عند تنقيح استجابة واجهة برمجة تطبيقات، أو ملف إعداد، أو package.json حرّره زميل يدويا، أو ناتج مولّد شيفرة.

كيف يعمل التحقق من JSON

  1. 1

    الصق JSON الخاص بك

    أدرج حمولة أو ملف إعداد أو استجابة واجهة برمجة تطبيقات. المسافات البيضاء جيدة؛ علامات الجدولة والتعليقات ليست كذلك (JSON النقي بلا تعليقات).

  2. 2

    حلّل بمحلل صارم وفق RFC 8259

    يرفض المدقّق أي شيء يحظره المعيار: الفواصل الزائدة، المفاتيح بلا اقتباس، علامات الاقتباس المفردة، `undefined`، الأرقام الست عشرية.

  3. 3

    اقرأ الخطأ

    إذا فشل، تحصل على رسالة المحلل إضافة إلى موضع تقريبي: كاف للانتقال مباشرة إلى الحرف.

  4. 4

    أصلح وأعد التحقق

    صحّح المشكلة، والصق مجددا، وأكّد أن المستند صالح قبل الإيداع أو الإرسال.

ما الذي يسمح به JSON الصارم، وما لا يسمح به

تنتشر الكثير من صيغ “JSON تقريبا” (JSON5، JSONC، HJSON، هجائن شبيهة بـ YAML). معيار JSON نفسه صغير وصارم؛ يخبرك هذا المدقّق بما إذا كان مستندك يصمد أمام محلل صارم، وهو ما تشغّله معظم الأنظمة النهائية فعليا.

قواعد تربك معظم الناس

القاعدة صالح غير صالح
يجب أن تكون المفاتيح سلاسل مزدوجة الاقتباس {"a": 1} {a: 1}
تستخدم السلاسل الاقتباس المزدوج فقط "hello" 'hello'
لا فواصل زائدة [1, 2, 3] [1, 2, 3,]
لا تعليقات (لا شيء) // comment أو /* */
الأرقام: لا + بادئة، لا .5 0.5 +1، .5
القيم المحجوزة فقط true، false، null undefined، NaN
ترميز UTF-8 سلاسل يونيكود تسلسلات بايت غير صالحة

أخطاء شائعة ومعناها

  • “رمز غير متوقع }”، لديك فاصلة زائدة قبل القوس المعقوف المغلق.
  • “اسم خاصية متوقع”، المفتاح بلا اقتباس أو نسيت علامات الاقتباس حول المفتاح الافتتاحي.
  • “نهاية إدخال غير متوقعة”، { أو [ افتتاحي غير مغلق؛ عُدّ الأقواس.
  • “حرف تحكم خاطئ”، علامة جدولة أو سطر جديد أو بايت تحكم آخر داخل سلسلة حرفية. اهرب منها كـ \t، \n، إلخ.
  • “مفتاح مكرر”، ليس خطأ في معيار JSON فعليا (يقول المعيار “ينبغي” أن تكون فريدة)، لكن كثيرا من المدقّقات تحذر منه. يضع المدقّق علامة عليه كملاحظة، لا كفشل صارم.

إذا احتجت صيغا أكثر تساهلا

  • JSON5 يسمح بالفواصل الزائدة والتعليقات وعلامات الاقتباس المفردة. استخدم محلل JSON5 إذا كانت تلك صيغتك المستهدفة.
  • JSONC (JSON بتعليقات) هو ما تستخدمه إعدادات VS Code. جرّد التعليقات قبل التحليل الصارم.
  • YAML صيغة مختلفة؛ لا تفترض أنها “مجرّد JSON بمسافات بادئة”.

نصائح

  • تحقّق قبل الإيداع. خطأ مطبعي في package.json أو إعداد CI يكسر البناء بالكامل حتى يلاحظه أحد.
  • نسّق بشكل جميل بعد التحقق لجعل فروق المراجعة قابلة للقراءة. ملف JSON من سطر واحد صالح لكنه بائس للمراجعة.
  • للحمولات الكبيرة، تحقّق بالتدفّق (jq على سطر الأوامر مثلا). يعاني التحليل داخل المتصفح بعد بضعة ميغابايت.

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

تتحقق هذه الأداة من الصحة النحوية فقط، هل هو JSON سليم البنية؟ للقواعد البنيوية (الحقول المطلوبة، قيم التعداد، أطوال السلاسل)، استخدم مدقّق JSON Schema. الخطوتان متكاملتان: لا جدوى من تشغيل تحقق المخطط على مستند ليس JSON صالحا أصلا.

لأن JSON المعياري بلا تعليقات. // و /* */ امتداد منطقي (JSONC، JSON5) لكن JSON النقي يرفضها. جرّد التعليقات قبل الإرسال إلى مستهلك صارم، أو اعتمد JSON5 عبر منظومتك.

غير صالحة في JSON الصارم. يسمح المعيار بالأرقام المنتهية فقط. سلسلها كنصوص ("NaN"، "Infinity") أو كـ null، حسب كيفية تعامل مستهلكك مع البيانات المفقودة.

لا، يجري التحقق في متصفحك، فالحمولة التي تلصقها لا تغادر الصفحة أبدا. آمن لملفات الإعداد الحساسة واستجابات الواجهات البرمجية التي تحتوي اعتمادات.

أدوات ذات صلة

مرجع جدول ASCII

جدول ASCII كامل من 0 إلى 127 مع التمثيل العشري والست عشري والثماني والثنائي والمرجع الرقمي في HTML لكل محرف، بما في ذلك أكواد التحكم مثل NUL وLF وDEL.

مرجع أحرف HTML

قائمة قابلة للبحث بكيانات HTML، مع رموزها المسمّاة والرقمية، بالإضافة إلى خيار النسخ بنقرة واحدة للأحرف والرموز الخاصة.

مرجع اختصارات لوحة المفاتيح

ابحث في الاختصارات الافتراضية الموثقة لـ VS Code وChrome وBash مع GNU Readline على macOS وWindows وLinux.

مولد EditorConfig

أنشئ ملف .editorconfig بقواعد نمط المسافة البادئة وحجمها ونهاية السطر ومجموعة الأحرف والمسافات البيضاء، لتنسيق موحّد عبر بيئات التطوير المتكاملة (IDEs) والمحررات.

مدقق البريد الإلكتروني

تحقق من عنوان بريد إلكتروني: فحص صياغة RFC 5322، واستعلام حي عن سجل MX، بالإضافة إلى تفاصيل الجزء المحلي والنطاق والطول. لا يتم إرسال أي بريد.

ورقة مرجعية سريعة لـ Markdown

مرجع Markdown عملي مع معاينات فعلية وأمثلة جاهزة للنسخ للعناوين والقوائم والجداول والكود والروابط والصور وصياغة GFM.

الأداة متاحة بلغات أخرى