قيود Generics

Generic Constraints

مفهوم ~19 دقيقة

قيود Generics — Generic Constraints

أحياناً تريد generic، لكنك تحتاج ضمان وجود خاصية معينة. مثلاً دالة تطبع id لأي كائن يملك id. نكتب ذلك بـT extends { id: string }. هكذا تبقى الدالة مرنة، لكنها ليست مفتوحة لأي شيء.

بدون constraint، TypeScript لا يسمح بالوصول إلى value.id لأن T قد يكون رقماً أو نصاً. constraint يخبره أن كل نوع مقبول يجب أن يملك هذه الخاصية.

مثال عملي

index.ts

function labelById<T extends { id: string }>(item: T): string {
  return `id=${item.id}`;
}

const lesson = { id: "ts-06-03", title: "Constraints" };
const user = { id: "u-1", name: "Sara" };

console.log(labelById(lesson));
console.log(labelById(user));

Output:

الدالة لا تهتم ببقية الخصائص، لكنها تضمن وجود id.

القيود لا تعني تعقيداً

استخدم constraint عندما تحتاج خاصية حقيقية. لا تضف قيوداً كثيرة تجعل الدالة أصعب من كتابة نوع مباشر.

تحدي — Challenge

function labelName<T extends { name: string }>(item: T): string {
  /* TODO */
  return ""; // أرجع name=<الاسم> — Return name=<name>
}

console.log(labelName({ name: "AzLearn", kind: "platform" }));