Utility Types

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

Utility Types

TypeScript توفر utility types جاهزة لتشكيل أنواع جديدة. Pick<User, "id" | "name"> يأخذ جزءاً من النوع. Partial<User> يجعل كل الخصائص اختيارية. Readonly<User> يمنع تعديل الخصائص. هذه الأدوات تقلل التكرار عندما تستخدمها بوعي.

لا تستخدم Partial كحل عام لكل مشكلة. إذا كانت دالة تحتاج فقط تحديث البريد، ربما اكتب نوعاً أدق. لكن في update forms أو patch objects، Partial قد يكون مناسباً.

مثال عملي

index.ts

type User = {
  id: number;
  name: string;
  email: string;
};

type UserPreview = Pick<User, "id" | "name">;
type UserPatch = Partial<User>;

const preview: UserPreview = { id: 1, name: "Sara" };
const patch: UserPatch = { email: "sara@example.com" };

console.log(preview.name);
console.log(Object.keys(patch).length);

Output:

هذه الأنواع مشتقة من User. إذا تغير اسم خاصية في User، ستظهر الأخطاء في المشتقات.

utility types إضافية — Additional Utility Types

المجموعة الأساسية أكبر من Pick/Partial/Readonly. إليك أهمها:

index.ts

type User = {
  id: number;
  name: string;
  email: string;
  password: string;
};

// Omit — احذف خاصية أو أكثر من النوع
type Without = Omit<User, "password">;

// Record — أنشئ نوع بمفاتيح وقيم محددة
type ById = Record<string, User>;

// Required — اجعل كل الخصائص الاختيارية إلزامية
type Strict = Required<Partial<User>>;

async function fetchUser(id: number): Promise<User> {
  return { id, name: "Sara", email: "sara@example.com", password: "***" };
}

// ReturnType — استخرج نوع القيمة المرجعة من دالة
type ReturnedFromFetch = ReturnType<typeof fetchUser>;
// => Promise<User>

// Parameters — استخرج أنواع معاملات الدالة كـ tuple
type FetchArgs = Parameters<typeof fetchUser>;
// => [number]

const safe: Without = { id: 1, name: "Sara", email: "sara@example.com" };
console.log(safe.name);

Output:

استخدم هذه الأنواع لتجنب التكرار. نوع Without يضمن أن password لن تُرسَل للعميل. نوع FetchArgs يُمكّنك من توثيق توقعات الاختبار بدون تكرار.

تصفية الـ union — Filtering Unions

Exclude وExtract يعملان على union types لتصفيتها:

index.ts

// Exclude — احتفظ بالأنواع في T التي لا تنتمي لـ U
type Status = "active" | "inactive" | "pending";
type Final = Exclude<Status, "pending">; // "active" | "inactive"

// Extract — احتفظ بالأنواع في T التي تنتمي لـ U
type Mixed = string | number | boolean;
type Strings = Extract<Mixed, string>; // string

const s: Final = "active";
const t: Strings = "hello";
console.log(s, t);

Output:

Exclude يُستخدم لإزالة حالة من union (مفيد عند إخفاء خيار مؤقت). Extract يُستخدم لعزل نوع معين من union عام (مفيد عند التضييق).

تحدي — Challenge

type User = {
  id: number;
  name: string;
  email: string;
};

type UserPreview = Pick<User, "name">;
const preview: UserPreview = { name: "Sara" };

// اطبع الاسم — Print the name