الأدوية العامة الأساسية

الأسماء العامة (البرمجة العامة) هي إحدى أقوى ميزات TypeScript. إنها تسمح لك بكتابة مكونات ووظائف وواجهات مرنة وقابلة لإعادة الاستخدام يمكنها العمل مع أنواع مختلفة من البيانات مع الحفاظ على الحد الأقصى من أمان النوع وتجنب استخدام any.

وظائف عامة

فكر في عام كمتغير للأنواع. لنفكر في دالة تُرجع القيمة التي تم تمريرها إليها كوسيطة:

function identity<T>(arg: T): T {
  return arg;
}

الحرف T (اختصار لـ Type) هو عنصر نائب للنوع. عندما نستدعي identity، يلتقط TypeScript نوع الوسيط الذي تم تمريره ويقوم تلقائيًا بتعيين T على هذا النوع:

const str = identity<string>('Hello'); // T is string
const num = identity(42); // T is number (automatically inferred!)

الواجهات العامة والأسماء المستعارة

يمكن أيضًا تطبيق الأدوية العامة على الواجهات وكتابة الأسماء المستعارة لتحديد الحاويات العامة أو هياكل البيانات:

interface Box<T> {
  content: T;
}

const stringBox: Box<string> = { content: 'TypeScript' };
const numberBox: Box<number> = { content: 42 };

معلمات نوع متعددة

يمكننا تعريف الوظائف أو الأنواع التي تستخدم متغيرات أنواع متعددة (على سبيل المثال، T و U):

function mergeObjects<T, U>(obj1: T, obj2: U): T & U {
  return { ...obj1, ...obj2 };
}

القيود العامة

في بعض الأحيان نريد تحديد الأنواع التي يقبلها النوع العام. يمكننا استخدام الكلمة الأساسية extends لإضافة قيد.

على سبيل المثال، إذا أردنا أن يكون للنوع العام دائمًا خاصية length (مثل السلاسل أو المصفوفات):

interface HasLength {
  length: number;
}

function logLength<T extends HasLength>(arg: T): void {
  console.log(arg.length); // Safe! We know arg has 'length'
}

logLength('Hello'); // Valid
logLength([1, 2, 3]); // Valid
// logLength(42); // Error: number does not have a length property!

جربه بنفسك

التمرين 1: وظيفة الهوية العامة

التمرين 2: غلاف الصندوق العام

التمرين 3: القيد العام

التمرين 4: الزوج العام