138- دروس جافا سكربت – JSON Stringify

## JSON.stringify في JavaScript: شرح مفصل مع أمثلة

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

### ما هي JSON.stringify؟

الدالة `JSON.stringify` تُستخدم لتحويل كائن JavaScript أو أي نوع من البيانات إلى سلسلة نصية بصيغة JSON. هذا التحويل يُسهّل إرسال البيانات عبر الشبكات أو تخزينها في قواعد البيانات أو الملفات النصية.

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

JSON.stringify(value, replacer, space)

– **value**: الكائن أو القيمة التي ترغب في تحويلها إلى سلسلة JSON.
– **replacer** (اختياري): وظيفة أو مصفوفة لتحديد كيفية تحويل القيم أو لتصفية الخصائص.
– **space** (اختياري): عدد المسافات أو السلسلة المستخدمة للتنسيق وتحسين القابلية للقراءة.

### أمثلة عملية

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

لنبدأ بتحويل كائن بسيط إلى سلسلة JSON.

const person = {
  name: "أحمد",
  age: 30,
  city: "الرياض"
};

const jsonString = JSON.stringify(person);
console.log(jsonString);

**النتيجة:**

on
{"name":"أحمد","age":30,"city":"الرياض"}

#### المثال الثاني: استخدام معامل replacer

في بعض الأحيان، قد تحتاج إلى تصفية خصائص معينة أو تعديلها أثناء [شركة برمجة مصرية] عملية التحويل. يمكنك استخدام `replacer` لهذا الغرض.

const person = {
  name: "أحمد",
  age: 30,
  city: "الرياض",
  password: "12345"
};

const jsonString = JSON.stringify(person, (key, value) => {
  if (key === "password") {
    return undefined;  // استبعاد كلمة المرور
  }
  return value;
});

console.log(jsonString);

**النتيجة:**

on
{"name":"أحمد","age":30,"city":"الرياض"}

#### المثال الثالث: تحسين القابلية للقراءة باستخدام space [شركة برمجة مصرية]

يمكنك تحسين تنسيق سلسلة JSON باستخدام معامل `space`، مما يسهل قراءتها.

const person = {
  name: "أحمد",
  age: 30,
  city: "الرياض"
};

const jsonString = JSON.stringify(person, null, 4);
console.log(jsonString);

**النتيجة:**

on
{
    "name": "أحمد",
    "age": 30,
    "city": "الرياض"
}

#### المثال الرابع: تحويل أنواع بيانات مختلفة

يمكنك تحويل أنواع بيانات أخرى غير الكائنات، مثل المصفوفات والقيم العددية.

const array = [1, 2, 3, 4, 5];
const number = 100;
const booleanValue = true;

console.log(JSON.stringify(array));        // "[1,2,3,4,5]"
console.log(JSON.stringify(number));       // "100"
console.log(JSON.stringify(booleanValue)); // "true"

### الاستخدامات الشائعة

– **إرسال البيانات عبر الشبكات**: تُستخدم `JSON.stringify` لتحويل البيانات إلى صيغة JSON يمكن إرسالها عبر HTTP.
– **التخزين في قواعد البيانات**: تُخزن البيانات كنصوص JSON في قواعد البيانات مثل MongoDB.
– **الاحتفاظ بالبيانات في ملفات نصية**: يمكن حفظ سلسلة JSON في ملفات نصية للاستخدام لاحقًا.

### الخلاصة

تُعتبر `JSON.stringify` أداة هامة في JavaScript لتحويل البيانات إلى صيغة JSON، مما يسهل عملية نقل البيانات وتخزينها. من خلال فهم كيفية استخدامها، يمكنك تحسين تفاعلك مع الشبكات وقواعد البيانات بشكل كبير. باستخدام الخيارات المتقدمة مثل `replacer` و`space`، يمكنك تخصيص عملية التحويل بما يتناسب مع احتياجاتك الخاصة.