Toolerfly Toolerfly

منسّق JSON ومدقق

نسّق JSON أو صغّره أو افحصه، واحصل على رسالة خطأ بالعربية تحدد السطر والعمود بدقة.

  • رسائل خطأ بالعربية مع السطر والعمود وزر للانتقال إلى موضع الخطأ
  • يحافظ على ترتيب الحقول وعلى الأرقام الكبيرة كما كُتبت
  • يكشف الحقول المكررة والأرقام التي قد تفقد دقتها

أداة منسّق JSON ومدقق

طريقة الاستخدام

  1. الصق نص JSON في خانة الإدخال أو اضغط «مثال» لتجربة الأداة.
  2. اختر المسافة البادئة (مسافتان أو أربع أو Tab) وفعّل ترتيب الحقول أبجدياً إن أردت.
  3. اضغط «تنسيق» لعرضه مقروءاً، أو «تصغير» لضغطه في سطر واحد، أو «تحقق» لفحصه فقط.
  4. إذا ظهر خطأ فاقرأ الرسالة واضغط «اذهب إلى الخطأ» لينتقل المؤشر إلى موضعه، ثم انسخ النتيجة أو نزّلها.

كيف تعمل الأداة؟

تقرأ الأداة النص بمحلل صارم يتبع مواصفة JSON (RFC 8259) حرفاً بحرف. عند أول مخالفة يتوقف ويخبرك بنوعها وموضعها، بدلاً من الرسالة العامة التي تعيدها المتصفحات والتي تختلف من متصفح لآخر.

ولأن المحلل يحتفظ بالنص الأصلي لكل قيمة، فإن التنسيق لا يغيّر شيئاً سوى المسافات وكسر الأسطر. تبقى الحقول بترتيبها الأصلي، وتبقى الأرقام الكبيرة كما كُتبت، ويبقى النص العربي كما هو. وهذا يختلف عن الأدوات التي تحوّل النص إلى كائن ثم تكتبه من جديد، فقد تعيد ترتيب الحقول الرقمية أو تقرّب الأرقام الطويلة.

التصغير يزيل كل مسافة غير ضرورية فيتقلص الحجم، ويفيد في إرسال البيانات وتخزينها. أما الترتيب الأبجدي للحقول فاختياري، ويفيد عند مقارنة ملفين لأنه يجعل ترتيب الحقول موحداً.

أمثلة عملية

تنسيق استجابة من واجهة برمجية

نسخت استجابة API في سطر واحد وتريد قراءتها.

  • {"user":{"name":"سارة","age":28},"tags":["مطور","مصممة"]}
  1. اضغط «تنسيق» بمسافتين

النتيجةيظهر الكائن موزعاً على أسطر بمسافات بادئة، ويبقى الاسم العربي كما هو.

اكتشاف الفاصلة الزائدة

تحصل على خطأ عند تحليل الملف في تطبيقك.

  • {"name": "علي", "city": "الرياض",}
  1. اضغط «تحقق»

النتيجةتظهر الرسالة: فاصلة زائدة قبل «}» — لا يسمح JSON بفاصلة بعد آخر عنصر، مع السطر والعمود.

هذا من أكثر الأخطاء شيوعاً لمن يعتاد على صيغ تتسامح مع الفاصلة الأخيرة.

تصغير ملف إعدادات

تريد تقليل حجم ملف إعدادات قبل نشره.

  • ملف من 120 سطراً مكتوباً بمسافات بادئة
  1. اضغط «تصغير»
  2. قارن الحجمين المعروضين قبل وبعد

النتيجةيظهر ملف من سطر واحد، ويُعرض مقدار التوفير بالبايت.

أرقام أطول من دقة JavaScript

يحتوي ملفك على معرّف رقمي طويل من 20 خانة.

  • {"id": 12345678901234567890}
  1. اضغط «تنسيق»

