TypeScript Academy · درس

ReadonlyArray وReadonlyMap

استخدموا أنواع المجموعات readonly المضمّنة

الدرس 3 من 413 خطوة

ReadonlyArray وReadonlyMap درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

أنواع المجموعات للقراءة فقط

إلى جانب المصفوفات، توفر TypeScript إصدارات للقراءة فقط من مجموعاتها المضمنة: ReadonlyArray<T> وReadonlyMap<K, V> وReadonlySet<T>. ويعرض كل نوع منها الأجزاء غير المعدِّلة فقط من واجهة برمجته.

const arr: ReadonlyArray<number> = [1, 2, 3];
console.log(arr.length, arr.includes(2));

مراجعة ReadonlyArray

يتيح ReadonlyArray<T> التكرار والفهرسة وأساليب مثل map وfilter، لكنه لا يتيح push أو pop أو إسناد قيمة إلى فهرس. وهو شكل المصفوفة ضمن عائلة الأنواع للقراءة فقط.

const tags: ReadonlyArray<string> = ['ts', 'js'];
console.log(tags.map((t) => t.toUpperCase()));
// tags.push('css'); // Error

ReadonlyMap

يتيح لك ReadonlyMap<K, V> البحث عن المفاتيح والتكرار والتحقق منها، لكنه يزيل set وdelete وclear. وتبدو محتويات الخريطة ثابتة من منظور المستهلك.

const ages: ReadonlyMap<string, number> = new Map([['Ada', 30], ['Sam', 25]]);
console.log(ages.get('Ada'), ages.has('Sam'));
// ages.set('Lee', 40); // Error

القراءة من ReadonlyMap

تبقى جميع عمليات القراءة متاحة: get وhas وsize وkeys وvalues وentries والتكرار. أما الأساليب المعدِّلة وحدها فقد أُزيلت.

const m: ReadonlyMap<string, number> = new Map([['a', 1], ['b', 2]]);
for (const [k, v] of m) {
  console.log(k, v);
}
console.log('size:', m.size);

ReadonlySet

يدعم ReadonlySet<T> التحقق من العضوية والتكرار، لكنه يزيل add وdelete وclear. استخدمه للمجموعات الثابتة من القيم المسموح بها.

const allowed: ReadonlySet<string> = new Set(['read', 'write']);
console.log(allowed.has('read'), allowed.has('delete'));
// allowed.add('admin'); // Error

التكرار على ReadonlySet

يمكنك التكرار على ReadonlySet وقراءة size الخاصة به، لكن لا يمكنك تغيير محتوياته. وهذا يجعله مناسبًا جدًا للقوائم المسموح بها ومجموعات الصلاحيات.

const perms: ReadonlySet<string> = new Set(['view', 'edit']);
perms.forEach((p) => console.log('perm:', p));
console.log('count:', perms.size);

تمرير المجموعات للقراءة فقط إلى الدوال

اقبل نوع مجموعة للقراءة فقط في الدوال التي ينبغي لها القراءة وحدها. فهذا يوضح القصد ويمنع الدالة من تعديل البيانات التي يملكها المستدعي.

function describe(set: ReadonlySet<string>): string {
  return 'has ' + set.size + ' items';
}
const s = new Set(['x', 'y']);
console.log(describe(s));

يمكن إسناد المجموعات القابلة للتعديل

يمكن إسناد Map أو Set عادي إلى نظيره للقراءة فقط، لأنك تقلّص الإمكانات ولا توسّعها. فالدالة تتخلى ببساطة عن صلاحيات التعديل.

function keys(m: ReadonlyMap<string, number>): string[] {
  return Array.from(m.keys());
}
const real = new Map([['a', 1]]);
console.log(keys(real));

واجهات برمجة المجموعات غير القابلة للتغيير

تصف أنواع المجموعات للقراءة فقط عرضًا غير قابل للتغيير. وقد يظل الكائن الأساسي قابلًا للتعديل في موضع آخر؛ فالنوع للقراءة فقط يقيّد ما يمكن لهذا المرجع فعله فحسب.

const backing = new Set<number>([1, 2]);
const view: ReadonlySet<number> = backing;
// view.add(3); // Error through the readonly view
backing.add(3); // but the original can still mutate
console.log(view.size);

اختيار نوع القراءة فقط المناسب

طابق النوع للقراءة فقط مع بنية بياناتك: استخدم ReadonlyArray للقوائم المرتبة، وReadonlyMap للبحث باستخدام أزواج المفتاح والقيمة، وReadonlySet للعضوية الفريدة. ويفرض كل نوع عدم التغيير على البنية التي يمثلها.

const roles: ReadonlySet<string> = new Set(['admin', 'user']);
const limits: ReadonlyMap<string, number> = new Map([['admin', 100]]);
console.log(roles.has('user'), limits.get('admin'));

حالة مشتركة أكثر أمانًا

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

class Registry {
  private items = new Set<string>();
  add(name: string): void { this.items.add(name); }
  get all(): ReadonlySet<string> { return this.items; }
}
const r = new Registry();
r.add('a');
console.log(r.all.has('a'));

تحقق سريع

اختبر فهمك لأنواع المجموعات للقراءة فقط.

أجب عليها في الدرس التفاعلي

مراجعة: المجموعات للقراءة فقط

تعلمت عائلة المجموعات للقراءة فقط:

يعرض ReadonlyArray<T> وReadonlyMap<K, V> وReadonlySet<T> عمليات القراءة فقط.
تُزال الأساليب المعدِّلة مثل set وadd وdelete وpush.
يمكن إسناد المجموعات القابلة للتعديل إلى نظيراتها للقراءة فقط.
وتُعد أنواعًا ممتازة للمعاملات والقيم المعادة من أجل حالة مشتركة أكثر أمانًا.

وأخيرًا، أنماط عدم التغيير العميق.

function count(s: ReadonlySet<number>): number {
  return s.size;
}
console.log(count(new Set([1, 2, 3])));

البدء مجانًا

تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات: 101
الدروس: 352

ابدأ التعلم مجانًا عرض الدورة الكاملة

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

هل درس «ReadonlyArray وReadonlyMap» مجاني؟

نعم — نص درس «ReadonlyArray وReadonlyMap» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «ReadonlyArray وReadonlyMap»؟

استخدموا أنواع المجموعات readonly المضمّنة تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «ReadonlyArray وReadonlyMap»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى TypeScript Academy