منسق JSON والتحقق من الصحة
الصق JSON للتحقق من صحته — تُحدَّد الأخطاء بدقة بالسطر والعمود — ثم نسّقه للقراءة أو صغّره للإرسال.
قراءة ملف JSON لشخص آخر دون أن تفقد صوابك
معظم ملفات JSON التي تصادفها في العمل الفعلي لم تُصمَّم أصلًا لتُقرأ بعين بشرية: تصل استجابة واجهة برمجة تطبيقات في سطر واحد هائل الطول، أو يكون ملف الإعدادات قد صُغِّر أثناء عملية البناء، أو يحمل سجل من سجلات النظام حمولة مضغوطة بداخله. والعادة التي تُثمر هنا بسيطة: الصق أولًا، ثم اقرأ. فبمجرد تنسيق الملف، تكشف لك المسافات البادئة شكل البيانات قبل أن تقرأ قيمة واحدة: عمق التداخل، وأي الأجزاء مصفوفات من عناصر متكررة وأيها إعدادات فردية. وغالبًا ما تجيب هذه اللمحة البنيوية عن السؤال بمفردها، لأن الحقل الذي كنت تبحث عنه يتضح أنه يقبع داخل كائن مختلف عمّا افترضت. لا يتغير شيء في البيانات عند تنسيقها — فقط المسافات البيضاء تتغير — لذا يمكن لصق النسخة المنسَّقة مباشرة في المكان الذي احتاجها دون أي قلق.
حين يكون JSON صالحًا لكنه يبدو خاطئًا رغم ذلك
هناك أمران يُربكان الناس عادة حتى بعد نجاح عملية التحليل. الأول هو JSON داخل JSON: حقل نصي تكون قيمته نفسها جزءًا من JSON مُرمَّز بالهروب، مليئًا بأزواج من الشرطة المائلة العكسية وعلامات الاقتباس. وهذا ليس تلفًا في البيانات — بل نظامٌ ما خزّن مستندًا كنص داخل مستند آخر. انسخ السلسلة الداخلية وحدها ونسّقها بمفردها لقراءتها. أما الأمر الثاني فهو الأرقام الكبيرة. تسمح صيغة JSON نفسها بأعداد صحيحة من أي حجم، لكن لغة JavaScript تخزّن الأرقام كأعداد عشرية بدقة 64 بت، لذا فإن معرّفًا يتجاوز طوله خمسة عشر أو ستة عشر رقمًا قد تتغير أرقامه الأخيرة بصمت عند تحليله. وإذا نسّقتَ حمولة ما وظهر معرّف رقمي طويل مختلفًا اختلافًا طفيفًا، فهذا هو السبب — وهو أيضًا السبب في أن واجهات برمجة التطبيقات المصمَّمة جيدًا ترسل المعرّفات الطويلة كسلاسل نصية.
ما الغرض الحقيقي من «تصغير» الملف
JSON المُصغَّر مُخصَّص للأجهزة والمساحات الضيقة: حمولة تُلصَق داخل أمر curl، أو قيمة تُحشَر في متغيّر بيئة أو عمود واحد من قاعدة بيانات، أو استجابة تريدها أصغر ما يمكن أثناء نقلها عبر الشبكة. ويُعدّ التنسيق والتصغير مرآتين تامتين لبعضهما — يمكنك تحويل البيانات نفسها بينهما طوال اليوم ولن يتغير شيء سوى المسافات البيضاء. وسير عمل مرتّب يجمع بينهما: نسّق للقراءة والتحرير، وصغّر للإرسال. وإذا كانت بياناتك قد بدأت أصلًا كجدول بيانات لا كملف JSON، فإن محول CSV إلى JSON يحوّل الصفوف إلى مصفوفة من الكائنات — ولصق نتيجته هنا طريقة سريعة للتأكد من أنها تُحلَّل بنجاح قبل أن يراها كودك.
المشتبهون المعتادون حين يتعذر تحليل JSON
صيغة JSON أكثر صرامة من JavaScript: يجب أن تكون المفاتيح بين علامتي اقتباس مزدوجتين، ولا فاصلة زائدة بعد العنصر الأخير، ولا تعليقات، ولا علامات اقتباس مفردة. يعمل المدقق هنا أثناء كتابتك ويخبرك بسطر وعمود أول مشكلة يصادفها.
ما الفرق بين «تنسيق» و«تصغير»؟
كلاهما ينتج البيانات نفسها تمامًا. «تنسيق» يضيف المسافات البادئة وفواصل الأسطر ليتمكن البشر من قراءتها؛ أما «تصغير» فيحذف كل حرف غير ضروري ليكون الملف بأصغر حجم ممكن للنقل أو التخزين.
هل يُرسَل JSON الخاص بي إلى أي مكان؟
لا — تعمل هذه الأداة بالكامل داخل متصفحك بلغة JavaScript فقط. لا يُرفع أي شيء، ما يجعلها آمنة أيضًا للبيانات التي تفضّل عدم لصقها في موقع إلكتروني عشوائي.
