كيف تقرأ وتنسّق JSON بدون خبرة برمجية متقدمة

آخر تحديث: 15 أبريل 2026 · زمن القراءة: 5 دقائق

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

ما هو JSON؟

JSON هو اختصار لـ JavaScript Object Notation. تنسيق نصي بسيط لتخزين البيانات ونقلها. يعتمد على مفهومين فقط:

• كائن (Object): مجموعة من أزواج مفتاح/قيمة بين قوسين معكوفين { }. مثال: {"الاسم": "أحمد", "العمر": 30}
• مصفوفة (Array): قائمة من القيم بين قوسين مربعين [ ]. مثال: ["نص", "صورة", "PDF"]

JSON مضغوط مقابل JSON منسّق

نفس البيانات في شكلين:

مضغوط (لا يُقرأ بسهولة):

{"user":{"name":"أحمد","age":30,"tools":["PDF","صور","نصوص"]}}

منسّق (سهل القراءة):

{
  "user": {
    "name": "أحمد",
    "age": 30,
    "tools": [
      "PDF",
      "صور",
      "نصوص"
    ]
  }
}

نفس البيانات تماماً — الفرق الوحيد هو المسافات وفواصل الأسطر التي تجعل البنية واضحة.

كيف تنسّق JSON في ثانية واحدة

1. انسخ النص الخام من الـ API أو الملف.
2. افتح منسّق JSON من Adawix.
3. الصقه في المربع.
4. اضغط "تنسيق" — ستحصل على النسخة المرتّبة والملوّنة فوراً.
5. إذا كان هناك خطأ، سيُظهر لك السطر المشكل تحديداً.

أخطاء JSON الشائعة وكيف تصلحها

• فاصلة زائدة في نهاية القائمة: ["أ", "ب", "ج",] — احذف الفاصلة الأخيرة. JSON لا يقبل trailing comma.
• مفتاح بدون علامات اقتباس: {name: "أحمد"} — يجب أن يكون {"name": "أحمد"}.
• علامات اقتباس منفردة: {'name': 'أحمد'} — JSON يقبل فقط علامات الاقتباس المزدوجة "...".
• قيمة undefined: {"result": undefined} — JSON لا يعرف undefined. استخدم null بدلاً منها.
• أقواس غير متزنة: إذا فتحت { يجب إغلاقها بـ }. المنسّق يُظهر أين الخلل.

من يحتاج JSON Formatter؟

• مطورو الواجهة الأمامية: لتحليل ردود الـ APIs وإيجاد مفاتيح البيانات.
• المبتدئون في البرمجة: لفهم بنية البيانات قبل كتابة الكود.
• مختبرو الـ APIs (QA): للتحقق من صحة الـ response المُستلم.
• أصحاب المتاجر والمواقع: لقراءة ملفات إعدادات الإضافات والسمات.
• محللو البيانات: لقراءة ملفات البيانات المُصدَّرة من الأنظمة الحديثة.

JSON وتنسيقات مجاورة تستحق المعرفة

JSONL (JSON Lines): كل سطر هو كائن JSON مستقل — يُستخدم في تسجيل الأحداث والـ logs.

JSON5: نسخة أكثر تساهلاً تقبل التعليقات والمفاتيح بدون اقتباسات — لملفات الإعدادات لا لتبادل البيانات.

YAML: بديل أكثر قراءة يُستخدم في إعدادات الخوادم والـ CI/CD — يحوّل إلى JSON بسهولة.

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

ما الفرق بين JSON و XML؟

JSON أخف وأسهل قراءة وأسرع معالجة في التطبيقات الحديثة. XML أكثر تفصيلاً ويُستخدم في بعض الأنظمة القديمة.

لماذا أحصل على خطأ "Unexpected token"؟

الأسباب الشائعة: فاصلة زائدة، مفتاح بدون اقتباسات، نص يحتوي اقتباساً غير محمي، أو أقواس غير مغلقة. المنسّق يُظهر السطر المشكل تحديداً.

هل JSON يدعم التعليقات؟

لا. JSON الرسمي لا يدعم التعليقات. يمكنك إضافة مفتاح مخصص مثل "_comment" وإزالته قبل الاستخدام.
نسّق JSON الآن مجاناً ←

---

نسّق JSON الآن ›