تخطَّ إلى المحتوى

🔷 شرح TypeScript

الأنواع المساعدة و keyof

الدرس 17 من 28· ⏱ 3 دقائق قراءة· 🗓 آخر تحديث: ١٦ أكتوبر ٢٠٢٦

ما الأنواع المساعدة؟

أنواع جاهزة من TypeScript تحوّل نوعًا موجودًا إلى نوع جديد دون إعادة كتابته. لنفترض هذا النوع:

interface User {
  id: number;
  name: string;
  email: string;
}

Partial — كل الخصائص اختيارية

function updateUser(id: number, changes: Partial<User>) {
  // changes قد يحتوي بعض حقول User فقط
}
updateUser(1, { name: "اسم جديد" });   // صحيح

Required — كل الخصائص مطلوبة

عكس Partial — يجعل الاختياري إلزاميًّا.

Pick — اختيار حقول محدّدة

type UserPreview = Pick<User, "id" | "name">;
// { id: number; name: string }

Omit — استبعاد حقول

type UserWithoutEmail = Omit<User, "email">;
// { id: number; name: string }

Readonly — منع التعديل

const u: Readonly<User> = { id: 1, name: "علي", email: "a@b.com" };
u.name = "آخر";   // خطأ! readonly

Record — كائن بمفاتيح وقيم محدّدة النوع

type Roles = Record<string, boolean>;
const perms: Roles = { admin: true, editor: false };

// أو بمفاتيح محدّدة
type Page = "home" | "about";
const titles: Record<Page, string> = {
  home: "الرئيسية",
  about: "من نحن",
};

المعامل keyof

ينتج اتحاد مفاتيح نوع ما:

type UserKeys = keyof User;   // "id" | "name" | "email"

function getField(user: User, key: keyof User) {
  return user[key];
}

هذه الدالة تمنع المفاتيح غير الموجودة (getField(u, "age") خطأ ترجمة)، لكن نوع ما تُرجعه هو number | string دائمًا، لأن TypeScript لا يعرف أي مفتاح بالضبط مُرِّر. مع Generic يصبح النوع دقيقًا لكل مفتاح:

function getField<K extends keyof User>(user: User, key: K): User[K] {
  return user[key];
}

const u: User = { id: 1, name: "علي", email: "a@b.com" };
const id = getField(u, "id");       // number
const name = getField(u, "name");   // string

User[K] اسمه نوع الوصول بالفهرس (indexed access type): "نوع الخاصية K في User".

keyof typeof لكائن موجود

keyof يعمل على الأنواع فقط، لا على القيم. لتأخذ مفاتيح كائن حقيقي، حوّله لنوع أولًا بـ typeof:

const colors = { primary: "#7c5cff", danger: "#e11d48" };

type ColorName = keyof typeof colors;   // "primary" | "danger"
// type Bad = keyof colors;             // خطأ: colors قيمة لا نوع

⚠️ مع نوع فيه index signature نصّي مثل { [key: string]: number }، ينتج keyof النوع string | number، لأن JavaScript تحوّل المفاتيح الرقمية لنصوص.

جدول سريع

النوعالوظيفة
Partial<T>كل الحقول اختيارية
Required<T>كل الحقول مطلوبة
Pick<T, K>حقول محدّدة فقط
Omit<T, K>كل الحقول عدا المحدّدة
Readonly<T>منع التعديل
Record<K, V>كائن بمفاتيح/قيم منمَّطة

أخطاء شائعة

  • إعادة كتابة نوع معدّل يدويًّا بدل استخدام Partial/Omit.
  • الخلط بين Pick (يبقي) وOmit (يستبعد).
  • الخلط بين keyof (يعمل على الأنواع وقت الترجمة) وtypeof في JavaScript (يفحص نوع قيمة وقت التشغيل).

🎯 التالي: حُرّاس الأنواع (Type Guards) والتضييق.

شرح الأنواع المساعدة و keyof — TypeScript بالعربي
الأنواع المساعدة و keyof — TypeScript بالعربي · The Code Fix

📚 لمزيد من التعمّق في TypeScript، راجِع التوثيق الرسمي لـ TypeScript.

هل كان هذا الدرس مفيدًا؟