NonNullable<T>

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

NonNullable<T> NonNullable

يستبعد NonNullable<T> من النوع T كلاً من null وundefined. وهو مناسب للحالات التي «يُسمح فيها بالفراغ في الإعلان لكن العمل يضمن عدمه عند هذا الموضع» — كالرجوع إلى القيم الافتراضية أو التصفية بعد فلترة المصفوفات. وهو في جوهره اسم مخصص لـ Exclude<T, null | undefined>.

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

📝 الصيغة

type NonNullable<T> = T extends null | undefined ? never : T;

// الاستخدام
type Name = NonNullable<string | null | undefined>;  // string

function pickFirst(values: Array<string | null | undefined>): string {
  for (const v of values) {
    if (v != null) {
      const clean: NonNullable<typeof v> = v;
      return clean;
    }
  }
  return "(none)";
}

⚙️ المعاملات

القيمة المُعادة：نوع جديد: T بعد إزالة null وundefined.

▶ مثال

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

الناتج：

Ada
(none)

(مخرجات التشغيل بعد الترجمة؛ على مستوى النوع: CleanField هو string | number — فقد زالت null/undefined بفعل NonNullable، ولن ينجح الفحص إلا بإسناد القيم التي نجت من مرشح v != null)

💡 نقاط مهمة

🏷️ الأنواع المساعدة ذات صلة

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

📚 دروس ذات صلة

❓ أسئلة شائعة

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

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

من نحن