مُنظّم JSON
قم بلصق كتلة بيانات JSON — سواء كانت مختصرة، أو تحتوي على رموز تحوط، أو مستمدة مباشرة من سطر سجل — وعرضها بصيغة مرتبة بدقة وفق حجم الانكماش الذي تختاره. يتحقق النظام من صحة البيانات أثناء التحليل ويُظهر الخط والعمود الدقيقين لأي خطأ. كما يمكن ترتيب مفاتيح الكائنات بشكل أبجدي اختياريًا، مما يجعل فروق الاستجابات بين استدعاءين عبر واجهة برمجة التطبيقات (API) أسهل قراءتها بكثير.
كيفية تنسيق بيانات JSON
-
1
لصق بيانات JSON
سواء كان مُصغَّرًا، أو قد تسلل داخل سلسلة نصية، أو مُلفَّ في دالة استدعاء JSONP، فإن المحلل يقوم بتحليله بالكامل.
-
2
حدد مستوى التدرج
مساحتان، أربع مساحات، علامة تبويب، أو نسخة مدمجة (خط واحد للحمولات الصغيرة).
-
3
تبديل ترتيب المفاتيح
قم بترتيب مفاتيح الكائنات حسب الترتيب الأبجدي لتسهيل مقارنة الاستجابتين.
-
4
قم بنسخه أو تنزيله.
قم بنسخ المحتوى إلى الحافظة بنقرة واحدة، أو حفظه كملف `.json`.
ما يُعالجه مُنظّم التنسيق
- إدخال مُصغَّر: يصبح النص
{"a":1,"b":[1,2,3]}مُدرجًا بشكل صحيح مع تبويب مناسب. - JSON المفروش في سلاسل نصية: يمكن فك تغليف سلسلة نصية JSON تحتوي على
"{\"nested\":true}"وتنظيمها بشكل مناسب. - استدعاءات JSONP: تم تبسيط الملف
callback({...})ليصبح فقط{...}. - قائمة المكونات (BOM) والمساحات الفارغة المتقدمة: تم إزالتها تلقائيًا.
- التعليقات: تُسمح باستخدام ملفات بصيغة JSONC من نوع
//و/* */في وضع “مرن”, لكنها تُزال من الناتج النهائي (حيث لا يحتوي JSON الصارم على تعليقات).
لماذا يُستخدم تنسيق JSON ذو المظهر الجميل؟
- Diffing: مستند JSON مكوَّن من سطر واحد يحتوي على آلاف المفاتيح، ولا يمكن قراءته في تنسيق
git diff؛ حيث يتم عرض كل مفتاح على شكل سطر منفصل بشكل واضح. - تصحيح الأخطاء: تصبح الهياكل المتداخلة أسهل في التصفح بصريًا بفضل التنسيق بالاندماج.
- التوثيق: يجب أن تكون أمثلة واجهة برمجة التطبيقات (API) دائمًا مُهيأة بشكل منظم، مرتبة، وثابتة عبر الإصدارات المختلفة.
- _configs: يجب طباعة ملفات التهيئة بصيغة JSON بشكل واضح داخل المستودع لتسهيل القراءة؛ حيث يمكن للنظام أثناء التشغيل تحليل أي من هذين الصيغين.
قواعد المسافة البادئة
| السياق | المسافة البادئة النموذجية |
|---|---|
npm package.json |
مسافتان |
| AWS CloudFormation | مسافتان |
| جافا القديمة / .NET | 4 مسافات |
| الإعدادات في أنظمة إدارة التحكم (VCS) | مسافتان (التوافق على مستوى المشروع هو الأهم) |
ترتيب المفاتيح أمر مثير للجدل: فهو يجعل الفروقات أوضح لكنه يغير ترتيب الملفات على القرص. اختر اتفاقًا لمشروعك والتزم به.
أخطاء التحقق التي سترىها
| خطأ | إصلاح |
|---|---|
Unexpected token ' at position X |
استخدمت علامات اقتباس أحادية؛ تغييرها إلى علامات اقتباس مزدوجة |
Unexpected end of JSON input |
غياب علامة إغلاق أو قوس |
Unexpected token , at position X |
قوس فاصل خلفي؛ حذفه |
Unexpected token a at position X |
مفتاح غير مُحدَّد أو قيمة حرفةية من نوع NaN/undefined |
Duplicate key "foo" (وضع التسامح) |
يسمح به مواصفة JSON؛ ويحافظ معظم مُحلَّلات البيانات على القيمة الأخيرة |
الأخطاء الشائعة
- نسخ بيانات JSON التي تحتوي على عناصر HTML: لن يتم تحليل الملف
"؛ قم بفك ترميزه أولاً. - دمج المعايير الصارمة مع المعايير المرنة: استخدم التحليل المرن فقط أثناء الفحص؛ ولا تحفظ ملفات JSON ذات التحليل المرن في ملفات الإعدادات التشغيلية أبدًا.
- طباعة ملف تم طباعته مسبقًا بأسلوب جذاب باستخدام نمط مختلف. سيقوم برنامج التنسيق بذلك بسهولة، لكنك ستحصل على فرق في النتائج غير واضح أو غير مفهوم (يُعرف بـ “الفرق الصاخب”).
الأسئلة الشائعة
لا: تتم عمليات التحليل والتنسيق داخل متصفحك، ولا يغادر المحتوى علامة التبويب أبدًا، مما يجعله آمنًا للصق استجابات واجهة برمجة التطبيقات التي تحتوي على رموز تعريفية (tokens)، أو إعدادات داخلية، أو بيانات اختبارية.
يقوم مُهيئر التنسيق بعرض بيانات JSON الصالحة بشكل واضح وجميل. أما جهاز التحقق فيقوم بفحص البيانات مقابل مخطط JSON محدد. وكلا العمليتين تشملان عملية تحليل، لكن التحقق يُعد خطوة منفصلة تهدف إلى معرفة ما إذا كانت البيانات مطابقة لمخططنا أم لا، وليس مجرد التأكد من صحة هيكل JSON.
نعم. خيار “مفاتيح الترتيب” يُرتّب جميع مفاتيح الكائنات على كل مستوى تضميني بشكل تكراري. وتظل المصفوفات في ترتيبها الأصلي، لأن ترتيب المصفوفات له دلالة دلالية واضحة في JSON.
محدود بذاكرة المتصفح؛ يمكن تشغيل ملفات تصل سعتها إلى حوالي 50 ميغابايت على الأجهزة الحديثة، أما إذا تجاوزت هذه الحدود، فيُنصح باستخدام الأمر jq من سطر الأوامر، حيث يتم بث المستند بالكامل بدلاً من تحميله كاملاً.
أدوات ذات صلة
مولد لوحة الألوان
قم بإنشاء لوحة ألوان متناغمة مكونة من 4-8 من اللون الأساسي باستخدام أنظمة تكميلية ومتماثلة وثلاثية ومتكاملة.
محدد ألوان HEX
اختر أي لون بصريًا واحصل على قيمه في تنسيقات HEX وRGB وHSL وHSV وCMYK، بالإضافة إلى تباينه المتعلق بالوصولية مقارنة بالأبيض والأسود.
مولد الألوان العشوائية
قم بتوليد لون RGB عشوائي، واطّلع على قيم الهكساديك والـ HSL وقيم RGB، ثم نسخ أي تنسيق بنقرة واحدة.
مولد لوحات ألوان عشوائية
قم بإنشاء خمسة ألوان مستندة إلى لون أساسي عشوائي، وتتضمن هذه الألوان متغيرات مكملة ومشابهة وثلاثية.
مولد أحرف عشوائية
قم بتوليد أحرف عشوائية من الأبجدية الإنجليزية. حدد نوع الحروف (كبيرة أو صغيرة)، وحدد ما إذا كانت الأحرف مكررة أم فريدة، بالإضافة إلى عدد الأحرف المطلوبة.
حاسبة العمر
احسب العمر الدقيق بالسنوات والشهور والأيام من تاريخ الميلاد، مع إجمالي الأيام والساعات والعد التنازلي لعيد الميلاد القادم.