Series: TypeScript Basics Lesson 66

Required

TypeScript'dagi Required utility type'i: barcha ixtiyoriy maydonlarni majburiy qilish, oddiy misol va default sozlamalarni birlashtirishdagi real qo'llanilishi.

66-dars

Required

TypeScript'dagi Required — bu Partial type'ining teskarisi.

Inglizcha "required" so'zi "majburiy", "kerakli" degan ma'nolarni anglatadi. Required yordamchi type'i mavjud interface'dagi barcha ixtiyoriy (optional — ?) maydonlarni majburiy holatga keltirib, yangi type hosil qiladi.

Oddiy qilib aytganda: Required<SourceType>.

1. Oddiy misol

Tasavvur qiling, sizda barcha yoki ayrim maydonlari ixtiyoriy (?) bo'lgan interface bor (masalan, foydalanuvchi profilini to'ldirish yoki sozlamalar):

interface UserConfig {
  username?: string;
  email?: string;
  age?: number;
}

Agar sizga qaysidir joyda ana shu barcha maydonlar mutlaqo majburiy bo'lishi kerak bo'lsa (ya'ni hech biri bo'sh qolib ketmasligi shart bo'lsa), Required'ni ishlatasiz:

// Barcha maydonlar majburiy (`?` belgisi olib tashlanadi)
type FullyRequiredUser = Required<UserConfig>;

// Hosil bo'lgan yangi type taxminan shunday ko'rinishda bo'ladi:
// type FullyRequiredUser = {
//   username: string;
//   email: string;
//   age: number;
// }

const user: FullyRequiredUser = {
  username: "Ali",
  email: "[email protected]",
  age: 25,
  // Agar biror maydonni yozishni unutib qoldirsangiz, TS darhol xato beradi!
};

Ichkarida Required ham mapped type (61-dars), faqat ? o'rniga -? modifikatori bilan: { [K in keyof T]-?: T[K] }. -? — "? belgisini olib tashla" degani.

2. IT loyihalaridagi real misol (default sozlamalarni birlashtirish)

Dasturlashda ko'pincha foydalanuvchi sozlamalari ixtiyoriy bo'ladi (foydalanuvchi hamma narsani ham kiritishi shart emas). Lekin dastur ichida ishlatish uchun barcha qiymatlar to'liq tayyor bo'lishi kerak (default qiymatlar bilan to'ldirilgandan keyin).

interface AppSettings {
  theme?: "dark" | "light";
  language?: string;
  autoSave?: boolean;
}

// Foydalanuvchi qisman sozlama yuboradi (hamma maydon ixtiyoriy)
function saveSettings(userSettings: AppSettings) {
  // Default qiymatlar bilan birlashtirilgach, hamma maydonlar majburiy bo'lib qoladi:
  const completeSettings: Required<AppSettings> = {
    theme: userSettings.theme ?? "light",    // Agar kiritmagan bo'lsa, default olinadi
    language: userSettings.language ?? "uz", // Default til
    autoSave: userSettings.autoSave ?? true, // Default qiymat
  };

  // Endi completeSettings'dagi hamma maydonlar 100% mavjudligiga kafolat bor!
}