typeof تضييق الأنواع بـ typeof

آخر تحديث: 2026-10-22

typeof تضييق الأنواع بـ typeof

حارس typeof هو أكثر حراسات الأنواع شيوعًا: في وقت التشغيل يعيد typeof سلسلة تصف نوع القيمة، ويضيّق TypeScript النوع الاتحادي تبعًا لذلك. فبعد typeof value === "string" مثلاً تُعامَل value بوصفها string ويصبح استدعاء دوال السلاسل آمنًا.

ℹ️ معلومة يحوّل المحرر لغة TypeScript إلى JavaScript ثم يشغّلها (بدون فحص أنواع)؛ راجع ناتج كل مثال لنتيجة فحص الأنواع.

📝 الصيغة

function toNumber(value: string | number): number {
  if (typeof value === "string") {
    return Number(value);   // value: string هنا
  }
  return value;             // value: number هنا
}

⚙️ المعاملات

القيمة المُعادة：يعيد تعبير typeof نفسه سلسلة النوع؛ أما تأثير التضييق فيحدث في وقت الترجمة — داخل الفرع يصبح نوع المتغير هو النوع المحدد المطابق.

▶ مثال

عدّل الكود أدناه واضغط «جرّب» لرؤية نتيجة التحويل:

الناتج：

string of length 5
number, doubled = 42
boolean: off

(مخرجات التشغيل بعد الترجمة؛ نجاح الفحص النوعي للوصول إلى value.length وvalue * 2 داخل كل case سببه أن تضييق typeof قد مُرِّر — التضييق مضمون ساكنًا بواسطة tsc، وفي وقت التشغيل لا توجد سوى القيم)

💡 نقاط مهمة

🏷️ تضييق الأنواع والتأكيدات ذو صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ أسئلة شائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن