Partial
TypeScript'dagi Partial utility type'i: barcha maydonlarni ixtiyoriy qilish, oddiy misol va PATCH so'rovlaridagi real qo'llanilishi.
65-dars
Partial
TypeScript'dagi Partial ham juda ko'p ishlatiladigan, juda qulay yordamchi type (utility type).
Inglizcha "partial" so'zi "qisman", "to'liq bo'lmagan" degan ma'nolarni anglatadi. Partial yordamida mavjud interface'dagi barcha maydonlarni majburiy emas, balki ixtiyoriyga (optional — ?) aylantirib, yangi type hosil qilasiz.
Oddiy qilib aytganda: Partial<SourceType>.
1. Oddiy misol
Tasavvur qiling, sizda yana o'sha User interface'i bor va undagi hamma maydonlar majburiy (ya'ni, obyekt yaratishda ularning hammasini kiritish shart):
interface User {
id: number;
name: string;
email: string;
age: number;
}
Agar sizga foydalanuvchining faqat bitta yoki ikkita maydonini (masalan, faqat ismini yoki faqat yoshini) o'zgartirish uchun jo'natish kerak bo'lsa, Partial barcha maydonlarni avtomatik ravishda ixtiyoriy (?) qilib chiqadi:
// Barcha maydonlar ? (optional) belgisi bilan ta'minlanadi
type PartialUser = Partial<User>;
// Hosil bo'lgan yangi type taxminan shunday ko'rinishda bo'ladi:
// type PartialUser = {
// id?: number;
// name?: string;
// email?: string;
// age?: number;
// }
// Endi faqat bitta maydonni yozsangiz ham TS xato bermaydi:
const updatedData: PartialUser = {
name: "Alisher", // Qolgan maydonlarni yozish majburiy emas!
};
Ichkarida Partial — ? modifikatorli mapped type (61-dars): { [K in keyof T]?: T[K] }.
2. IT loyihalaridagi real misol (ma'lumotni qisman yangilash — Patch / Update)
Backend'ga ma'lumot yuborishda (masalan, PATCH so'rovlarida) ko'pincha butun boshli obyektni emas, balki o'zgargan qisminigina yuborishadi.
interface Settings {
theme: "dark" | "light";
notifications: boolean;
language: string;
}
// Foydalanuvchi faqat tilni o'zgartirmoqchi bo'lsa:
function updateSettings(newSettings: Partial<Settings>) {
// Sozlamalarni yangilash logikasi...
}
// Uni shunday chaqirish mumkin:
updateSettings({ language: "uz" });
// Yoki faqat mavzuni:
updateSettings({ theme: "dark" });
Agar Partial bo'lmaganida, har safar faqat bitta maydonni yuborish uchun ham barcha maydonlarni kiritishga majbur bo'lar edingiz.
💡 Partial boshqa utility type'lar bilan birga ham ishlatiladi. Masalan, 64-darsdagi Update misolida id va createdAt'ni olib tashlab, qolganlarini ixtiyoriy qilish uchun: Partial<Omit<Product, "id" | "createdAt">>.