منسق JSON

ما هو منسق JSON؟

JSON (JavaScript Object Notation) هو تنسيق البيانات الأكثر استخدامًا على الويب. تعيده واجهات برمجة التطبيقات، وتستخدمه ملفات الإعداد، وتخزّنه قواعد البيانات. تحافظ مواصفات JSON على البساطة، وهو رائع للآلات، لكنه ليس مثاليًا للقراءة البشرية. يضيف منسق JSON المسافات البادئة والأسطر الجديدة إلى JSON الخام أو المضغوط لتتمكن من رؤية البنية بوضوح.

تعمل هذه الأداة بالكامل في متصفحك. يمر JSON الخاص بك عبر JSON.stringify() مع مسافة بادئة مقدارها مسافتان، وتظهر النتيجة في لوحة الإخراج. لا يتم إرسال أي شيء إلى خادم، لذا يمكن استخدامه بأمان مع بيانات الإنتاج أو الرموز المميزة أو أي شيء لا تريده أن يغادر جهازك.

أمثلة تنسيق JSON

إليك بعض الأمثلة على ما يفعله المنسق. JSON المضغوط صعب القراءة؛ يكشف التنسيق البنية للوهلة الأولى.

انقر على زر تحميل مثال أعلاه لتحميل مثال جاهز (بيانات الخطة الجوالة) في المحرر ورؤية المنسق في العمل.

كيفية استخدام هذه الأداة

كيف يعمل المنسق

كلا المحررين يستخدمان Ace Editor، الذي يوفر تمييزًا بنويًا وأرقام أسطر ومؤشرات أخطاء خاصة بـ JSON. عند لصق أو كتابة JSON في لوحة الإدخال، تنتظر الأداة 300 مللي ثانية (لتجنب التحليل أثناء الكتابة)، ثم تُشغّل JSON.parse() على الإدخال. إذا نجح التحليل، يستدعي JSON.stringify(data, null, 2) ويعرض النتيجة. إذا فشل التحليل، يظهر خطأ.

ملاحظة مهمة: JSON لا يدعم التعليقات. هذا محدد في المواصفات نفسها، وليس قيدًا في هذه الأداة. ملفات مثل settings.json في VS Code تستخدم JSONC (JSON مع تعليقات) وهو تنسيق مختلف. إذا كان ملفك يحتوي على تعليقات، فأنت بحاجة لإزالتها قبل التنسيق.

أين يفيد تنسيق JSON

يحتاج معظم المطورين إلى منسق عند قراءة ردود واجهات برمجة التطبيقات. ترسل طلبًا عبر Postman أو curl، ويعود الرد كسطر مضغوط واحد. لصقه هنا يجعل الكائنات والمصفوفات المتداخلة مرئية فورًا. لاستخراج قيم محددة من ردود كبيرة، يعمل jq بشكل ممتاز من سطر الأوامر.

ملفات الإعداد حالة شائعة أخرى. ملف <code>package.json</code> أو <code>tsconfig.json</code> بمسافات بادئة غير متسقة صعب المراجعة في طلبات السحب. تنسيقه هنا يعطيك نسخة متسقة يمكن لصقها مرة أخرى. إذا احتجت لدمج ملفين من الإعداد، هناك أداة منفصلة دمج JSON لذلك.

صادرات قواعد البيانات من <a href="https://www.mongodb.com/docs/manual/reference/mongodb-extended-json/" target="_blank" rel="noopener">MongoDB</a> وFirestore وCouchDB عادةً ما تكون كتلًا كبيرة من JSON بدون تنسيق. تشغيلها هنا يساعد على فهم بنية المستند قبل كتابة سكريبتات الاستيراد أو الاستعلامات. إذا احتجت البيانات في جدول بيانات، يمكنك استخدام JSON إلى CSV لتحويلها.

مفيد أيضًا قبل مشاركة JSON مع الزملاء. JSON المنسق في رسالة Slack أو تذكرة Jira أسهل في القراءة بكثير من النص المضغوط الخام. تشغيله أولًا عبر مدقق JSON يمكن أن يكشف المشكلات قبل أن يراها أي شخص آخر.

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

أدوات ذات صلة

لمعرفة المزيد عن JSON، يناقش دليل MDN لـ JSON التحليل والتحويل إلى نص. المعيار الرسمي هو RFC 8259. انظر أيضًا json.org وjq.