تخطَّ إلى المحتوى

Partial<Type>

جعل كل الخصائص اختيارية Partial<Type>

Partial<Type> تبني نوعًا جديدًا بنفس خصائص Type لكن كلها اختيارية — مثالي لدوال التحديث الجزئي.

Partial تمرّ على كل خاصية في Type وتضيف لها علامة `?` الاختيارية. تُستخدم غالبًا في دوال التعديل التي تستقبل بعض الحقول فقط لا الكائن كاملًا.

لا تعدّل Type الأصلي — تنتج نوعًا جديدًا منفصلًا يمكن استخدامه في أي مكان.

الصياغة

Partial<Type>

📄 مثال

interface Product {
  id: number;
  name: string;
  price: number;
}

function updateProduct(id: number, changes: Partial<Product>) {
  // changes قد يحتوي name فقط، أو price فقط، أو كليهما
}

updateProduct(1, { price: 29.99 });   // صحيح، بقية الحقول غير مطلوبة

أهم النقاط

العنصرالوظيفة
Typeالواجهة أو نوع الكائن المراد جعل خصائصه اختيارية

💡 نصائح عملية

  • استخدمها في توقيع دوال PATCH/update التي تقبل تحديثًا جزئيًّا
  • عكسها Required — استخدمه إذا أردت فرض كل الحقول بدل تحريرها

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

  • إعادة كتابة نفس شكل Type يدويًّا بإضافة ? لكل حقل بدل استخدام Partial مباشرة

خصائص ذات صلة

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