137- دروس جافا سكربت – JSON Parse

## شرح مفصل لـ JSON.parse في لغة JavaScript

### مقدمة

JSON (JavaScript Object Notation) هو تنسيق خفيف لتبادل البيانات، يُستخدم بكثرة في تطبيقات الويب لتمثيل البيانات بشكل يمكن للجميع قراءته وكتابته بسهولة. في JavaScript، يتم استخدام `JSON.parse` لتحويل سلسلة نصية بتنسيق JSON إلى كائن JavaScript قابل للتعامل البرمجي.

### JSON.parse: التعريف والاستخدام

الدالة `JSON.parse` هي دالة مدمجة في JavaScript تُستخدم لتحليل سلسلة نصية بصيغة JSON وتحويلها إلى كائن JavaScript. هذه العملية ضرورية عندما نستقبل بيانات JSON من خادم ويب ونحتاج إلى معالجتها في التطبيق.

#### الصيغة العامة

JSON.parse(text[, reviver])

– **text**: سلسلة نصية بصيغة JSON.
– **reviver**: (اختياري) دالة تُستخدم لتحويل القيم بشكل مخصص أثناء عملية التحليل.

### كيفية عمل JSON.parse

عندما يتم استدعاء `JSON.parse`، يتم تحليل السلسلة النصية المحددة إلى كائن JavaScript. إذا كانت السلسلة غير صالحة، فسيتم رمي خطأ استثناء `SyntaxError`.

### أمثلة على استخدام JSON.parse

#### المثال الأول: تحويل سلسلة JSON بسيطة إلى كائن

const jsonString = '{"name": "أحمد", "age": 30, "city": "الرياض"}';
const user = JSON.parse(jsonString);

console.log(user.name); // أحمد
console.log(user.age);  // 30
console.log(user.city); // الرياض

في هذا المثال، قمنا بتحليل سلسلة JSON تحتوي على معلومات اسم وعمر ومدينة شخص إلى كائن JavaScript.

#### المثال الثاني: التعامل مع المصفوفات

const jsonArray = '[{"name": "سارة"}, {"name": "ماجد"}]';
const users = JSON.parse(jsonArray);

users.forEach(user => {
  console.log(user.name); // سارة ثم ماجد
});

هنا، قمنا بتحليل سلسلة JSON تمثل مصفوفة [شركة برمجة مصرية] من الكائنات إلى مصفوفة JavaScript يمكننا التعامل معها باستخدام دوال المصفوفات مثل `forEach`.

#### المثال الثالث: استخدام الدالة reviver

const jsonString = '{"name": "ليلى", "birthYear": 1990}';
const currentYear = new Date().getFullYear();

const user = JSON.parse(jsonString, (key, value) => {
  if (key === 'birthYear') {
    return currentYear - value;
  }
  return value;
});

console.log(user.name); // ليلى
console.log(user.birthYear); // العمر الحالي بناءً على سنة الميلاد

في هذا المثال، استخدمنا الدالة `reviver` لتحويل سنة الميلاد إلى عمر الشخص الحالي. يتم استدعاء الدالة `reviver` لكل زوج مفتاح/قيمة في الكائن، مما يتيح لنا تعديل القيم حسب الحاجة.

### الأخطاء الشائعة

– **SyntaxError**: يحدث هذا الخطأ عندما تحتوي السلسلة النصية على صيغة غير صحيحة. لذلك، يجب التأكد [شركة برمجة مصرية] من أن السلسلة النصية صالحة قبل محاولة تحليلها.
– **القيم غير المدعومة**: JSON لا يدعم القيم مثل `undefined` و`NaN` و`Infinity`. إذا تضمنت البيانات هذه القيم، يجب معالجتها قبل التحليل.

### الخاتمة

الدالة `JSON.parse` أداة قوية وضرورية عند التعامل مع بيانات JSON في JavaScript. من خلال استخدامها، يمكن للمطورين تحويل النصوص إلى كائنات JavaScript قابلة للاستخدام، مما يسهل عليهم بناء تطبيقات ويب تفاعلية ومعقدة. من المهم فهم كيفية عملها وكيفية التعامل مع الأخطاء المحتملة لضمان عملية تحليل سلسة وفعّالة.