التعامل مع بيانات JSON (JSON Parse & Stringify)

JSON اختصار لـ JavaScript Object Notation، وهو صيغة نصية خفيفة لتمثيل البيانات المُهيكلة، مبنية أصلاً على صيغة كائنات جافاسكريبت لكنها أصبحت معياراً عالمياً مستقلاً عن اللغة تماماً، وتُستخدم في كل لغات البرمجة تقريباً لتبادل البيانات بين الأنظمة المختلفة — خاصة بين المتصفح والخادم عبر واجهات برمجية (APIs).

من المهم فهم أن JSON مجرد نص (String) في جوهره، وليس كائن JavaScript فعلي — رغم تشابه صياغته الكبير مع كائنات JS. توجد قواعد صارمة لصياغة JSON صحيح: أسماء المفاتيح يجب أن تكون بين علامات اقتباس مزدوجة دائماً (وليست مفردة)، لا يمكن تضمين دوال (Functions) أو undefined أو Symbol كقيم، ولا يُسمح بفاصلة زائدة بعد آخر عنصر في مصفوفة أو كائن.

JSON.stringify() تُحوّل كائن أو مصفوفة جافاسكريبت حقيقية إلى نص JSON — ضرورية عند إرسال بيانات للخادم عبر fetch، أو عند التخزين في localStorage كما تعلمنا سابقاً. تقبل الدالة وسيطين اختياريين إضافيين مفيدين جداً: دالة "استبدال" (Replacer) للتحكم في الخصائص المُضمَّنة، ورقم أو نص "مسافة بادئة" (Indentation) لتنسيق الناتج بشكل مقروء للعين البشرية (مفيد جداً عند طباعته للتصحيح).

JSON.parse() تعكس العملية تماماً — تُحوّل نص JSON (مثل ما تستلمه من استجابة خادم) إلى كائن أو مصفوفة جافاسكريبت حقيقية يمكن التعامل معها ببرمجية عادية. إذا كان النص الممرَّر لها ليس JSON صحيحاً (كوجود خطأ إملائي في الصياغة)، تُلقي خطأ SyntaxError فوراً، لذا من الممارسات الجيدة دائماً تغليف استدعاءها بـ try...catch عند التعامل مع بيانات مصدرها غير مضمون تماماً.