كيفية تنسيق وتحقق من JSON أونلاين

JSON (JavaScript Object Notation) هو أكثر صيغ تبادل البيانات استخداماً في العالم. أنشأه Douglas Crockford في أوائل الألفية، وأصبح المعيار الفعلي لواجهات API الويب وملفات التكوين وقواعد بيانات NoSQL وتخزين البيانات المهيكلة.

شعبيته تعود لبساطته: قابل للقراءة من البشر، سهل التحليل للآلات، خفيف الحجم، ومدعوم أصلاً من JavaScript (لغة الويب). اليوم، تقريباً كل تطبيق ويب حديث يستخدم JSON للتواصل بين الواجهة الأمامية والخلفية.

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

الفاصلة النهائية (trailing comma). الخطأ رقم 1. في JavaScript، {"a": 1, "b": 2,} صالح. في JSON الصارم، هذه الفاصلة النهائية ممنوعة.

علامات اقتباس مفردة. JSON يقبل فقط علامات الاقتباس المزدوجة. {'name': 'John'} غير صالح — يجب أن يكون {"name": "John"}.

التعليقات. JSON لا يدعم التعليقات. لا // ولا /* */. إذا كنت بحاجة لتعليقات، استخدم JSON5 أو JSONC.

مفاتيح بدون اقتباس. {name: "John"} هو JavaScript وليس JSON. المفاتيح يجب أن تكون بين علامات اقتباس مزدوجة.

أحرف التحكم. فواصل الأسطر الحرفية في النصوص ممنوعة. استخدم \n بدلاً من ذلك.

NaN، Infinity، undefined. هذه القيم JavaScript ليست قيم JSON صالحة. استخدم null بدلاً من ذلك.

الخطوة 1: الصق JSON الخاص بك. انسخ والصق JSON الخام في المحرر. يتم تحليل الكود تلقائياً في الوقت الحقيقي.

الخطوة 2: كشف الأخطاء. أخطاء البناء يتم تمييزها مع رسالة توضيحية. الأداة تحدد السطر والموقع الدقيق لكل خطأ.

الخطوة 3: تنسيق تلقائي. انقر على "تنسيق" لترتيب JSON بشكل صحيح. اختر بين 2 أو 4 مسافات للترتيب.

الخطوة 4: انسخ أو حمّل. احصل على JSON المنسّق بنقرة واحدة. كل شيء يحدث في متصفحك.

سمِّ مفاتيحك بـ camelCase. firstName بدلاً من first_name أو FirstName. هذه أكثر اصطلاحات APIs شيوعاً.

استخدم أنواعاً متسقة. إذا كان الحقل رقماً، لا تضعه بين علامات اقتباس. "age": 25 وليس "age": "25".

تجنب مستويات التداخل المفرطة. أكثر من 4-5 مستويات عمق يجعل JSON صعب القراءة والصيانة.

استخدم المصفوفات للقوائم. حتى لو احتوت القائمة على عنصر واحد، فضّل المصفوفة للاتساق.

وثّق بنيتك. استخدم JSON Schema لتعريف والتحقق من البنية المتوقعة لبياناتك.

APIs REST. JSON هو الصيغة الافتراضية لجميع APIs الحديثة تقريباً. استجابات API هي JSON، وأجسام طلبات POST/PUT أيضاً.

التكوين. package.json (Node.js)، tsconfig.json (TypeScript)، .eslintrc.json — ملفات التكوين الحديثة تستخدم JSON بكثافة.

قواعد البيانات. MongoDB يخزن مستندات BSON (JSON ثنائي). PostgreSQL لديه نوع JSONB أصلي. Firebase Realtime Database هي أساساً شجرة JSON عملاقة.

التحويل. CSV ↔ JSON هي واحدة من أكثر التحويلات شيوعاً. Allplix يقدم أدوات مخصصة لهذه التحويلات في كلا الاتجاهين.