ما هو JSON؟
JSON (JavaScript Object Notation) صيغة نصية خفيفة لتبادل البيانات، وهي اللغة المشتركة بين التطبيقات وواجهات البرمجة (APIs) في الويب الحديث. لكن JSON القادم من الخوادم يكون غالبًا مضغوطًا في سطر واحد يصعب قراءته، وأي خطأ صغير كفاصلة زائدة أو علامة تنصيص مفقودة يجعله غير صالح. تساعدك هذه الأداة على قراءة JSON وتصحيحه بسرعة.
ماذا تقدم الأداة؟
- التنسيق (Beautify): إضافة مسافات بادئة وأسطر جديدة بمسافتين أو أربع أو Tab.
- الضغط (Minify): إزالة كل المسافات لتقليل الحجم قبل الإرسال أو التخزين.
- ترتيب المفاتيح: ترتيب مفاتيح الكائنات أبجديًا على كل المستويات لتسهيل المقارنة بين ملفين.
- التحقق (Validate): تحديد موضع الخطأ بالسطر والعمود وتظليل المحرف المسبب له.
- التحويل إلى CSV: تحويل مصفوفة كائنات إلى جدول يفتح في Excel أو Google Sheets.
أخطاء JSON الشائعة
| المشكلة | خطأ | صحيح |
|---|---|---|
| فاصلة زائدة في النهاية | {"a":1,} | {"a":1} |
| علامات تنصيص مفردة | {'a':1} | {"a":1} |
| مفتاح دون تنصيص | {a:1} | {"a":1} |
| تعليقات | // note | JSON لا يدعم التعليقات |
| قيم غير مدعومة | undefined أو NaN | استخدم null |
نصائح للمطورين
- استخدم «ترتيب المفاتيح» قبل مقارنة استجابتين من API لاكتشاف الفروق بسهولة.
- الصيغة المضغوطة مناسبة للإنتاج، والمنسقة مناسبة لملفات الإعدادات والتوثيق.
- لترميز JSON داخل رابط استخدم ترميز الروابط، أو حوّله إلى Base64 بأداة Base64.
🔒 تتم المعالجة داخل متصفحك، فيمكنك تنسيق بيانات حساسة كمفاتيح الإعدادات دون إرسالها إلى أي خادم.
أخطاء JSON الأكثر شيوعًا وكيف تصلحها
معظم أخطاء JSON سببها اختلافات بسيطة عن صيغة كائنات JavaScript. إليك ما يجب الانتباه إليه:
- الفاصلة الزائدة:
{"a":1,}غير صالح؛ احذف الفاصلة بعد آخر عنصر. - علامات الاقتباس المفردة: المفاتيح والنصوص يجب أن تكون بين علامتي اقتباس مزدوجتين
"...". - المفاتيح دون اقتباس:
{name:"Ali"}خطأ، والصحيح{"name":"Ali"}. - التعليقات: JSON القياسي لا يدعم
//ولا/* */. - القيم غير المدعومة:
undefinedوNaNوالدوال غير مسموحة؛ استخدمnull.
تنسيق أم تصغير؟
التنسيق (المسافات البادئة) يجعل الملف مقروءًا للمطورين أثناء التطوير والتصحيح. أما التصغير فيحذف المسافات لتقليل حجم البيانات المرسلة عبر الشبكة في بيئة الإنتاج. ولتحويل البيانات إلى صيغة آمنة للنقل، استخدم أداة Base64.
الأسئلة الشائعة
كيف أعرف مكان الخطأ في JSON؟
تعرض الأداة رقم السطر والعمود ورسالة الخطأ، وتحدد المحرف المسبب للخطأ في مربع الإدخال.
هل تدعم الأداة ملفات JSON كبيرة؟
نعم، يمكن معالجة ملفات بعدة ميغابايتات بسرعة على أغلب الأجهزة.
ما الفرق بين التنسيق والضغط؟
التنسيق يضيف مسافات وأسطرًا لسهولة القراءة، والضغط يحذفها لتقليل الحجم، والبيانات نفسها لا تتغير.
هل يمكن تحويل JSON إلى Excel؟
نعم، استخدم «JSON → CSV» ثم افتح الملف الناتج في Excel.
هل تُرسل بياناتي إلى خادم؟
لا، كل شيء يحدث في متصفحك.
آخر تحديث: