انتقل إلى المحتوى
يوتركي تيك
كل مواضيع TypeScript

Narrowing

متوسط

كيف يتتبّع TypeScript فحوصك وعمليات الإرجاع المبكر عبر الدالة، فيضيّق اتحادًا مثل string | number | null حتى لا يبقى إلا نوع واحد.

الأنواع في النطاق

لا شيء في النطاق بعد

الأخطاء

لا أخطاء

0/11اضغط تشغيل، أو تقدّم خطوة بخطوة بالأسهم، لتبدأ.
الخطوة 0 من 11

الشرح

وقت القراءة: 2 د

في هذه الصفحة

ما هو التضييق (narrowing) في TypeScript؟

نوع الاتحاد (union type) مثل string | number | null يعني أن القيمة قد تكون أيًّا من عدة أنواع. وهذا صادق لكنه مُقيِّد: فلا يسمح TypeScript إلا باستخدام ما تشترك فيه كل الأنواع، لذا يكون value.toUpperCase() خطأً إلى أن تُثبت أن value نص.

والتضييق (narrowing) هو طريقة هذا الإثبات. فحين تفحص قيمة، يحسب TypeScript أي أنواع الاتحاد ما زال يمكنها الوصول إلى كل سطر، ويعطي القيمة هناك ذلك النوع الأصغر، المُضيَّق.

كيف يضيّق TypeScript النوع؟

يقرأ كودك بالترتيب الذي يُنفَّذ به، وهي عملية تُسمّى ، ويتعرّف على فحوص تُسمّى حرّاس الأنواع (type guards):

  • المساواة: value === null وvalue !== undefined وshape.kind === 'circle'.
  • typeof: مثل typeof value === 'string' للأنواع البدائية (string وnumber وboolean وbigint وsymbol وundefined وfunction وobject).
  • instanceof: مثل error instanceof TypeError للأصناف.
  • in: مثل 'radius' in shape للتحقّق من وجود خاصية.
  • القيمة المنطقية: if (value) تستبعد null وundefined (وبقية القيم الخاطئة falsy).
  • حرّاسك الخاصون: دالة تُرجع value is Fish تخبر TypeScript بمعنى النتيجة true.

والفروع مهمة أيضًا. فداخل if يُضيَّق النوع، وفي else تُستبعد الأنواع التي فُحصت. وبعد فرع ينتهي دائمًا بـ return أو throw، لا يعود ما عالجه قادرًا على الظهور، لذا يضيّق الإرجاع المبكر بقية الدالة. وحيث تلتقي الفروع من جديد، تتّحد الأنواع مرة أخرى في اتحاد.

ما الأخطاء الشائعة مع التضييق؟

مثال مصغّر

الاتحاد المميَّز (discriminated union) يعطي كل نوع فيه خاصية حرفية مشتركة، هنا kind. وفحصها يضيّق إلى نوع واحد بالضبط، ويعرف TypeScript أيضًا أن switch يغطّي كل الحالات:

type Shape = { kind: 'circle'; radius: number } | { kind: 'square'; side: number }; function area(shape: Shape): number {  switch (shape.kind) {    case 'circle':      return Math.PI * shape.radius ** 2; // shape: the circle member    case 'square':      return shape.side ** 2; // shape: the square member  }}

اختبر نفسك

داخل case "circle": في المثال المصغّر، ما نوع shape؟

للمزيد من القراءة

كل الخطوات كنص
  1. الخطوة 1:

    تُعرَّف value كاتحاد (union): string | number | null. وإلى أن تفحصها، لا يمكنك استخدام إلا ما تشترك فيه الأنواع الثلاثة.

    السطر 1

  2. الخطوة 2:

    value === null حارس نوع (type guard). فداخل هذا الشرط يعرف TypeScript أن value هي null.

    السطر 2

  3. الخطوة 3:

    هذا الفرع يُرجع قيمة، لذا لا يمكن لـ null أن تتجاوزه أبدًا. وبعد الشرط تصبح value من النوع string | number.

    الأسطر 3–4

  4. الخطوة 4:

    يضيّق typeof value === "string" النوع مجددًا: ففي هذا الفرع value نص (string)، لذا يُسمح بـ .length.

    الأسطر 6–7

  5. الخطوة 5:

    في فرع else يُستبعد string ولا يبقى إلا number، لذا يُسمح بدالة الأرقام toFixed.

    الأسطر 8–9

  6. الخطوة 6:

    بعد if/else يلتقي الفرعان من جديد، فتعود value إلى string | number.

    السطر 10

  7. الخطوة 7:

    يضيّق هذا الفحص value إلى number، ويُرجع الفرع قيمة.

    الأسطر 12–13

  8. الخطوة 8:

    بعد ذلك الإرجاع المبكر يختفي number أيضًا. ففي هذا السطر الأخير لا يمكن أن تكون value إلا نصًّا.

    السطر 16

  9. الخطوة 9:

    لو أزلت الفحوص لبقيت value هنا من النوع string | number | null. وعندها يُبلغ TypeScript عن خطأين.

    السطر 16

  10. الخطوة 10:

    أما مع الفحوص فإن value نص في هذا السطر، لذا تعمل toUpperCase ويختفي الخطآن.

    السطر 16

  11. الخطوة 11:

    يتتبّع TypeScript كودك: فكل فحص وكل إرجاع مبكر يضيّق الاتحاد، والأنواع المتبقية وحدها تحدّد ما يُسمح لك به.