شرح عملي
كيف تنسّق JSON عبر الإنترنت
غالباً ما يكون JSON الخام من استجابة واجهة برمجة أو ملف إعدادات مصغّراً في سطر واحد طويل. وقراءته أو تنقيحه أو تحريره في تلك الحالة مرهقة. يوضّح هذا الدليل كيفية تجميل JSON بمسافات بادئة صحيحة في ثلاث نقرات، والتحقّق منه بحثاً عن أخطاء الصياغة، وتصغيره مجدداً عند الحاجة، مع تشغيل كل شيء داخل متصفحك ودون أن تغادر بياناتك علامة تبويبك.
خطوة بخطوة
- افتح مُنسّق JSON والصق JSON الخاص بك في اللوحة اليسرى. يمكنك اللصق مباشرةً من الحافظة (Ctrl+V)، أو من استجابة curl في سطر الأوامر، أو من أي محرّر نصوص. يقبل الإدخال أي حجم ضمن حد الأداة.
- اختر الوضع. تنسيق يضيف مسافات بادئة (مسافتان أو 4، باختيارك)؛ وتحقّق يفحص الصياغة فقط دون تعديل JSON؛ وتصغير يزيل كل المسافات البيضاء لإنتاج أصغر مخرج ممكن. ولمعظم الاستخدامات، تنسيق هو ما تريده.
- انقر على تشغيل. يظهر المخرج المُنسَّق في اللوحة اليمنى. انسخه بزر النسخ والصقه في محرّرك أو ملف الإعدادات. تعرض الأداة عدد الأسطر وعدد الأحرف لتتمكّن من التحقّق من حجم المخرج بنظرة سريعة.
قراءة رسائل الخطأ
حين يحتوي JSON على خطأ في الصياغة، يعرض المُنسّق الخطأ مع موضع (سطر وعمود) يشير إلى الحرف المحدّد الذي أفسد التحليل. أكثر الأسباب شيوعاً: فاصلة زائدة بعد آخر عنصر في مصفوفة أو كائن (صالحة في JavaScript لكن لا في JSON)، أو قوس إغلاق ناقص أو زائد، أو مفتاح غير محاط بعلامتي اقتباس مزدوجتين، أو حرف خاص غير مُهرَّب داخل سلسلة نصية. أصلِح الموضع المُؤشَّر وشغّل مجدداً.
JSON وYAML وCSV: متى تستخدم كلاً منها
يُعدّ JSON المعيار لاستجابات واجهات البرمجة وملفات الإعدادات التي يستهلكها الكود. ويُفضَّل YAML للإعدادات المُحرَّرة يدوياً (ترقيم أقل، ويدعم التعليقات). وأما CSV فالأفضل للبيانات الجدولية التي تستهلكها برامج الجداول. ويتيح لك محوّل البيانات على هذا الموقع التحويل بين هذه الصيغ الثلاث في خطوة واحدة: الصق JSON، وانقر على تحويل، فتحصل على YAML أو CSV. كما يُفيد JSON المصغّر حين تحتاج إلى تضمين بيانات في معامل استعلام URL أو في ترويسة HTTP ذات حد للحجم.
الأدوات المستخدمة في هذا الدليل
الأسئلة الشائعة
هل يُرسَل JSON الخاص بي إلى أي خادم؟
لا. يعمل المُنسّق بالكامل داخل متصفحك. يُحلَّل JSON الخاص بك بدالة JSON.parse الأصلية في المتصفح ويُبنى المخرج في الذاكرة: لا شيء يعبر الشبكة. وهذا مهم حين يحتوي JSON على مفاتيح واجهات برمجة أو رموز وصول أو بيانات داخلية أو معلومات شخصية، وهو أمر شائع في سير عمل تنقيح واجهات البرمجة.
ما الحجم الأقصى الذي يمكنني لصقه؟
يقبل المُنسّق JSON حتى 5 ميغابايت. أما بعد ذلك، فإن التحليل على الخيط الرئيسي سيجمّد علامة تبويب المتصفح دون أي تغذية راجعة. ولملفات JSON الأكبر، استخدم أداة سطح مكتب مخصّصة مثل jq في سطر الأوامر (jq . file.json)، التي تتعامل مع مئات الميغابايتات دون مشكلة.