Narrowing
متوسطكيف يتتبّع TypeScript فحوصك وعمليات الإرجاع المبكر عبر الدالة، فيضيّق اتحادًا مثل string | number | null حتى لا يبقى إلا نوع واحد.
لا شيء في النطاق بعد
لا أخطاء
Spaceتشغيل أو إيقاف←→الخطوة السابقة أو التاليةRالعودة إلى البداية
الشرح
وقت القراءة: 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:
تُعرَّف value كاتحاد (union): string | number | null. وإلى أن تفحصها، لا يمكنك استخدام إلا ما تشترك فيه الأنواع الثلاثة.
السطر 1
- الخطوة 2:
value === nullحارس نوع (type guard). فداخل هذا الشرط يعرف TypeScript أن value هي null.السطر 2
- الخطوة 3:
هذا الفرع يُرجع قيمة، لذا لا يمكن لـ null أن تتجاوزه أبدًا. وبعد الشرط تصبح value من النوع string | number.
الأسطر 3–4
- الخطوة 4:
يضيّق
typeof value === "string"النوع مجددًا: ففي هذا الفرع value نص (string)، لذا يُسمح بـ.length.الأسطر 6–7
- الخطوة 5:
في فرع else يُستبعد string ولا يبقى إلا number، لذا يُسمح بدالة الأرقام
toFixed.الأسطر 8–9
- الخطوة 6:
بعد if/else يلتقي الفرعان من جديد، فتعود value إلى string | number.
السطر 10
- الخطوة 7:
يضيّق هذا الفحص value إلى number، ويُرجع الفرع قيمة.
الأسطر 12–13
- الخطوة 8:
بعد ذلك الإرجاع المبكر يختفي number أيضًا. ففي هذا السطر الأخير لا يمكن أن تكون value إلا نصًّا.
السطر 16
- الخطوة 9:
لو أزلت الفحوص لبقيت value هنا من النوع string | number | null. وعندها يُبلغ TypeScript عن خطأين.
السطر 16
- الخطوة 10:
أما مع الفحوص فإن value نص في هذا السطر، لذا تعمل
toUpperCaseويختفي الخطآن.السطر 16
- الخطوة 11:
يتتبّع TypeScript كودك: فكل فحص وكل إرجاع مبكر يضيّق الاتحاد، والأنواع المتبقية وحدها تحدّد ما يُسمح لك به.