منسّق ومدقق JSON

جمّل JSON الفوضوي، أو صغّره للإنتاج، أو اعثر على أخطاء الصياغة بالسطر والعمود بدقة، وكل ذلك بخصوصية في متصفحك.

  • موضع الخطأ بدقة
  • يعمل دون اتصال بعد التحميل
  • لا تُرفع البيانات أبدًا

طريقة استخدام أداة منسّق JSON

  1. الصق JSON أو افتحهالصق JSON من استجابة API أو ملف سجل أو إعدادات، أو افتح ملف ‎.json من جهازك.
  2. اختر خيارات التنسيقاختر مسافتين أو 4 مسافات أو جدولة، ورتّب مفاتيح الكائنات أبجديًا إن شئت.
  3. نسّق أو صغّر أو تحققانقر “تنسيق / تجميل” لنتيجة مقروءة، أو “تصغير” لأصغر حجم، أو “التحقق فقط” لفحص الصياغة.
  4. انسخ أو نزّلانسخ النتيجة إلى الحافظة أو نزّلها كملف ‎.json.

لماذا يستخدم المطورون منسّق JSON هذا

  • تحديد الأخطاء بدقةيعرض JSON غير الصالح سطر المشكلة وعمودها مع تلميح للأخطاء الشائعة مثل علامات الاقتباس المفردة أو الفواصل الزائدة.
  • تجميل وتصغيربدّل بنقرة بين مسافات بادئة مقروءة ونتيجة مضغوطة في سطر واحد.
  • ترتيب المفاتيحيسهّل الترتيب الأبجدي للمفاتيح مقارنة مستندي JSON في أداة مقارنة.
  • خاص بطبيعتهيستخدم التحليل محرك JSON المدمج في متصفحك. لا تغادر الرموز وبيانات العملاء ومفاتيح API جهازك.

ما هو JSON؟

JSON (JavaScript Object Notation) صيغة نصية خفيفة للبيانات المنظمة. هي الطريقة القياسية التي ترسل بها واجهات API البيانات، وتظهر في ملفات الإعدادات وقواعد البيانات مثل MongoDB وفي تبادل البيانات بين كل لغات البرمجة تقريبًا. تتكون من كائنات ({ }) ومصفوفات ([ ]) ونصوص وأرقام وقيم منطقية (true/false) وnull.

تعيد واجهات API عادةً JSON مضغوطًا في سطر واحد لتوفير البيانات. هذا ممتاز للآلات لكنه صعب على البشر. المنسّق يضيف أسطرًا ومسافات بادئة لترى البنية بنظرة واحدة.

أكثر أخطاء الصياغة شيوعًا

JSON أكثر صرامة من JavaScript. هذه الأخطاء التي يجدها المدقق عندنا أكثر من غيرها:

  • علامات اقتباس مفردة. النصوص والمفاتيح تستخدم علامات مزدوجة: {"name": "Ahmed"} لا {'name': 'Ahmed'}.
  • فاصلة في النهاية. الفاصلة بعد العنصر الأخير، كما في [1, 2, 3,]، غير مسموحة.
  • مفاتيح دون علامات اقتباس. {name: "Ahmed"} صحيحة في JavaScript لكنها JSON غير صالح.
  • التعليقات. JSON القياسي لا يعرف التعليقات. احذف أسطر // و/* */.
  • قيم خاصة. undefined وNaN وInfinity غير صالحة. استخدم null أو رقمًا.
  • أحرف دون تهريب. أسطر الانتقال وعلامات الاقتباس المزدوجة داخل النص يجب أن تُكتب \n و\".

النصوص العربية داخل JSON صالحة تمامًا كما هي، ولا تحتاج إلى تحويلها إلى رموز مثل ا.

تنسيق أم ضغط؟

استخدم JSON المنسّق أثناء التطوير ومراجعة ردود API وحفظ ملفات الإعدادات في Git، فالملفات المقروءة تعطي فروقات أوضح. واستخدم JSON المضغوط للإرسال عبر الشبكة أو التخزين في بيئة الإنتاج حيث يهم كل بايت. الضغط يحذف المسافات فقط، والبيانات لا تتغير.

هل من الآمن لصق ردود API هنا؟

نعم. كثير من المنسّقات على الإنترنت ترسل بياناتك إلى خادم، أما هذا فلا: التنسيق والتحقق يتمان داخل المتصفح بمحرك JSON نفسه الذي يستخدمه المتصفح في أي موقع. يمكنك حتى فصل الإنترنت بعد فتح الصفحة وستستمر الأداة في العمل. ومع ذلك، من العادات الجيدة حذف كلمات المرور ومفاتيح API الحقيقية قبل مشاركة أي JSON.

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

هل منسّق JSON هذا مجاني؟
نعم. مجاني بلا حدود استخدام ودون حساب.
هل تُرسل بيانات JSON إلى خادم؟
لا. يحدث كل شيء محليًا في متصفحك، فلا تغادر البيانات السرية مثل الرموز أو سجلات العملاء جهازك.
لماذا يظهر خطأ في JSON الخاص بي مع أنه يعمل في JavaScript؟
JSON مجموعة فرعية أكثر صرامة من صياغة كائنات JavaScript. يتطلب علامات اقتباس مزدوجة حول المفاتيح والنصوص، ولا يسمح بالفواصل الزائدة أو التعليقات أو قيم مثل undefined. تبيّن رسالة الخطأ السطر والعمود الدقيقين لإصلاحه.
ماذا يفعل «ترتيب المفاتيح A–Z»؟
يرتب مفاتيح كل كائن أبجديًا في كل المستويات. أما المصفوفات فتحتفظ بترتيبها، لأن ترتيب العناصر له معنى.
هل هناك حد للحجم؟
لا يوجد حد ثابت. الملفات بحجم عدة ميغابايتات تُنسَّق في نحو ثانية على حاسوب حديث، والحد الوحيد هو ذاكرة المتصفح.