TypeScript Academy · درس

in و instanceof واتحادات الأنواع المميّزة

استخدم عمليات التحقق in ومن الخصائص، و instanceof للفئات، واتحادات الأنواع المميّزة للتفرّع بأمان.

الدرس 2 من 38 خطوة

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

مقدمة

الهدف: التدرب على ثلاثة guards قوية: in لفحص الخصائص، وinstanceof للفئات، وdiscriminated unions لإنشاء تفرعات واضحة.

عامل in

يضيّق in النوع من خلال اختبار اسم خاصية أثناء التشغيل. وهو مناسب جدًا لـ unions المكوّنة من object literals.

type HasLength = { length: number };

function print(v: string | HasLength) {
  if ("length" in v) {
    // v is HasLength
    console.log("len:", v.length);
  } else {
    // v is string
    console.log(v.toUpperCase());
  }
}

print({ length: 3 });
print("ts");

instanceof

يفحص instanceof النماذج الأولية للقيم المبنية على الفئات. ويعمل عندما يكون constructor متاحًا أثناء التشغيل.

class Person {
  constructor(public name: string) {}
}

function hello(x: Person | Date) {
  if (x instanceof Person) {
    console.log("Hi", x.name);
  } else {
    console.log("Year", x.getFullYear());
  }
}

hello(new Person("Ada"));
hello(new Date(2024, 0, 1));

Union مميّز

تستخدم discriminated unions وسمًا literal، مثل kind، للتبديل بوضوح مع تضييق كامل لكل حالة.

type Circle = { kind: "circle"; radius: number };
type Square = { kind: "square"; size: number };

type Shape = Circle | Square;

function area(s: Shape): number {
  switch (s.kind) {
    case "circle":
      return Math.PI * s.radius ** 2;
    case "square":
      return s.size * s.size;
  }
}

console.log(area({ kind: "circle", radius: 2 }));
console.log(area({ kind: "square", size: 3 }));

دمج الحواجز

ادمجوا فحوص الوسوم مع in لتضييق البنى المتداخلة والوصول إلى الأعضاء الآمنة فقط.

type FetchOk = { status: "ok"; data: { length: number } };
type FetchErr = { status: "error"; message: string };

type Result = FetchOk | FetchErr;

function handle(r: Result) {
  if (r.status === "ok" && "length" in r.data) {
    console.log("items:", r.data.length);
  } else {
    console.log("error:", r.message);
  }
}

handle({ status: "ok", data: { length: 5 } });
handle({ status: "error", message: "oops" });

إرشادات

إرشادات:

  • استخدموا in مع unions المعتمدة على الخصائص.
  • استخدموا instanceof مع الفئات.
  • استخدموا discriminated unions لإنشاء تدفق تحكم واضح.

تحقق من عامل in

تحقق سريع: أي عامل يفحص خاصية أثناء التشغيل ويضيّق الأنواع؟

مراجعة

مراجعة: يفحص in الخصائص، ويتحقق instanceof من الفئات، وتوفر discriminated unions عبارات switch واضحة وآمنة من ناحية النوع.

البدء مجانًا

تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
101
الدروس
352

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

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

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

ماذا ستتعلم في «in و instanceof واتحادات الأنواع المميّزة»؟

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

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

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

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

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

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

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

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

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