منسق JSON

نظرة عامة على تنسيق JSON

JSON (ترميز جافا سكريبت للكائنات) هو تنسيق خفيف لتبادل البيانات. فهم قواعده ضروري لإنشاء هياكل بيانات JSON ومعالجتها بشكل فعّال.

القواعد الأساسية

1. الكائنات (Objects)
   • يتم احتواؤها بين الأقواس المعقوفة { }.
   • كائن فارغ: { }
2. المصفوفات (Arrays)
   • يتم احتواؤها بين الأقواس المربعة [ ].
   • مصفوفة فارغة: [ ]
3. العناصر (أزواج المفتاح والقيمة)
   • يجب أن تكون المفاتيح فريدة داخل الكائن ومكتوبة بين علامتي اقتباس مزدوجتين ("key").
     • (بعض المحللات تقبل علامات اقتباس مفردة، لكن يُفضل تجنبها لضمان التوافق.)
   • القيم تعتمد على نوعها:
     • سلسلة نصية (String): بين علامتي اقتباس مزدوجتين.
     • قيمة منطقية (Boolean): استخدم true أو false.
     • رقم (Number): اتبع قواعد الأرقام ذات الفاصلة العائمة ذات الدقة المزدوجة؛ يُسمح باستخدام الترميز العلمي. تجنب الأصفار في البداية.
     • Null: يتم تمثيله بـ null.
     • أنواع أخرى (مثل التواريخ): حوّلها إلى سلاسل نصية لضمان التوافق.
   • يجب الهروب من الأحرف الخاصة في السلاسل باستخدام الشرطة المائلة للخلف (\).
4. قواعد البنية
   • افصل بين عناصر الكائن أو قيم المصفوفة بفواصل، باستثناء العنصر الأخير.
   • امتداد الملف: .json
   • نوع MIME: application/json

مثال على JSON

{
  "anObject": {
    "numericProperty": -122,
    "stringProperty": "An offensive \" is problematic",
    "nullProperty": null,
    "booleanProperty": true,
    "dateProperty": "2011-09-23"
  },
  "arrayOfObjects": [
    { "item": 1 },
    { "item": 2 },
    { "item": 3 }
  ],
  "arrayOfIntegers": [1, 2, 3, 4, 5]
}

JSON في JavaScript

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

تحليل سلاسل JSON

تجنب استخدام eval()

eval() يمكنه تحليل JSON، لكنه يشكل خطرًا أمنيًا لأنه يسمح بتنفيذ JavaScript عشوائي. لا تستخدم هذه الطريقة في بيئة الإنتاج.

مثال (غير آمن – لا تستخدمه):

var jsonString = '{"property":"value"}';
var jsonObject = eval('(' + jsonString + ')');
alert(jsonObject.property);

استخدم بدلاً من ذلك JSON.parse()

JSON.parse() يحول سلسلة JSON إلى كائن JavaScript بأمان.

مثال (آمن):

var jsonString = '{"property":"value"}';
var jsonObject = JSON.parse(jsonString);
alert(jsonObject.property);

إنشاء سلاسل JSON

استخدم JSON.stringify() لتحويل كائن JavaScript إلى سلسلة JSON.

مثال:

var jsObject = { property: "value" };
var jsonString = JSON.stringify(jsObject);
alert(jsonString); // Output: '{"property":"value"}'

إنشاء كائنات JavaScript مباشرة

يمكن إنشاء كائنات JavaScript باستخدام صيغة JSON مباشرة في الكود.

مثال:

var jsonObject = { property: "value" };
alert(jsonObject.property); // Output: 'value'

أفضل الممارسات والتوصيات

1. استخدم دائمًا علامات اقتباس مزدوجة للمفاتيح والقيم النصية لتحقيق أقصى قدر من التوافق.
2. تجنب استخدام eval() لتحليل JSON لتفادي الثغرات الأمنية.
3. اهرب الأحرف الخاصة في السلاسل النصية.
4. استخدم JSON.stringify() و JSON.parse() لمعالجة JSON بأمان وكفاءة.
5. تحقق من صحة بيانات JSON قبل تحليلها، خاصة إذا كانت قادمة من مصادر غير موثوقة.