Exclude<UnionType, ExcludedMembers>

استبعاد أعضاء من اتحاد أنواع Exclude<UnionType, ExcludedMembers>

Exclude تبني نوع اتحاد جديد بإزالة كل عضو من UnionType يمكن إسناده إلى ExcludedMembers.

على عكس Omit التي تعمل على خصائص كائن، Exclude تعمل على أعضاء اتحاد أنواع (union) مباشرة. تفحص كل عضو في UnionType، وإذا كان متوافقًا مع ExcludedMembers تحذفه من الناتج.

الصياغة

Exclude<UnionType, ExcludedMembers>

📄 مثال

type Status = "pending" | "shipped" | "delivered" | "cancelled";

type ActiveStatus = Exclude<Status, "cancelled">;
// "pending" | "shipped" | "delivered"

أهم النقاط

العنصر	الوظيفة
UnionType	اتحاد الأنواع المصدر
ExcludedMembers	الأنواع المراد استبعادها من الاتحاد

💡 نصائح عملية

استخدمها مع اتحادات الأنواع الحرفية (string literal unions) لتضييق مجموعة القيم المسموحة في سياق معيّن

⚠️ أخطاء شائعة

محاولة استخدامها على خصائص كائن بدل اتحاد أنواع — هذا عمل Omit لا Exclude

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار TYPESCRIPT الكامل بالعربي.