النتيجةيبقى الرقم كما كُتب، وتظهر ملاحظة بأن بعض اللغات قد تفقد دقته عند قراءته.

استخدامات عملية

  • تصحيح أخطاء الواجهات البرمجية

    قراءة استجابات الخادم وتحديد سبب فشل تحليلها.

  • ملفات الإعدادات

    فحص ملفات التهيئة قبل نشرها وتوحيد تنسيقها بين أعضاء الفريق.

  • مقارنة الملفات

    ترتيب الحقول أبجدياً لتظهر الفروق الحقيقية عند المقارنة.

  • تقليل حجم البيانات

    تصغير JSON قبل تخزينه أو إرساله.

  • التعلم

    فهم أخطاء الصيغة من خلال رسائل واضحة بالعربية.

الدقة والقيود

  • ما يقبله JSON وما لا يقبله: لا يسمح JSON بالتعليقات ولا بعلامات الاقتباس المفردة ولا بالفاصلة بعد آخر عنصر ولا بأسماء حقول بلا اقتباس. هذه كلها تُقبل في كائنات JavaScript العادية فتُظن صحيحة، لكنها ليست JSON صالحاً.

  • الحقول المكررة: تسمح المواصفة بتكرار اسم الحقل لكن سلوكه غير محدد، وتعتمد أغلب اللغات القيمة الأخيرة. تحذرك الأداة منه لأنه غالباً خطأ.

  • الأرقام الكبيرة: تقرأ لغات مثل JavaScript الأرقام بدقة تقارب 15 خانة معنوية. الأداة نفسها لا تُغيّر الرقم، لكن البرنامج الذي سيقرأ ملفك قد يقرّبه.

  • حجم النص: تعمل الأداة في المتصفح، فتتأثر السرعة بحجم النص وقوة جهازك، وقد يبطؤ الجهاز مع الملفات الكبيرة جداً. للملفات الضخمة استخدم أداة سطر أوامر محلية.

الأسئلة الشائعة

كيف أتحقق من صحة JSON؟
الصق النص واضغط «تحقق». إذا كان صالحاً تظهر رسالة نجاح مع عدد الحقول وعمق التداخل. وإن كان فيه خطأ تظهر رسالة بالعربية تحدد نوعه وسطره وعموده.
ما الفرق بين التنسيق والتصغير؟
التنسيق يضيف مسافات وأسطراً ليسهل قراءة الملف. والتصغير يحذفها لتقليل الحجم. المحتوى نفسه لا يتغير في الحالتين، ويمكنك التبديل بينهما متى شئت.
لماذا يرفض المحلل JSON الذي كتبته بعلامات اقتباس مفردة؟
لأن مواصفة JSON تشترط علامات الاقتباس المزدوجة لأسماء الحقول والنصوص. استبدل (') بـ (") وسيعمل الملف.
هل تغيّر الأداة ترتيب الحقول أو الأرقام؟
لا. تحتفظ الأداة بالنص الأصلي لكل قيمة وبترتيب الحقول. لا يتغير الترتيب إلا إذا فعّلت خيار الترتيب الأبجدي صراحة.
هل يدعم النصوص العربية؟
نعم. تبقى النصوص العربية داخل القيم وأسماء الحقول كما هي دون أي تحويل، وتُعرض الشيفرة من اليسار إلى اليمين في منطقة الكود.
هل يُرسل نص JSON الذي ألصقه إلى خادم؟
لا. يُعالج النص بالكامل داخل متصفحك، ولا يُرفع أي جزء منه إلى خادم، لذلك يمكنك لصق بيانات اختبار دون قلق من خروجها من جهازك. ننصح مع ذلك بعدم لصق أسرار حقيقية مثل مفاتيح الإنتاج في أي أداة.

الخصوصية

يُعالج النص داخل متصفحك، ولا يُرسل أي جزء منه إلى خادم.

↑ ↓ للتنقل، Enter للفتح، Esc للإغلاق