Menu
العربية

مُنسق JSON

نسّق JSON وتحقق منه واستكشفه بعرض شجري مباشر.

Last updated

إزاحة
الإدخالالصق JSON للبدء
الإخراج
يظهر JSON المنسق هنا — أعد الإزاحة وتحقق وانسخ بنقرة واحدة.

ما هي أداة تنسيق JSON؟

أداة تنسيق JSON (تُعرف أيضًا بـ JSON beautifier أو pretty-printer) تأخذ بيانات JSON المضغوطة أو المشوّشة وتحوّلها إلى بيانات مقروءة وذات إزاحة واضحة. وهي من أكثر الأدوات التي يلجأ إليها المطوّرون يوميًا — أثناء فحص استجابات الـ API، وقراءة ملفات الإعدادات، وتنقيح السجلات، ومقارنة بيانات الاختبار، ونقل البيانات بين كود الواجهة الأمامية والخلفية.

صيغة JSON صارمة: المفاتيح يجب أن تكون داخل علامتي اقتباس مزدوجتين، والنصوص كذلك، والفواصل لها مكانها المحدد، وكل { أو [ مفتوح لا بد أن يُغلق. أداة التنسيق تجعل هذه البنية ظاهرة للعين، والمدقّق المدمج يخبرك بدقّة أين يكسر التركيب القاعدة عند حدوث ذلك.

اختصار JSON يعني JavaScript Object Notation. ورغم أنها نشأت من جافاسكريبت، فإن جميع لغات البرمجة تقريبًا تدعم قراءة وكتابة JSON بشكل أصيل، ولهذا أصبحت الطريقة الافتراضية لتبادل البيانات المهيكلة على الويب.

ما الذي ستتعلّمه أثناء استخدامها

  • الكائنات تستخدم {} للحقول المسمّاة، والمصفوفات تستخدم [] للقوائم المرتبة، ويمكن تداخلهما داخل بعضهما إلى أي عمق.
  • JSON المنسّق و JSON المصغّر هما *نفس البيانات* — المسافات تغيّر سهولة القراءة فقط، لا المعنى. والخوادم عادة تُرجع JSON مصغّرًا لتوفير عدد البايتات.
  • قيم JSON محصورة في ستة أنواع فقط: نص (string)، رقم (number)، قيمة منطقية (boolean)، null، كائن (object)، ومصفوفة (array). لا يوجد undefined، ولا دوال، ولا تعليقات.

كيف تنسّق JSON خطوة بخطوة

  1. ألصق JSON في مربع الإدخال

    انسخ JSON من استجابة الـ API أو ملف السجل أو ملف الإعدادات والصقه في الناحية المخصّصة للإدخال. الأداة تقبل المدخلات المصغّرة والمنسّقة جزئيًا على حدٍّ سواء.

  2. اختر عرض الإزاحة (indent)

    مسافتان هي الأسلوب الأكثر شيوعًا، وأربع مسافات أيضًا منتشرة. اختر ما يطابق الأسلوب المعتمد في مشروعك.

  3. اقرأ نتيجة التحقق

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

  4. استكشف العرض الشجري

    استخدم الشجرة القابلة للطيّ لإخفاء الكائنات والمصفوفات شديدة التداخل. هذه أسرع طريقة لفهم شكل استجابة API غير مألوفة.

  5. انسخ النتيجة أو صغّرها

    انسخ النسخة المنسّقة إلى الكود أو التوثيق، أو أعد تصغيرها إلى سطر واحد لتخزينها أو نقلها عبر الشبكة.

مرجع سريع لصيغة JSON

المجموعة الكاملة لمكوّنات JSON. أيّ شيء خارج هذه القائمة لا يُعدّ JSON صالحًا. المواصفة: RFC 8259 و ECMA-404.

الرمزالمعنىمثال
{ }كائن — مجموعة من أزواج مفتاح/قيمة{"name": "Maya"}
[ ]مصفوفة — قائمة مرتّبة من القيم[1, 2, 3]
"..."نص — يُكتب دائمًا داخل علامتَي اقتباس مزدوجتين"hello"
Numberعدد صحيح أو عشري، بدون اقتباس وبدون + في البداية42, -3.14
true / falseقيم منطقية، بحروف صغيرةtrue
nullقيمة فارغة / مفقودةnull
:فاصل بين المفتاح وقيمته"id": 7
,فاصل بين العناصر — لا يجوز في النهاية[1, 2, 3]

أمثلة JSON للتجربة

تنسيق استجابة API نموذجية

المدخل
{"user":{"id":7,"name":"Maya"},"skills":["HTML","JavaScript"]}
بعد التنسيق
{  "user": {    "id": 7,    "name": "Maya"  },  "skills": ["HTML", "JavaScript"]}

بعد التنسيق، يصبح كائن user المتداخل ومصفوفة skills أسهل بكثير في القراءة. البيانات نفسها لم تتغيّر — فقط المسافات البيضاء.

اكتشاف فاصلة زائدة في النهاية

غير صالح
{  "name": "Coddy",  "active": true,}

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

الفرق بين أنواع القيم

المدخل
{  "count": 3,  "countText": "3",  "enabled": true}

3 رقم، و"3" نص، وtrue قيمة منطقية — ثلاثة أنواع مختلفة في JSON. الـ APIs كثيرًا ما تفشل عندما يكون شكل البيانات صحيحًا لكن نوع القيمة خاطئ.

قراءة استجابة شديدة التداخل

المدخل
{  "data": {    "orders": [      { "id": 101, "items": [{ "sku": "A", "qty": 2 }] },      { "id": 102, "items": [] }    ]  }}

استخدم العرض الشجري لطيّ data.orders وكشف البنية مستوى تلو الآخر. مصفوفات الكائنات المتداخلة هي النمط الأكثر شيوعًا في استجابات REST.

أخطاء شائعة في JSON

  • استخدام علامة اقتباس مفردة بدلًا من المزدوجة حول المفاتيح أو النصوص — JSON يقبل علامة الاقتباس المزدوجة فقط.
  • التعامل مع JSON كأنّه كائن جافاسكريبت: التعليقات والدوال وundefined ليست جزءًا من JSON، والفاصلة الزائدة في النهاية تُفشل التحليل.
  • نسيان أن الأرقام في JSON لا تقبل + في البداية، ولا أصفارًا قبل الرقم (باستثناء 0 نفسه)، ولا توضع داخل اقتباسات إذا كنت تريد فعلًا نوع رقم.

أسئلة شائعة حول أداة تنسيق JSON

ما هو JSON؟
JSON (اختصار JavaScript Object Notation) هو صيغة نصية خفيفة للبيانات المهيكلة. يعتمد على أزواج مفتاح-قيمة والمصفوفات، وتدعمه تقريبًا جميع لغات البرمجة، ولهذا صار الخيار الافتراضي لـ APIs الويب وملفات الإعدادات وحمولات الرسائل.
كيف تُنسّق JSON؟
ألصق JSON في أداة تنسيق JSON، اختر عرض الإزاحة (عادة مسافتان)، ثم تُعيد الأداة إخراج البيانات نفسها مع فواصل أسطر وإزاحة. ومعظم الأدوات تتحقّق من صحة الصيغة في الخطوة نفسها.
ما الفرق بين أداة تنسيق JSON وأداة التحقق منها؟
أداة التنسيق تعيد كتابة JSON الصالح بشكل أوضح للقراءة. أمّا أداة التحقق فتفحص ما إذا كان تركيب JSON صحيحًا أصلًا. والأداة الجيدة تجمع بين الوظيفتين.
هل تنسيق JSON يغيّر البيانات؟
لا. التنسيق يضيف إزاحة وفواصل أسطر فقط، أمّا المفاتيح والمصفوفات والنصوص والأرقام والقيم المنطقية وnull فتبقى كما هي تمامًا. وعند تصغير الناتج تستعيد الصيغة الأصلية الملائمة للنقل عبر الشبكة.
لماذا يفشل JSON عندي رغم أنه يبدو ككائن جافاسكريبت؟
JSON أكثر صرامة من صيغة كائنات جافاسكريبت. المفاتيح والنصوص يجب أن تستخدم علامة اقتباس مزدوجة، ولا يقبل JSON التعليقات، ولا الفاصلة الزائدة في النهاية، ولا الاقتباس المفرد، ولا undefined.
أين يستخدم المطوّرون JSON يوميًا؟
JSON موجود في كل مكان: استجابات REST و GraphQL، وأجسام الطلبات، وملفات الإعدادات (package.json, tsconfig.json)، والبيانات الوصفية للحزم، وأسطر السجلات، وتخزين المتصفح المحلي، وبيانات الاختبار.

اعرف المزيد

أدوات مطورين أخرى

تعلّم البرمجة مع Coddy

ابدأ الآن