0Pricing
TypeScript Academy · درس

دوال حراسة الأنواع المعرّفة من المستخدم

اكتبوا predicates من نوع is لإنشاء حراس أنواع مخصّصين

دوال حراسة الأنواع المعرّفة من المستخدم درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

مرحبًا

تتيح حراس النوع التي يعرّفها المستخدم تغليف عملية التحقق من التضييق داخل دالة قابلة لإعادة الاستخدام، باستخدام نوع القيمة المرجعة الذي يتضمن المسند `is`.

نوع القيمة المرجعة للمسند is

تعيد دالة حارس النوع قيمة من الشكل `paramName is Type`. وعندما تعيد الدالة true، يضيّق TypeScript المعامل إلى ذلك النوع.
function isString(val: unknown): val is string {
  return typeof val === 'string';
}

استخدام حارس النوع

استدعِ حارس النوع في شرط if. وسيضيّق TypeScript النوع داخل الكتلة.
function process(val: unknown) {
  if (isString(val)) {
    console.log(val.toUpperCase()); // val: string
  }
}

حارس النوع للواجهات

بما أنه لا يمكنك استخدام instanceof مع الواجهات، فإن حراس النوع يمثلون الطريقة الأساسية لتضييق اتحادات الواجهات.
interface Cat { meow(): void }
interface Dog { bark(): void }
function isCat(pet: Cat | Dog): pet is Cat {
  return 'meow' in pet;
}

حراس النوع للكائنات المعقدة

اكتب حارس نوع يتحقق من شكل الكائن أثناء التشغيل قبل استخدامه باعتباره نوعًا محددًا.
interface User { name: string; age: number; }
function isUser(val: unknown): val is User {
  return (
    typeof val === 'object' &&
    val !== null &&
    typeof (val as any).name === 'string' &&
    typeof (val as any).age === 'number'
  );
}

حراس النوع مقابل التأكيدات

تتحقق حراس النوع أثناء التشغيل. أما تأكيدات النوع (as Type) فتُطبّق أثناء الترجمة فقط وقد تكون غير صحيحة. لذلك يُفضّل استخدام الحراس مع البيانات الخارجية.

‏Array.isArray باعتبارها حارس نوع

تُعد Array.isArray حارس نوع مضمّنًا. يفهمها TypeScript ويضيّق النوع وفقًا لذلك.
function flatten(val: string | string[]): string[] {
  return Array.isArray(val) ? val : [val];
}

حراس النوع العامة

يمكن أن تكون حراس النوع عامة لإنشاء أدوات تحقق قابلة لإعادة الاستخدام أثناء التشغيل.
function isNonNull<T>(val: T | null | undefined): val is T {
  return val !== null && val !== undefined;
}
const values = [1, null, 2, undefined].filter(isNonNull);
// values: number[]

دوال التأكيد

تطلق دوال التأكيد، باستخدام asserts، استثناءً إذا كان الشرط خاطئًا، وتضيّق النوع بعد الاستدعاء.
function assertIsString(val: unknown): asserts val is string {
  if (typeof val !== 'string') throw new TypeError('Not a string');
}
assertIsString(input);
console.log(input.toUpperCase()); // narrowed to string

مسؤولية حراس النوع

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

حراس النوع في filter وfind

مرّر حراس النوع مباشرةً إلى array.filter لتضييق نوع النتيجة.
const mixed: (string | null)[] = ['a', null, 'b'];
const strings = mixed.filter((x): x is string => x !== null);
// strings: string[]

تحقق سريع

ما تعليق نوع القيمة المرجعة الذي يحدد أن الدالة حارس نوع في TypeScript؟

مراجعة

تستخدم حراس النوع التي يعرّفها المستخدم أنواع قيمة مرجعة من الشكل `param is Type` لتغليف منطق التضييق. وهي تعمل مع filter وfind، وتتيح تضييق الواجهات، ويمكن جعلها عامة. أما دوال التأكيد فتضيّق النوع من دون إرجاع قيمة منطقية.

الأسئلة الشائعة

هل درس «دوال حراسة الأنواع المعرّفة من المستخدم» مجاني؟

نعم — نص درس «دوال حراسة الأنواع المعرّفة من المستخدم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «دوال حراسة الأنواع المعرّفة من المستخدم»؟

اكتبوا predicates من نوع is لإنشاء حراس أنواع مخصّصين تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «دوال حراسة الأنواع المعرّفة من المستخدم»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. تضييق النوع باستخدام typeof وقيم الصواب
  2. تضييق النوع باستخدام instanceof وin
  3. دوال حراسة الأنواع المعرّفة من المستخدم
  4. التحقق من الشمولية باستخدام never
← العودة إلى TypeScript Academy