كيف تعمل
- ألصق أو افتح JSON الخاص بك.
- اختر تجميل أو تصغير أو ترتيب المفاتيح.
- انسخ النتيجة أو نزّلها.
لماذا تستخدمها
- موقع ورسالة خطأ دقيقان.
- مسافة بادئة بمقدار مسافتين أو أربع أو علامات جدولة.
- يرتّب المفاتيح مع إبقاء قيمك كما هي.
- يتحمّل التعليقات والفواصل الزائدة.
تنسيق JSON والتحقق منه، وإصلاح الأخطاء المعتادة
JSON صالح بنظرة واحدة
الصق JSON أو افتح ملفًا فيُفحص أثناء الكتابة. يحصل JSON الصالح على علامة خضراء ويُعرض منسقًا؛ ويحصل غير الصالح على علامة حمراء، ويُبرز السطر الذي فيه المشكلة في المحرر، ويُسمى السبب، كفاصلة مفقودة أو نهاية غير متوقعة للنص. ولأن شيئًا لا يغادر الصفحة، فهو آمن لاستجابات الواجهات البرمجية وملفات الإعداد والبيانات التي فيها تفاصيل شخصية أو مفاتيح.
الأخطاء التي يرتكبها الجميع تقريبًا
JSON أصرم من JavaScript الذي يشبهه. هذه الخمسة تسبب معظم الملفات غير الصالحة:
| الخطأ | غير صالح | صالح |
|---|---|---|
| فاصلة بعد العنصر الأخير | {"a": 1, "b": 2,} | {"a": 1, "b": 2} |
| علامات اقتباس مفردة | {'name': 'Ada'} | {"name": "Ada"} |
| مفاتيح دون علامات اقتباس | {name: "Ada"} | {"name": "Ada"} |
| التعليقات | {"a": 1 // note} | لا تعليقات في JSON |
| قيم يسمح بها JavaScript | NaN وundefined و0x1F | null، أو رقم عادي |
ملفات إعداد المحررات وأدوات البناء تستخدم غالبًا JSONC، أي JSON مع تعليقات وفواصل زائدة. فعّل السماح بالتعليقات والفواصل الزائدة لقراءتها دون أخطاء؛ والمخرج المنسق يحتفظ حينها بالتعليقات.
التنسيق والتصغير
المسافتان هما الأسلوب الأكثر شيوعًا وتستخدمهما معظم مشاريع JavaScript؛ والأربع مسافات والجدولة شائعة في أماكن أخرى. تصغير يزيل كل مسافة وفاصل سطر خارج السلاسل النصية، فيصنع أصغر نص للإرسال عبر الشبكة أو التخزين في حقل قاعدة بيانات. وترتيب المفاتيح يرتب مفاتيح كل كائن أبجديًا، في كل مستوى، فتصبح مقارنة ملفي JSON في مقارنة النصوص أسهل بكثير.
استكشاف المستندات الكبيرة في الشجرة
يعرض عرض الشجرة الكائنات والمصفوفات كقوائم متداخلة يمكنك طيها وفتحها، مع عدد العناصر في كل منها. انقر مفتاحًا لنسخ مساره، مثل $.data.items[3].price، بأسلوب JSONPath الذي تستخدمه أدوات الاستعلام وأطر اختبار كثيرة. المصفوفات الطويلة تُظهر أول 100 عنصر، مع زر لإظهار المزيد، فتبقى حتى استجابات الواجهات البرمجية الكبيرة سريعة التصفح.
مهام ذات صلة
- تحويل JSON إلى جدول بيانات بـJSON إلى CSV، الذي يسطّح الكائنات المتداخلة إلى أعمدة.
- التحويل إلى YAML أو XML بـJSON إلى YAML وJSON إلى XML.
- قراءة رمز يحتوي JSON بـمُفكّك JWT.
إذا حدث خطأ
- غير صالح لكنه يبدو سليمًا. افحص السطر المُبرز والذي قبله: الفاصلة المفقودة يُبلَّغ عنها حيث تبدأ القيمة التالية.
- علامات اقتباس منحنية. النص المنسوخ من مستند أو دردشة قد يحوّل
"إلى علامات اقتباس طباعية، لا يقبلها JSON. أعد كتابتها. - رقم طويل يبدو مختلفًا في الشجرة. تعرض الشجرة القيم كما يقرؤها JavaScript، الذي لا يحمل أكثر من نحو 16 خانة معنوية بدقة. النص المنسق يحتفظ بكل رقم كما كُتب؛ ومع ذلك فالمعرّفات الطويلة أكثر أمانًا كسلاسل نصية.
أسئلة وأجوبة
كيف أتحقق من صحة JSON؟
ألصقه. إن كان غير صالح، تُظهر رسالة الخطأ سطر وعمود المشكلة.
هل يغيّر التنسيق أرقامي أو نصوصي؟
لا. يعدّل المنسّق المسافات فقط، فتبقى الأرقام الكبيرة ورموز الهروب كما هي تمامًا.
هل تُرسل بياناتي إلى أي مكان؟
لا. كل شيء يُعالَج داخل متصفحك.
أدلة ذات صلة
CSV أم Excel أم JSON: أي صيغة لبياناتك؟
حفظنا الجدول نفسه ذا 100,000 صف بصيغة CSV وكمصنف Excel وبصيغة JSON، ثم قارنا الأحجام وسرعة قراءة كل منها في الشيفرة وما يحدث من أخطاء مع التواريخ والأصفار البادئة والأرقام الطويلة.