أداة تنسيق JSON باستخدام JSON.stringify

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

الخلفية التاريخية

تم تحديد JSON في الأصل بواسطة دوجلاس كروكفورد في أوائل العقد الأول من القرن الحادي والعشرين كبديل أبسط لـ XML لتبادل البيانات بين الخوادم وتطبيقات الويب. كان هدف تصميمه هو أن يكون بسيطًا، وقابلًا للنقل، ونصيًا، ومجموعة فرعية من جافا سكريبت. وقد أصبح منذ ذلك الحين أحد التنسيقات القياسية لتبادل البيانات على الويب.

صيغة الحساب

لا تتبع عملية تنسيق JSON "صيغة حسابية"، بل تستخدم دالة JSON.stringify في جافا سكريبت:

JSON.stringify\(value\[, replacer\[, space\]\]\)

• value: القيمة المراد تحويلها إلى سلسلة JSON.
• replacer: دالة تُغيّر سلوك عملية تحويل السلسلة، أو مصفوفة من كائنات السلسلة والأرقام التي تعمل كقائمة بيضاء لتحديد/تصفية خصائص كائن القيمة المراد تضمينها في سلسلة JSON.
• space: يحدد مسافة البادئة للهياكل المتداخلة. إذا تم حذفه، فسيتم ضغط النص بدون مسافات إضافية.

إذا كان رقمًا، فسوف يحدد عدد مسافات الأحرف التي سيتم استخدامها كمسافة بيضاء؛ وإذا كان سلسلة (مثل \t)، فسيتم استخدامها كمسافة بيضاء.

مثال على الحساب

إذا كان لديك كائن مثل { name: "John", age: 30 } وتريد تنسيقه بمسافتين من المسافة البادئة، فسيكون الإدخال والمخرج:

• الإدخال:

  { name: "John", age: 30 }

• المخرج:

  {
    "name": "John",
    "age": 30
  }

أهمية وسيناريوهات الاستخدام

JSON.stringify ضرورية ل:

• تسلسل البيانات لإرسالها إلى الخادم.
• تخزين البيانات بتنسيق قابل للقراءة في التخزين المحلي أو الملفات.
• إنشاء سلاسل JSON قابلة للقراءة من قبل الإنسان لأغراض تصحيح الأخطاء أو العرض.

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

1. ماذا تفعل JSON.stringify؟

   • تحول كائن أو قيمة جافا سكريبت إلى سلسلة بتنسيق JSON.

2. كيف يمكنني تنسيق سلسلة JSON باستخدام المسافة البادئة؟

   • عن طريق تمرير رقم أو سلسلة كمعامل ثالث إلى JSON.stringify، لتحديد مستوى أو تسلسل المسافة البادئة.

3. ماذا يحدث إذا واجهت JSON.stringify مرجعًا دائريًا؟

   • سوف تُلقي خطأ لأن JSON لا يمكنه تمثيل المراجع الدائرية.

4. هل يمكن لـ JSON.stringify تسلسل الدوال؟

   • لا، الدوال ليست أنواع بيانات JSON صالحة وسيتم إما حذفها أو استبدالها إذا تم استخدام دالة مُستبدلة.

توفر هذه الأداة طريقة بسيطة وفعالة لتنسيق وتجميل بيانات JSON، مما يسهل قراءتها و تصحيح أخطائها.