مُجمِّل JSON
تنسيق JSON بمسافة بادئة قابلة للتخصيص لتحسين القراءة
جرب مثالاً
المدخلات
المخرجات المنسّقة
يعمل محليًا · آمن للصق الأسرار
سيظهر JSON المنسّق هنا…
يعمل محليًا · آمن للصق الأسرار
سيظهر JSON المنسّق هنا…
ما هو JSON Pretty Print؟
JSON pretty print يحوّل JSON المضغوط وصعب القراءة إلى تنسيق منظم متعدد الأسطر مع مسافات بادئة. بينما تعالج الأجهزة JSON أحادي السطر بسهولة، يحتاج البشر إلى بنية — تسلسل هرمي بصري وأقواس محاذاة ومسافات بادئة متسقة — لفهم البيانات المعقدة بسرعة.
After · json
Before · json
{
"user": "alice",
"role": "admin",
"permissions": [
"read",
"write"
],
"active": true,
"lastLogin": 1717200000
}{"user":"alice","role":"admin","permissions":["read","write"],"active":true,"lastLogin":1717200000}لماذا نستخدم JSON Pretty Print؟
JSON الخام من واجهات API وقواعد البيانات وملفات السجلات يكون في الغالب مضغوطاً لتوفير النطاق الترددي. يستعيد pretty print البنية المقروءة اللازمة للتصحيح والمراجعة وفهم البيانات.
🔍
تصحيح أسرع
اكتشف الحقول المفقودة والقيم الخاطئة والأخطاء الهيكلية في ثوانٍ بدلاً من تحليل جدار من النص حرفاً بحرف.
👥
مراجعات كود أوضح
مراجعة تغييرات ملفات إعداد JSON في طلبات السحب أسهل بكثير مع المسافات البادئة الصحيحة — يمكن للمراجعين التركيز على ما تغيّر.
🔌
فحص واجهات API
عند استكشاف API جديدة، تتيح الاستجابات المنسّقة فهم نموذج البيانات وبنية التداخل للوهلة الأولى.
📝
التوثيق والمشاركة
JSON المنسّق جاهز للصق في الوثائق والمستودعات والتذاكر وSlack دون الحاجة إلى أي تحليل ذهني.
اختيار المسافة البادئة
يُستخدم كلٌّ من مسافتين وأربع مسافات على نطاق واسع. يعتمد الاختيار الصحيح عادةً على دليل أسلوب الفريق أو التفضيل الشخصي.
مسافتان
الخيار الأكثر شيوعاً في مجتمعات JavaScript وJSON. يُبقي الملفات مضغوطة مع الحفاظ على قراءتها. مستخدَم في npm وESLint ومعظم أدلة أسلوب JS.
أربع مسافات
شائع في مشاريع Python وJava وC#. يوفر مساحة بصرية أكبر ويُفضَّل في البنى المتداخلة عمقاً.
حالات الاستخدام الشائعة
تصحيح استجابات API
الصق استجابة API خام وشاهد البنية الكاملة للبيانات والكائنات المتداخلة ومحتويات المصفوفات فوراً في تخطيط مقروء.
قراءة ملفات الإعداد
الإعداد المخزَّن في JSON مضغوط يصبح سهل القراءة والتعديل بعد التنسيق — لا مزيد من البحث عن مفتاح بعينه.
تحليل السجلات
السجلات المنظمة كثيراً ما تحتوي على بيانات JSON. تنسيق إدخالات السجلات الفردية يسرّع تحليل السبب الجذري بشكل كبير.
توثيق المطورين
توفير أمثلة JSON واضحة ومنسّقة في وثائق API يتيح للمطورين فهم بنية الطلبات والاستجابات فوراً.
استكشاف البيانات
عند العمل مع مجموعة بيانات غير مألوفة، يكشف pretty print المخطط الكامل — الحقول والأنواع والتداخل — دون قراءة الوثائق أولاً.
الاختبار وضمان الجودة
مقارنة JSON المتوقع بالفعلي عند فشل الاختبارات أسهل بكثير مع مسافات بادئة متسقة وبنية سطر بسطر.
Pretty Print في الطرفية
لا تحتاج دائماً إلى أداة متصفح. هذه الأوامر تنسّق JSON مباشرة في الطرفية دون تثبيت إضافي.
Python
echo '{"a":1}' | python3 -m json.toolNode.js
node -e "console.log(JSON.stringify(JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')),null,2))"CLI (jq)
cat data.json | jq .
curl + jq
curl -s https://api.example.com/data | jq .
الأسئلة الشائعة
What is JSON pretty printing?
JSON pretty printing (also called JSON formatting or JSON beautifying) converts compact, minified JSON into a human-readable layout with consistent indentation and line breaks. It makes nested structures, arrays, and key-value pairs easy to scan and debug.
هل يغيّر pretty print البيانات؟
لا. يُضاف فقط مسافات بيضاء — لا يُعدَّل أي بيانات أو مفاتيح أو قيم أو ترتيب. ملف JSON المنسّق مطابق دلالياً للأصل.
أيهما أفضل: مسافتان أم أربع؟
لا توجد أفضلية موضوعية. المسافتان أكثر إحكاماً وهو الافتراضي في كثير من أدوات JavaScript. الأربع مسافات توفر فصلاً بصرياً أكبر. استخدم ما يحدده دليل أسلوب فريقك.
هل يمكن تنسيق JSON غير صالح؟
لا — يجب أن يكون المدخل JSON صالحاً أولاً. إذا كان الملف يحتوي على فواصل نهائية أو اقتباسات مفردة أو تعليقات (JSONC/JSON5)، حوّله إلى JSON قياسي أولاً.
كيف أنسّق JSON في DevTools المتصفح؟
في Chrome/Firefox DevTools، انقر زر {} في أسفل لوحة استجابة الشبكة للتنسيق التلقائي. يمكنك أيضاً تشغيل JSON.stringify(obj, null, 2) في الكونسول لتنسيق أي كائن JavaScript.
أدلة اللغات
أدوات ذات صلة
منسق ومُجمِّل JSONتنسيق وتجميل JSON مع تمييز بناء الجملةمدقق JSONالتحقق من صحة بناء جملة وهيكل JSONمقارنة JSONمقارنة كائني JSON وتمييز الاختلافاتضاغط JSONضغط وتصغير JSON عن طريق إزالة المسافات البيضاءمحوّل JSON إلى YAMLتحويل JSON إلى تنسيق YAMLمحوّل JSON إلى CSVتحويل مصفوفة JSON إلى تنسيق CSVمحوّل JSON إلى TypeScriptتوليد واجهات TypeScript من JSONJSON إلى كلاس C#توليد كلاسات C# من JSONJSON إلى Go Structتوليد structs في Go من JSONJSON إلى Python Dataclassتوليد Python dataclasses من JSONJSON إلى Javaتوليد كلاسات Java POJO من JSONJSON إلى Dartتوليد كلاسات Dart من JSON مع fromJson وtoJson