TypeScript Academy · درس

المصفوفات والصفائف readonly

امنعوا تعديل المصفوفات والصفائف باستخدام دوال التغيير

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

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

المصفوفات للقراءة فقط

المصفوفة للقراءة فقط هي مصفوفة يمكنك القراءة منها، لكن لا يمكنك تعديلها. اكتبها بصيغة readonly number[] أو بصيغة ReadonlyArray<number> المكافئة لها. ويظل نوع العنصر كما هو؛ أما التغيير فقط فممنوع.

const nums: readonly number[] = [1, 2, 3];
console.log(nums[0], nums.length);
// nums[0] = 9; // Error: index signature is readonly

نوع ReadonlyArray

ReadonlyArray<T> هو الصيغة العامة، وله المعنى نفسه تمامًا مثل readonly T[]. استخدم الصيغة الأسهل قراءة؛ فهما قابلتان للتبادل.

const names: ReadonlyArray<string> = ['Ada', 'Sam'];
console.log(names.join(', '));

لا توجد أساليب لتغيير المصفوفة

تحذف المصفوفات للقراءة فقط أساليب التغيير بالكامل. فلا تتوفر push وpop وsplice وsort وreverse — إذ إن النوع لا يحتوي عليها حرفيًا.

const items: readonly string[] = ['a', 'b'];
// items.push('c'); // Error: push does not exist
// items.splice(0, 1); // Error
console.log(items.length);

تظل الأساليب غير المغيِّرة متاحة

تظل الأساليب التي تعيد قيمة جديدة بدلًا من التغيير — مثل map وfilter وconcat وslice — متاحة. فهي تنشئ مصفوفات جديدة وتترك الأصلية دون تغيير.

const nums: readonly number[] = [1, 2, 3];
const doubled = nums.map((n) => n * 2);
console.log(doubled); // new array, nums unchanged

المصفوفات للقراءة فقط كمعاملات

يشير قبول readonly T[] في دالة إلى أنك لن تغيّر مصفوفة المستدعي. وهذا يوثّق القصد ويتيح للمصرّف فرض هذا الالتزام.

function sum(values: readonly number[]): number {
  return values.reduce((a, b) => a + b, 0);
}
console.log(sum([10, 20, 30]));

يمكن إسناد المصفوفات القابلة للتغيير إلى المصفوفات للقراءة فقط

يمكن إسناد number[] عادية إلى معامل من النوع readonly number[] — فأنت تتعهد فقط بعدم تغييرها. أما العكس فغير مسموح به.

function total(v: readonly number[]): number {
  return v.reduce((a, b) => a + b, 0);
}
const mutable: number[] = [1, 2, 3];
console.log(total(mutable)); // ok

Tuples للقراءة فقط

يمكن أن تكون Tuples للقراءة فقط أيضًا: readonly [string, number]. إذ تكون أنواع العناصر وترتيبها ثابتين، ولا يمكن إعادة إسناد المواضع الفردية.

const pair: readonly [string, number] = ['age', 30];
console.log(pair[0], pair[1]);
// pair[1] = 31; // Error: readonly tuple

تمنع Tuples للقراءة فقط التغيير

مثل المصفوفات للقراءة فقط، تزيل Tuples للقراءة فقط أساليب التغيير وترفض الإسناد إلى الفهارس. وهي مثالية للسجلات ذات البنية الثابتة، مثل أزواج الإحداثيات.

const point: readonly [number, number] = [3, 4];
// point.push(5); // Error
// point[0] = 0; // Error
console.log(point[0] + point[1]);

تصريح const مقابل نوع readonly

تختلف طريقتان للحصول على مصفوفات للقراءة فقط اختلافًا دقيقًا. يحافظ التصريح readonly number[] على نوع عام للعناصر. أما as const فيذهب إلى أبعد من ذلك، إذ ينشئ tuple للقراءة فقط من أنواع حرفية.

const a: readonly number[] = [1, 2, 3]; // elements: number
const b = [1, 2, 3] as const;            // readonly [1, 2, 3]
console.log(a[0], b[0]);

الاختيار بينهما

استخدم تصريح readonly T[] عندما تريد عدم القابلية للتغيير مع أنواع عناصر عامة. واستخدم as const عندما تحتاج أيضًا إلى القيم الحرفية الدقيقة، مثلًا لاشتقاق اتحاد.

const DAYS = ['Mon', 'Tue', 'Wed'] as const;
type Day = typeof DAYS[number]; // 'Mon' | 'Tue' | 'Wed'
const d: Day = 'Tue';
console.log(d);

عدم قابلية البيانات المشتركة للتغيير

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

const ALLOWED_PORTS: readonly number[] = [80, 443, 8080];
function isAllowed(p: number): boolean {
  return ALLOWED_PORTS.includes(p);
}
console.log(isAllowed(443), isAllowed(22));

اختبار سريع

اختبر مدى فهمك للمصفوفات وtuples للقراءة فقط.

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

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

لقد تعلمت أن:

يمنع readonly T[] / ReadonlyArray<T> التغيير، لكنه يسمح بالقراءة وباستخدام الأساليب غير المغيِّرة.
تُزال أساليب التغيير مثل push/splice من النوع.
تثبّت Tuples للقراءة فقط كلًا من الطول وأنواع العناصر.
يذهب as const إلى أبعد من ذلك، إذ ينشئ Tuples للقراءة فقط من أنواع حرفية.

بعد ذلك، سنتناول أنواع المجموعات للقراءة فقط.

const config: readonly string[] = ['a', 'b'];
const upper = config.map((s) => s.toUpperCase());
console.log(upper);

البدء مجانًا

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

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

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

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

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

هل درس «المصفوفات والصفائف readonly» مجاني؟

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

ماذا ستتعلم في «المصفوفات والصفائف readonly»؟

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

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

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

كم من الوقت يستغرق درس «المصفوفات والصفائف readonly»؟

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

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

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

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

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