عن أداة منسّق ومدقّق JSON
JSON هي الصيغة الأكثر استخداماً لتبادل البيانات بين المواقع والتطبيقات وواجهات API، لكنها تصل غالباً في سطر واحد طويل يصعب قراءته، أو فيها فاصلة ناقصة تكسر التطبيق كله. هذه الأداة تحل المشكلتين: تلصق كود JSON في المربع أو تفتح ملفاً من جهازك، ثم تضغط «تنسيق» لترتيبه بمسافتين أو أربع أو بعلامة Tab لكل مستوى، أو «ضغط» لإزالة كل المسافات وجعله سطراً واحداً أصغر حجماً. تظهر النتيجة في المربع نفسه، وتحت المربع رسالة خضراء إذا كان الكود صحيحاً، أو رسالة خطأ تذكر رقم السطر والعمود إذا لم يكن، وتنبهك الأداة أيضاً إلى المفاتيح المكررة والأرقام الكبيرة التي تفقد دقتها. ثم تنسخ النتيجة أو تنزّلها ملفاً.
التحقق يتم بالمحلل المدمج في المتصفح، وهو يتبع معيار JSON بدقة، فلا يقبل التعليقات ولا الفواصل الزائدة في آخر القوائم ولا علامات التنصيص المفردة. ورسالة الخطأ تأتي من المتصفح نفسه، وتذكر غالباً موضع المشكلة التقريبي. الأداة مفيدة للمطورين ومختبري الواجهات ومن يعدّل ملفات الإعدادات، وتعمل بالكامل داخل متصفحك، فلا تُرسل بياناتك، حتى لو كانت تحتوي مفاتيح أو معلومات عملاء، إلى أي خادم.
لماذا تستخدم هذه الأداة؟
- تنسيق واضح بمسافتين لكل مستوى يجعل البيانات المتداخلة سهلة القراءة.
- ضغط إلى سطر واحد لتقليل الحجم قبل الإرسال أو التخزين.
- تحقق فوري من الصحة مع رسالة الخطأ التي يعطيها المتصفح.
- أزرار للنسخ والمسح لتسريع العمل.
- بياناتك لا تغادر جهازك، وهذا مهم مع ردود API الحساسة.
طريقة الاستخدام
الصق كود JSON
الصق الكود في المربع، سواء كان رد API أو محتوى ملف إعدادات أو بيانات منسوخة من سجل.
اضغط تنسيق أو ضغط
«تنسيق (Format)» يرتب الكود بمسافات وأسطر، و«ضغط (Minify)» يحوّله إلى سطر واحد بدون مسافات.
اقرأ رسالة الحالة
إذا كان الكود صحيحاً تظهر رسالة نجاح ويُستبدل محتوى المربع بالنتيجة. وإذا كان فيه خطأ تظهر رسالة توضحه ويبقى الكود كما هو.
انسخ أو امسح
اضغط «نسخ» لنقل النتيجة إلى الحافظة، أو «مسح» لتفريغ المربع والبدء من جديد.
أمثلة عملية
قراءة رد API
رد من واجهة متجر جاء في سطر واحد بطول 3,000 حرف. بعد التنسيق يظهر بمستوياته، فترى بسهولة أن الحقل price داخل كائن variants وليس في المستوى الأول.
اكتشاف فاصلة زائدة
ملف إعدادات فيه قائمة تنتهي بـ "blue", ثم قوس الإغلاق. عند الضغط على تنسيق تظهر رسالة خطأ، فتحذف الفاصلة الأخيرة ويصبح الكود صالحاً.
تجهيز بيانات للإرسال
كائن منسق في 40 سطراً تريد وضعه في متغير بيئة أو طلب HTTP. تضغط «ضغط» فيصبح سطراً واحداً بدون مسافات، ثم تنسخه.
تصحيح علامات التنصيص
نسخت كائناً من كود JavaScript فيه {'name': 'Ali'}. يرفضه المدقق لأن JSON يتطلب علامات تنصيص مزدوجة، فتعدّله إلى {"name": "Ali"}.
| الخطأ | مثال خاطئ | الصحيح |
|---|---|---|
| فاصلة بعد آخر عنصر | [1, 2, 3,] | [1, 2, 3] |
| علامات تنصيص مفردة | {'a': 1} | {"a": 1} |
| مفتاح بلا تنصيص | {a: 1} | {"a": 1} |
| تعليقات داخل الكود | {"a": 1 // note} | {"a": 1} |
| قيمة undefined | {"a": undefined} | {"a": null} |
نصائح مهمة
- رسالة الخطأ تذكر رقم السطر والعمود، فابحث عن المشكلة عنده أو قبله مباشرة، فالخطأ غالباً في الفاصلة أو القوس السابق.
- الأعداد الصحيحة الكبيرة جداً، مثل المعرفات الأطول من 15 رقماً، قد تتغير آخر أرقامها عند التنسيق، فاحفظها كنص إذا كانت معرفات.
- إذا تكرر المفتاح نفسه في كائن واحد تنبهك الأداة، لأن القيمة الأخيرة فقط تبقى بعد التنسيق.
- رموز يونيكود المكتوبة بصيغة \u0627 تظهر بعد التنسيق حروفاً عادية، والمعنى لا يتغير.
- احتفظ بنسخة من الكود الأصلي قبل التجربة، لأن النتيجة تحل محله في المربع نفسه.
التنسيق والتحقق يتمان داخل متصفحك عبر جافاسكريبت، ولا تُرسل بياناتك إلى أي خادم.
الأسئلة الشائعة
كيف أعرف أن JSON غير صحيح؟
اضغط «تنسيق» أو «ضغط». إذا كان الكود غير صالح تظهر رسالة حمراء تبدأ بكلمة خطأ مع وصف من المتصفح، وغالباً مع موضع المشكلة التقريبي.
ما الفرق بين التنسيق والضغط؟
التنسيق يضيف أسطراً ومسافتين لكل مستوى لتسهل القراءة. والضغط يحذف كل المسافات والأسطر غير الضرورية لتقليل الحجم، والبيانات نفسها لا تتغير.
هل تُرسل بياناتي إلى سيرفر؟
لا. الأداة تستخدم المحلل المدمج في متصفحك، فلا تغادر البيانات جهازك.
هل يقبل التعليقات والفواصل الزائدة؟
لا. الأداة تتبع معيار JSON الصارم، والتعليقات والفواصل بعد آخر عنصر غير مسموحة فيه، فستظهر رسالة خطأ.
لماذا تغيرت آخر أرقام عدد كبير؟
لأن الأعداد في جافاسكريبت لها دقة محدودة، فالأعداد الصحيحة الأكبر من نحو 9 كوادريليون تُقرَّب. ضع المعرفات الطويلة بين علامات تنصيص لتبقى نصاً.
هل يغير التنسيق ترتيب المفاتيح؟
يحافظ غالباً على الترتيب، لكن المفاتيح التي هي أعداد صحيحة مثل "1" و"20" تنتقل إلى أول الكائن بترتيب تصاعدي، وهذا سلوك جافاسكريبت المعتاد.
هل يصلح الكود الخاطئ تلقائياً؟
لا، الأداة تكتشف الخطأ وتعرض رسالته، والتصحيح يكون يدوياً. جدول الأخطاء الشائعة في هذه الصفحة يساعدك على معرفة السبب.
هل يدعم النص العربي داخل JSON؟
نعم، القيم العربية تُحفظ كما هي، والرموز المكتوبة بصيغة \u تظهر حروفاً مقروءة بعد التنسيق.
هل يمكن اختيار عدد المسافات؟
نعم، اختر مسافتين أو 4 مسافات أو علامة Tab من قائمة المسافة البادئة قبل التنسيق.
هل يمكنني فتح ملف JSON مباشرة؟
نعم، اضغط زر فتح الملف واختر ملف .json من جهازك، فيظهر محتواه في المربع ويمكنك تنسيقه ثم تنزيله.
ماذا يفعل زر المسح؟
يفرّغ المربع ويخفي رسالة الحالة، فتبدأ بكود جديد.
هل توجد أداة لتحويل JSON إلى CSV أو YAML؟
نعم، في قسم أدوات المطورين في أدواتي توجد أدوات لتحويل JSON إلى CSV وإلى YAML والعكس.
لماذا تشير رسالة الخطأ إلى سطر يبدو صحيحاً؟
لأن الأداة تذكر الموضع الذي اكتشفت فيه المشكلة، وسببها يكون غالباً قبله: فاصلة ناقصة في نهاية السطر السابق، أو قوس لم يُغلق، أو علامة تنصيص مفتوحة. ابدأ البحث من السطر المذكور ثم انتقل إلى ما قبله.
هل يقبل المحرر علامات التنصيص المفردة أو قيماً مثل undefined؟
لا. معيار JSON يشترط علامات تنصيص مزدوجة حول المفاتيح والنصوص، ولا يعرف القيم undefined وNaN وInfinity. هذه الصيغ مقبولة في JavaScript فقط، فاستبدل بها null أو رقماً عادياً قبل التنسيق.
آخر تحديث: