Seriya: TypeScript Basics Dars 3

Explicit Type Annotation

TypeScript'da explicit (aniq) tip annotatsiyasi qachon kerakligi va inference bilan qanday farqlanishi haqida.

3-dars

Explicit Type Annotation

Type inference ko'p holatda yetarli, lekin u hamma joyda ishlay olmaydi yoki noto'g'ri xulosa chiqarishi mumkin. Explicit (aniq) annotatsiya kerak bo'ladigan asosiy holatlar:

  1. Funksiya parametrlari — inference ularda ishlamaydi.
  2. O'zgaruvchi boshlang'ich qiymatsiz e'lon qilinganda — aks holda any bo'lib qoladi.
  3. Inference "juda keng" yoki noaniq tip chiqarganda — dasturchi niyatini aniqroq bildirish kerak bo'lganda.
  4. Kod o'qilishini yaxshilash uchun — funksiya imzosi (signature) o'qigan odamga darhol nima kutilayotganini ko'rsatadi.

Bular bo'lmasa, boshqa dasturchi (yoki 6 oydan keyingi siz) funksiya nima qabul qilishini bilish uchun uning ichki kodini o'qishga majbur bo'ladi.

Qanday ishlaydi?

Sintaksis oddiy: o'zgaruvchi yoki parametr nomidan keyin qo'shtirnoqsiz ikki nuqta (:) va tip yoziladi:

let age: number = 25;
let username: string = "ali_dev";
let isAdmin: boolean = false;

function multiply(a: number, b: number): number {
  return a * b;
}

Bu yerda a: number va b: number — parametr annotatsiyalari, funksiya nomidan keyingi : number esa qaytariladigan qiymat (return type) annotatsiyasi.

Boshlang'ich qiymatsiz o'zgaruvchida annotatsiya shart:

let score;        // tipi: any — xavfli
score = 10;
score = "o'n";     // xato bermaydi

let score2: number; // aniq annotatsiya
score2 = 10;
score2 = "o'n";      // ❌ Xato: Type 'string' is not assignable to type 'number'

Annotatsiya inference bilan ziddiyatga kirsa, TypeScript darhol xato beradi — bu aslida foydali, chunki dasturchining xatosini ushlab qoladi:

let price: number = "o'nta"; // ❌ Xato: Type 'string' is not assignable to type 'number'

Eng ko'p uchraydigan xato

Eng keng tarqalgan xato — ortiqcha annotatsiya (redundant annotation): inference allaqachon to'g'ri xulosa chiqargan joyga ham majburan tip yozish:

// Ortiqcha — hech qanday qo'shimcha foyda bermaydi, faqat kodni cho'zadi
const name: string = "Vali";
const items: string[] = ["olma", "nok"];

function double(x: number): number {
  return x * 2; // return type allaqachon "number" deb xulosa qilinadi
}

Bunday holatlarda annotatsiya yozish xato emas, lekin TypeScript hamjamiyatida bu "yaxshi uslub emas" (not idiomatic) hisoblanadi — chunki bu real qiymat qo'shmaydi va kodni faqat cho'zadi.

Ikkinchi xato — teskari holat: parametrlarga annotatsiya yozmay, noImplicitAny yoqilgan loyihada compile xatosiga duch kelish. Qoida sifatida shuni eslab qoling:

  • Qiymat darhol beriladigan joyda (o'zgaruvchi initsializatsiyasi, return) — inference'ga ishoning.
  • Qiymat keyinroq keladigan yoki tashqaridan kiritiladigan joyda (parametrlar, bo'sh e'lon qilingan o'zgaruvchilar) — explicit annotatsiya yozing.