تسهيل أنواع تايب سكريبت باستخدام الأدوات المساعدة (Utility Types)

تايب سكريبت (TypeScript) هي لغة قوية تضيف نظام أنواع ثابت إلى جافاسكريبت، مما يساعد في اكتشاف الأخطاء مبكرًا وتحسين قابلية صيانة الكود. أحد الجوانب الرائعة في تايب سكريبت هو مجموعة الأدوات المساعدة (Utility Types) التي تأتي معها. هذه الأدوات هي أنواع جاهزة الصنع تساعدك على إجراء تحويلات شائعة على الأنواع، مما يجعل تعريفات الأنواع الخاصة بك أكثر اختصارًا ووضوحًا وقوة.

في هذا المقال، سنستكشف بعضًا من أهم وأكثر أدوات تايب سكريبت المساعدة استخدامًا وكيف يمكنها أن تبسط عملك مع الأنواع.

ما هي الأدوات المساعدة في تايب سكريبت؟

الأدوات المساعدة في تايب سكريبت هي أنواع مُعرّفة مسبقًا تأخذ نوعًا موجودًا كمدخل وتُرجع نوعًا جديدًا مُحوّلًا. فكر فيها كدوال للأنواع! هذه الأدوات مبنية في لغة تايب سكريبت نفسها، مما يعني أنها متاحة للاستخدام مباشرة دون الحاجة إلى تثبيت أي شيء إضافي.

بعض الأدوات المساعدة الأساسية

لنستعرض بعضًا من الأدوات المساعدة الأكثر استخدامًا مع أمثلة بسيطة:

1. Partial<Type>

يجعل Partial<Type> جميع الخصائص في النوع Type اختيارية. هذا مفيد جدًا عندما تريد إنشاء نوع يمثل جزءًا من كائن، على سبيل المثال، عند تحديث كائن حيث قد لا يتم توفير جميع الخصائص.

1
interface User {
2
  id: number;
3
  name: string;
4
  email: string;
5
}
6

7
// جميع الخصائص في UpdatedUser اختيارية
8
type UpdatedUser = Partial<User>;
9

10
const updateUserInfo: UpdatedUser = {
11
  name: "اسم جديد",
12
  email: "newemail@example.com"
13
  // id غير مطلوب هنا
14
};

2. Required<Type>

على عكس Partial<Type>، يجعل Required<Type> جميع الخصائص في النوع Type مطلوبة. هذا مفيد عندما تريد التأكد من أن جميع الخصائص موجودة، خاصةً بعد استخدام Partial<Type> أو أنواع أخرى قد تجعل الخصائص اختيارية.

1
interface Config {
2
  apiKey?: string;
3
  timeout?: number;
4
}
5

6
// جميع الخصائص في FullConfig مطلوبة
7
type FullConfig = Required<Config>;
8

9
const appConfig: FullConfig = {
10
  apiKey: "your_api_key",
11
  timeout: 3000 // الآن مطلوب
12
};

3. Readonly<Type>

يجعل Readonly<Type> جميع الخصائص في النوع Type للقراءة فقط. هذا يحمي الكائنات من التعديل غير المقصود بعد إنشائها.

1
interface Point {
2
  x: number;
3
  y: number;
4
}
5

6
// خصائص ReadonlyPoint لا يمكن تغييرها بعد الإنشاء
7
type ReadonlyPoint = Readonly<Point>;
8

9
const initialPoint: ReadonlyPoint = { x: 10, y: 20 };
10
// initialPoint.x = 30; // خطأ! لا يمكن تعيين خاصية للقراءة فقط 'x'.

4. Pick<Type, Keys>

يختار Pick<Type, Keys> مجموعة من الخصائص (المحددة بواسطة Keys) من النوع Type لإنشاء نوع جديد. هذا مفيد عندما تحتاج فقط إلى جزء من النوع الأصلي.

1
interface Product {
2
  id: number;
3
  name: string;
4
  price: number;
5
  description: string;
6
}
7

8
// ProductSummary يحتوي فقط على 'name' و 'price'
9
type ProductSummary = Pick<Product, 'name' | 'price'>;
10

11
const summary: ProductSummary = {
12
  name: "اسم المنتج",
13
  price: 99.99
14
  // 'id' و 'description' ليسا موجودين هنا
15
};

5. Omit<Type, Keys>

على عكس Pick<Type, Keys>، يقوم Omit<Type, Keys> بإزالة مجموعة من الخصائص (المحددة بواسطة Keys) من النوع Type لإنشاء نوع جديد. هذا مفيد عندما تريد استبعاد خصائص معينة من النوع الأصلي.

1
interface Event {
2
  id: string;
3
  timestamp: Date;
4
  type: 'click' | 'mouseover' | 'submit';
5
  payload: any;
6
}
7

8
// EventMetadata لا يحتوي على 'payload'
9
type EventMetadata = Omit<Event, 'payload'>;
10

11
const eventInfo: EventMetadata = {
12
  id: "event123",
13
  timestamp: new Date(),
14
  type: 'click'
15
  // 'payload' غير موجود هنا
16
};

6. Record<Keys, Type>

ينشئ Record<Keys, Type> نوعًا كائنيًا حيث تكون مفاتيح الخصائص من النوع Keys وقيم الخصائص من النوع Type. غالبًا ما يستخدم لإنشاء قواميس أو خرائط بيانات.

1
type Status = 'pending' | 'processing' | 'completed';
2

3
// StatusMessages هو كائن حيث تكون المفاتيح هي قيم Status والقيم هي سلاسل نصية
4
type StatusMessages = Record<Status, string>;
5

6
const messages: StatusMessages = {
7
  pending: "قيد الانتظار...",
8
  processing: "جاري المعالجة...",
9
  completed: "اكتمل!"
10
};
11

12
console.log(messages.processing); // "جاري المعالجة..."

فوائد استخدام الأدوات المساعدة

استخدام الأدوات المساعدة في تايب سكريبت يوفر العديد من الفوائد:

• قابلية القراءة: تجعل تعريفات الأنواع أكثر وضوحًا وموجزة. بدلاً من كتابة أنواع معقدة يدويًا، يمكنك استخدام الأدوات المساعدة للتعبير عن التحويلات بشكل واضح.
• قابلية الصيانة: عند تغيير النوع الأصلي، يتم تحديث الأنواع المشتقة تلقائيًا إذا تم استخدام الأدوات المساعدة بشكل صحيح.
• تقليل التكرار: تجنب تكرار تعريفات الأنواع المشابهة. الأدوات المساعدة تسمح لك بإعادة استخدام الأنواع الموجودة وتعديلها حسب الحاجة.
• قوة التعبير: تسمح لك الأدوات المساعدة بالتعبير عن علاقات معقدة بين الأنواع بطريقة بسيطة وقوية.

الخلاصة

الأدوات المساعدة في تايب سكريبت هي مجموعة قوية من الأدوات التي يمكن أن تجعل عملك مع الأنواع أكثر كفاءة وفعالية. من خلال فهم واستخدام هذه الأدوات، يمكنك كتابة كود تايب سكريبت أكثر وضوحًا وقابلية للصيانة وأقل عرضة للأخطاء. استكشف المزيد من الأدوات المساعدة المتاحة في وثائق تايب سكريبت لتوسيع ترسانتك في تطوير أنواع قوية!

أتمنى أن يكون هذا المقال قد قدم لك نظرة عامة مفيدة على الأدوات المساعدة في تايب سكريبت. لا تتردد في تجربتها في مشاريعك القادمة!