انتقل إلى محتوى الدرس
الدرس 138
تاريخ النشر: تاريخ التحديث:
دورة جافا سكريبت

التعامل مع كائنات JSON المتداخلة في JavaScriptJSON Objects in JavaScript طريقة قراءة خصائص كائن JSON، وتعديل الكائن وإعادة تصديره، والوصول الآمن للكائنات المتداخلة

تعامل باحترافية مع كائنات JSON المحللة عبر الصياغة النقطية والأقواس والتسلسل الاختياري الآمن (?.) واستعراض الحقول بـ Object.entries وتعديلها وإعادة تصديرها.
أقسام الدرس
4
الأمثلة
3
اللغة
العربية
المشاهدات
2,898
محتوى الدرس
في هذا الدرس 4تصفّح المواضيع

بمجرد أن تحلل الدالة JSON.parse() النص الوارد، يصبح الناتج كائن Object قياسياً عادياً في ذاكرة JavaScript، فتقرأ خصائصه بالصياغة النقطية (user.email) أو بصياغة الأقواس المربعة (user["plan-tier"]).

تبرز أهمية الأقواس المربعة كلما احتوى اسم المفتاح القادم من الخادم على شرطة وسطية أو مسافات أو كان اسم الحقل مخزناً داخل متغير ديناميكي.

مخطط دورة قراءة كائنات JSON المحللة عبر التسلسل الاختياري واستعراض الحقول وإعادة التصدير
JavaScript
const raw = '{"id":204,"full-name":"Rami Adel","verified":true}';
const member = JSON.parse(raw);
document.getElementById('obj-out').textContent =
  member['full-name'] + ' (#' + member.id + ')';

كثيراً ما تُغفل ردود الخوادم بعض الفروع الاختيارية أو ترسلها بقيمة null (مثل طلب رقمي بلا عنوان شحن "shipping": null). عندئذٍ تسبب القراءة المتسلسلة العادية order.shipping.city انهيار السكربت بخطأ TypeError!

يحسم معامل التسلسل الاختياري (?.) مقترناً بمعامل القيمة البديلة (??) هذه المشكلة بأناقة وأمان تام:

صيغة الوصول للحقلالنتيجة إذا كان shipping يساوي nullالحكم الهندسي
order.shipping.cityانهيار فوري بخطأ TypeErrorخطر مع البيانات الخارجية
order.shipping?.cityتتوقف بهدوء وتُرجع undefinedوصول آمن بلا استثناءات
order.shipping?.city ?? "Pickup"تُرجع القيمة البديلة "Pickup"الأفضل لعرض واجهة نظيفة
JavaScript
const order = JSON.parse('{"id":88,"shipping":null}');
const city = order.shipping?.address?.city ?? 'Digital Delivery';
document.getElementById('opt-out').textContent =
  'Order #' + order.id + ': ' + city;

عندما يمثل كائن JSON قاموساً ديناميكياً للمفاتيح (مثل أسعار العملات أو إعدادات المزايا)، يُفضل دائماً استعراضه بالدالة Object.entries(parsed) مع حلقة for...of بدلاً من حلقة for...in القديمة.

تضمن Object.entries() قراءة الخصائص الذاتية الخاصة بالكائن فقط دون التورط في خصائص السلسلة الموروثة.

بما أن السلاسل النصية ثابتة في JavaScript، فلا تعدّل نص JSON أبداً بدوال استبدال النصوص اليدوية! بل اتبع دائماً الدورة الهندسية الثلاثية النظيفة: تحليل ← تعديل الكائن ← إعادة تصدير:

  1. فك تشفير النص عبر const state = JSON.parse(raw).
  2. حدّث القيم المطلوبة أو أضف خصائص جديدة أو احذف المفاتيح المهملة عبر delete state.oldKey.
  3. أعد تحويل الكائن إلى نص سليم عبر JSON.stringify(state) للحفظ أو الإرسال.
JavaScript
const rawPrefs = '{"lang":"ar","zoom":100,"beta":false}';
const prefs = JSON.parse(rawPrefs);
prefs.zoom = 115;
delete prefs.beta;
document.getElementById('mut-out').textContent = JSON.stringify(prefs);
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

مراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي

ماذا تعلّمت في هذا الدرس؟

أتقنت في هذا الدرس قراءة كائنات JSON المحللة بالنقطة والأقواس المربعة، وحماية الفروع المتداخلة عبر ?. و??، واستعراض الأزواج عبر Object.entries()، وتنفيذ دورة التحليل والتعديل وإعادة التصدير. الخطوة التالية: انتقل إلى درس «التعامل مع مصفوفات JSON» لمعالجة قوائم السجلات والمصفوفات الفرعية.

مشاركة

هل كان هذا الدرس مفيدًا؟

جارٍ تحميل الآراء…

ابنِ لغتك البرمجية

المصطلحات3

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 3 مفهومةأول بطاقة، أول خطوة
01 Optional Chaining (?.) التسلسل الاختياري (?.)
معامل وصول آمن يُرجع undefined بهدوء بدلاً من إطلاق خطأ TypeError إذا كان أي فرع وسيط يساوي null أو undefined.
للمراجعة
02 Object.entries الدالة Object.entries
دالة ثابتة تُرجع مصفوفة من أزواج [المفتاح، القيمة] للخصائص الذاتية الخاصة بالكائن المحلل.
للمراجعة
03 Object.hasOwn الدالة Object.hasOwn
دالة قياسية تتحقق من امتلاك الكائن لمفتاح محدد مباشرة حتى لو كانت قيمته صفراً أو null.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

حروف قليلة. معنى كامل.

الاختصارات2

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 2 مفهومةأول بطاقة، أول خطوة
01 REST REST
Representational State Transfer
نمط معماري لواجهات الويب ترسل استجاباته غالباً كائنات JSON متداخلة.
للمراجعة
02 JSON JSON
JavaScript Object Notation
تنسيق تبادل البيانات النصي الذي تتحول كائناته مباشرة إلى كائنات JavaScript.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

من الفهم للتطبيق

مهامك قبل الاختبار

خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.

0/2مهام منجزة
  1. غيّر قيمة shipping من null إلى {"address":{"city":"Alexandria"}} في محرر التجربة الثاني ولاحظ عرض اسم المدينة فوراً.

  2. أضف السطر prefs.theme = "dark" في محرر التجربة الثالث وتأكد من ظهور الحقل الجديد في نص JSON المُصدّر.

تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.

مساحة التحدي

اختبر فهمك.
ووصلها للإتقان.

كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.

10أسئلة 2أنواع تحديات 100%هدف الإتقان
تصحيح تلقائي. فرص بلا حدود.

أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.

الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.

لمحة عن التحدي10 أسئلة تنتظرك
01

كيف تقرأ خاصية يحتوي اسمها على شرطة وسطية مثل "user-role" من كائن JSON محلل باسم obj؟

02

إذا كان الكائن المحلل هو {"user":null}، فما نتيجة التعبير data.user?.name؟

03

لماذا يُعد التعبير data.score ?? 50 أدق من data.score || 50 عند قراءة حقل رقمي من JSON؟

04

بعد تحليل نص JSON عبر JSON.parse، يمكن تعديل خصائص الكائن الناتج أو حذفها بـ delete كأي كائن JavaScript عادي.

05

ما الدالة التي تحول الخصائص الذاتية لكائن JSON محلل إلى مصفوفة أزواج [key, value] لاستعراضها بحلقة for...of؟

06

ما الدالة القياسية التي تتحقق بدقة من وجود المفتاح "coupon" داخل الكائن حتى لو كانت قيمته تساوي null؟

07

تعديل نصوص JSON الخام مباشرةً باستبدال الحروف أكثر أماناً من تحليلها وتعديل الكائن ثم إعادة تصديرها.

08

ما الصياغة الصحيحة لدمج التسلسل الاختياري مع الوصول الديناميكي بالأقواس المربعة إذا احتُمل كون config فارغاً؟

09

ما المعامل الذي يحذف خاصية نهائياً من الكائن المحلل قبل إعادة تحويله إلى نص JSON؟

10

الوصول المتسلسل العادي order.shipping.city يُطلق خطأ TypeError إذا كانت قيمة order.shipping تساوي null.