دليل استخدام مدقق JSON
طريقة الاستخدام
- الصق النص في مربع «الصق كود JSON هنا».
- اضغط «تحقق وتنسيق (Pretty)» لعرض الكود بمسافة بادئة من مسافتين لكل مستوى، أو «ضغط (Minify)» لإزالة كل المسافات والأسطر.
- إذا ظهرت «صيغة صحيحة ✓» فاضغط «نسخ النتيجة»، وإن ظهر صندوق الخطأ فاقرأ الرسالة، إذ تذكر غالباً الموضع أو الرمز الذي توقف عنده التحليل.
أشهر أسباب رفض الكود
تعتمد الأداة على المحلل القياسي المدمج في المتصفح، وهو صارم ويطبق مواصفة JSON حرفياً. هذه أخطاء تبدو مقبولة لكنها مرفوضة:
| المكتوب | المشكلة | التصحيح |
|---|
{'city': 'Riyadh'} | علامات اقتباس مفردة | {"city": "Riyadh"} |
{name: "Ali"} | مفتاح بلا اقتباس | {"name": "Ali"} |
[1, 2, 3,] | فاصلة زائدة في النهاية | [1, 2, 3] |
// comment | JSON لا يدعم التعليقات | احذف التعليق |
{"ok": True} | القيم المنطقية بأحرف صغيرة فقط | {"ok": true} |
الخطأ الأخير شائع عند نسخ ناتج من Python، والذي قبله شائع عند نسخ إعدادات من ملفات JavaScript.
سلوكيات خفية يجب أن تعرفها
- الأرقام الطويلة جداً: أي عدد صحيح يتجاوز 9,007,199,254,740,991 يفقد دقته عند التنسيق، فرقم معرّف مثل 12345678901234567890 سيظهر بقيمة مختلفة في الناتج. إذا كانت لديك معرّفات طويلة فاحفظها كنصوص بين علامتي اقتباس.
- المفاتيح المكررة: إذا تكرر المفتاح نفسه في كائن واحد فلن تظهر رسالة خطأ، بل تُعتمد القيمة الأخيرة ويختفي ما قبلها من الناتج.
- النص العربي: يبقى كما هو في الناتج دون تحويله إلى رموز من نوع
\u0627، فيسهل عليك مراجعة الترجمات وملفات اللغة.
مثال على فائدة الضغط
ملف إعدادات منسق حجمه 2,400 حرف قد يصبح بعد الضغط نحو 1,600 حرف، أي توفير قرابة (2,400 − 1,600) ÷ 2,400 ≈ 33%، وتختلف النسبة بحسب عمق التداخل وعدد المسافات. لكن احتفظ بالنسخة المنسقة في مستودع الكود لسهولة المراجعة، واستخدم المضغوطة عند الإرسال فقط.
تنبيه: تحفظ الأداة آخر نص كتبته في ذاكرة متصفحك المحلية، فإذا استخدمت جهازاً مشتركاً مع بيانات حساسة فامسح المربع قبل المغادرة.
مدقق ومنسق JSON: أداة لا غنى عنها للمطورين
يواجه المطورون يومياً الحاجة إلى التأكد من صحة بنية بيانات JSON قبل استخدامها في التطبيقات
أو واجهات برمجة التطبيقات (API). توفر هذه الأداة تحققاً فورياً من صحة الصيغة، وتشير بدقة إلى
مكان الخطأ إن وُجد، كما تنسّق الكود بمسافات بادئة واضحة لتسهيل القراءة.
مميزات الأداة
تعمل الأداة بالكامل داخل متصفحك دون إرسال بياناتك إلى أي خادم خارجي، مما يجعلها آمنة
للاستخدام حتى مع البيانات الحساسة. كما تدعم ضغط JSON (Minify) وتنسيقه (Pretty Print) بضغطة زر.
حالات استخدام شائعة
يستخدمها المطورون لفحص استجابات API، وملفات الإعدادات (config)، وملفات البيانات الكبيرة قبل
دمجها في المشاريع، مما يوفر الوقت ويقلل الأخطاء البرمجية الناتجة عن صيغة غير صحيحة.
أمثلة عملية من الحياة اليومية
- مطور يستقبل استجابة API معقدة ويريد التأكد من خلوها من الأخطاء قبل استخدامها في تطبيقه.
- فحص ملف إعدادات (config.json) قبل رفعه إلى خادم الإنتاج لتفادي تعطل النظام.
- تحويل كود JSON مضغوط وغير مقروء إلى شكل منسق (Pretty Print) لتسهيل المراجعة مع الفريق.
مرادفات ومصطلحات شائعة
يُطلق على هذه العملية أيضاً "تدقيق JSON" أو "JSON Formatter"، وتُعرف عملية الضغط باسم "Minify" وعكسها "Beautify" أو "Pretty Print".
أسئلة شائعة
كيف أتحقق من صحة كود JSON اونلاين؟
الصق الكود في مربع النص، ثم اضغط زر "تحقق وتنسيق"، وستعرض لك الأداة فوراً إن كانت الصيغة صحيحة أو تحدد مكان الخطأ بالضبط.
ما الفرق بين تنسيق JSON وضغطه (Minify)؟
التنسيق (Pretty Print) يضيف مسافات وأسطر جديدة لتسهيل القراءة البشرية، بينما الضغط (Minify) يزيل كل المسافات الزائدة لتقليل حجم الملف عند الإرسال عبر الشبكة.
هل بياناتي آمنة عند استخدام مدقق JSON اونلاين؟
في هذه الأداة تحديداً، تتم كل عمليات التحقق والتنسيق داخل متصفحك مباشرة دون إرسال أي بيانات إلى خادم خارجي.
