مصفوفات الـ Generic

جزء من قسم Introduction To TypeScript في رحلة JavaScript على Coddy — الدرس 60 من 73.

تعمل المصفوفات والأنواع العامة (generics) معًا بشكل رائع في TypeScript. عندما تعلمت عن المصفوفات المحددة النوع سابقًا، استخدمت صيغة T[] لتحديد أن المصفوفة يمكن أن تحتوي فقط على عناصر من نوع معين. تمنحك الأنواع العامة طريقة أخرى للتعبير عن هذا المفهوم نفسه.

يوفر TypeScript صيغة بديلة للمصفوفات المحددة النوع باستخدام تنسيق Array<T>:

// هذان التصريحان متكافئان:
let numbers1: number[] = [1, 2, 3];
let numbers2: Array<number> = [1, 2, 3];

يُعد بناء الجملة Array<T> مفيدًا بشكل خاص عند العمل مع الدوال العامة (generic functions) التي تتعامل مع المصفوفات. فهو يجعل الطبيعة العامة لكودك أكثر وضوحًا وقابلية للقراءة، خاصةً عندما تقوم بإنشاء دوال يمكنها العمل مع مصفوفات من أي نوع مع الحفاظ على سلامة النوع (type safety).

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

التحدي

سهل

قم بإنشاء دالة عامة (generic function) تسمى getFirstElement تأخذ مصفوفة من أي نوع وتعيد العنصر الأول أو undefined إذا كانت المصفوفة فارغة.

يجب أن تقوم الدالة بما يلي:

استخدام معامل نوع عام T
قبول معامل واحد يسمى arr من نوع Array<T>
إعادة العنصر الأول من النوع T أو undefined
أن تحتوي على توصيف صريح لنوع القيمة المرجعة وهو T | undefined

قم بإنشاء المصفوفات التالية باستخدام صيغة Array<T>:

stringArray من نوع Array<string> تحتوي على ["apple", "banana", "cherry"]
numberArray من نوع Array<number> تحتوي على [10, 20, 30, 40]
booleanArray من نوع Array<boolean> تحتوي على [true, false, true]
emptyStringArray من نوع Array<string> وتكون فارغة

اختبر الدالة الخاصة بك وقم بطباعة المخرجات التالية:

اطبع نتيجة استدعاء getFirstElement مع stringArray
اطبع نتيجة استدعاء getFirstElement مع numberArray
اطبع نتيجة استدعاء getFirstElement مع booleanArray
اطبع نتيجة استدعاء getFirstElement مع emptyStringArray
اطبع نتيجة استدعاء getFirstElement مع Array<string> جديد يحتوي على ["single"]

ورقة مرجعية

توفر TypeScript صيغتين متكافئتين للمصفوفات المحددة النوع:

// هذان التصريحان متكافئان:
let numbers1: number[] = [1, 2, 3];
let numbers2: Array<number> = [1, 2, 3];

تعتبر صيغة Array<T> مفيدة بشكل خاص عند العمل مع الدوال العامة (generic functions) التي تتعامل مع المصفوفات، مما يجعل الطبيعة العامة لكودك أكثر وضوحاً وقابلية للقراءة مع الحفاظ على سلامة الأنواع (type safety).

جرّب بنفسك

// TODO: اكتب كودك هنا
// أنشئ الدالة العامة getFirstElement

// أنشئ المصفوفات المطلوبة باستخدام صيغة Array<T>

// اختبر الدالة واطبع النتائج

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس Introduction To TypeScript

1البداية مع TS

ما هي TypeScript؟لماذا نستخدم TypeScript؟أول كود TypeScript لك عملية الـ Compilation والأخطاء ملخص: مقدمة في TS

4التعامل مع الدوال

تحديد أنواع المعاملات وقيم الإرجاع تحديد أنواع Arrow Functions نوع الإرجاع 'void'المعاملات الاختيارية باستخدام '?'القيم الافتراضية للمعاملات تحديد أنواع Rest Parameters تعريف أنواع الدوال ملخص: بناء دوال محددة الأنواع

7مشروع: قائمة مهام بسيطة

مشروع: تعريف الـ Struct للمهمة دالة لإضافة مهمة

دالة لتغيير حالة المهمة

دالة: عرض المهام حسب الحالة

دالة: طباعة ملخص المهام

تجميع كل الأجزاء معاً

10مشروع: إدارة المخزون

مشروع: عنصر مخزون عام دالة: إضافة عناصر إلى المخزون

دالة للبحث عن عنصر بواسطة ID

إنشاء نوع مخزون محدد

دالة للحصول على تفاصيل العنصر

2الأنواع الأساسية

الأنواع الأساسية: str, num, boolean النوع 'any': مخرج الهروب النوع 'unknown'التعامل مع 'null' و 'undef'استنتاج الأنواع في التطبيق العملي توضيحات الأنواع الصريحة مراجعة: تدريب على الأنواع الأساسية

5الأنواع: الأسماء المستعارة، الاتحادات والتقاطعات

الأسماء المستعارة للأنواع الأساسية (Primitives)أنواع الاتحاد ('|')التعامل مع أنواع الاتحاد الأنواع الحرفية (Literal Types)أنواع التقاطع ('&')دمج الأسماء المستعارة للأنواع ملخص: تركيبات الأنواع المتقدمة

8Enums

ما هو الـ Numeric Enum؟استخدام الـ Numeric Enums ما هو الـ String Enum؟استخدام الـ String Enums الـ Heterogeneous Enums ملخص: استخدام الـ Enums

11مواضيع متقدمة

تأكيدات النوع حراس النوع: in و instanceof النوع 'never'الأنواع القابلة للقيمة Null ('strictNull')تواقيع الفهرسة للكائنات ملخص: ضبط الأنواع بدقة

3هياكل البيانات: المصفوفات و Tuple

المصفوفات محددة النوع (Typed Arrays)معدل 'readonly' للمصفوفات ما هو الـ Tuple؟تعريف والوصول إلى الـ Tuples تفكيك الـ Tuples (Destructuring)الـ Tuples للقراءة فقط (Readonly)المصفوفات محددة النوع متعددة الأبعاد استخدام Spread Operator مع المصفوفات ملخص: المصفوفات و Tuples

6تحديد أنواع الكائنات والواجهات

توصيف أنواع الكائنات المضمنة (Inline)الأسماء المستعارة للأنواع (Type Aliases) للكائنات مقدمة عن الواجهات (Interfaces)الواجهات (Interfaces) مقابل الأسماء المستعارة للأنواع (Type Aliases)الخصائص الاختيارية وخصائص القراءة فقط (Readonly)توسيع الواجهات والأنواع إضافة الدوال (Methods) إلى الواجهات ملخص: تحديد هياكل الكائنات

9Generics: نظرة أولى

المشكلة التي تحلها الـ Generics إنشاء دالة Generic Identity استخدام دالة Genericمصفوفات الـ Genericواجهات الـ Generic ملخص: تدريب على الدوال العامة