ما الذي يقدمه منسق ومُتحقق JSON؟
يساعدك منسق ومُتحقق JSON على تنظيف والتحقق من JSON المستخدم في واجهات API وملفات الإعدادات وبيانات التطبيقات. يمكنك لصق أي JSON ثم تنسيقه ليكون أكثر قابلية للقراءة (Pretty Print) أو ضغطه ليكون أصغر حجماً (Minify) مع التحقق في الوقت نفسه من صحة الصياغة.
عندما يكون JSON صحيح الصياغة، تقوم الأداة بتنسيقه وفق الوضع الذي اخترته. وإذا كانت هناك أخطاء في الصياغة، فسترى رسالة خطأ واضحة مع موضع المحرف تقريباً ورقم السطر والعمود لتعرف بدقة أين تبحث عن المشكلة.
كيف يعمل التحقق من JSON؟
عند النقر على “تنسيق JSON والتحقق منه” تقوم الأداة بما يلي:
- تقرأ النص من مربع الإدخال (textarea) الذي أدخلته أو لصقته.
- تشغّل عملية تحليل JSON للتحقق مما إذا كانت الصياغة صحيحة أم لا.
- إذا كان JSON صحيحاً، يتم تنسيقه وفق الوضع الذي اخترته: تنسيق مقروء (Pretty Print) متعدد الأسطر أو تنسيق مضغوط (Minify) في سطر واحد.
- إذا كان JSON غير صحيح، يتم عرض رسالة خطأ تتضمن موضع المحرف بالإضافة إلى رقم السطر والعمود تقريبياً لمساعدتك على إصلاح الخطأ بسرعة.
يوضّح مربع الملخص على الجانب الأيمن ما إذا كان JSON صحيحاً، وعدد المحارف والأسطر قبل التنسيق وبعده.
الفرق بين JSON المنسّق و JSON المضغوط
JSON المنسّق (Pretty) يتم عرضه مع مسافات وتباعد أسطر، مما يجعله أسهل في القراءة والمراجعة من قبل المطورين. هذا الوضع مثالي عند فحص استجابات API أو مراجعة الحمولة (Payload) أو مشاركة أمثلة مع فريقك.
JSON المضغوط (Minified) يزيل الفراغات وفواصل الأسطر غير الضرورية. هذا مفيد عندما تحتاج إلى حمولة أصغر في بيئة الإنتاج، أو عند تضمين JSON في HTML/JS، أو عند إرسال بيانات مضغوطة عبر الشبكة.
متى تستخدم هذه الأداة؟
تكون أداة منسق ومُتحقق JSON مفيدة بشكل خاص عندما تقوم بـ:
- تصحيح استجابات API القادمة من REST أو GraphQL أو غيرها.
- مراجعة ملفات الإعداد (config JSON) قبل نشرها إلى بيئة الإنتاج.
- التحقق من حمولة الطلب المنسوخة من أدوات المتصفح (DevTools) أو سجلات النظام.
- تنظيف مقاطع JSON قبل إضافتها إلى الوثائق أو الشروحات أو الدروس.
نصائح للحصول على أفضل نتيجة
- تأكد أن بياناتك JSON وليست كائناً في JavaScript. قم بإزالة التعليقات وعلامات الفواصل الزائدة (Trailing Commas) واستخدام علامات اقتباس مزدوجة بدلاً من الأحادية، لأن هذه الأمور غير مسموح بها في JSON الصارم.
- استخدم الوضع المنسّق (Pretty) أثناء التصحيح ثم انتقل إلى الوضع المضغوط (Minify) عندما تكون جاهزاً لإرسال البيانات إلى الإنتاج.
- استخدم زر “نسخ النتيجة” لنسخ JSON المنسّق بسرعة إلى محرر الشفرة أو عميل API الخاص بك.
- استخدم “تبديل الإدخال والنتيجة” لتشغيل الأداة مرة أخرى أو التبديل بين Pretty و Minify دون الحاجة للنسخ واللصق من جديد.
استخدم هذه الأداة كلما احتجت إلى طريقة سريعة تعمل من المتصفح فقط لتنسيق JSON والتحقق من صحته لاستجابات API وملفات الإعدادات وبيانات التطبيقات.