Series: TypeScript Basics Lesson 95

@ts-expect-error

TypeScript'da @ts-expect-error: xatoni bostirish, @ts-ignore'dan farqi, o'zini o'zi tozalashi, testlar va tip testlaridagi qo'llanilishi hamda qoidalari.

95-dars

@ts-expect-error

// @ts-expect-error ham keyingi qatordagi xatoni bostiradi, xuddi @ts-ignore (94-dars) kabi. Lekin bitta katta farqi bor: agar o'sha qatorda xato bo'lmasa, TS'ning o'zi xato beradi. Ya'ni bu izoh "bu yerda xato kutyapman" degan da'vo, va TS shu da'voni tekshiradi.

Farqi

// @ts-ignore
const a: number = 5; // xato yo'q, ignore jim turadi

// @ts-expect-error
const b: number = 5;
// ❌ Unused '@ts-expect-error' directive.

@ts-ignore keraksiz bo'lib qolsa ham jim yotaveradi. @ts-expect-error esa keraksiz bo'lishi bilan o'zini fosh qiladi.

Nega bu muhim: o'zini o'zi tozalaydi

Kutubxonada type xatosi bor, vaqtincha bostirdingiz:

// @ts-expect-error: chart-lib v3.2 da `animation` tipi yo'q, v3.3 da tuzatiladi
chart.setOptions({ animation: false });

Keyinroq kutubxonani yangilaysiz, ular type'ni tuzatgan. Endi:

  • @ts-ignore bo'lganda: izoh abadiy qoladi, kelajakdagi yangi xatolarni ham yashiradi.
  • @ts-expect-error bo'lganda: build xato beradi, siz izohni o'chirasiz. Kod toza.

Asosiy ishlatilish joyi: testlar

Funksiya noto'g'ri type berilganda xato tashlashini tekshirmoqchisiz. Buning uchun ataylab noto'g'ri qiymat berish kerak:

function toEmail(value: string): Email {
  if (typeof value !== "string") throw new TypeError("string kerak");
  // ...
}

test("string bo'lmasa xato tashlaydi", () => {
  // @ts-expect-error: ataylab noto'g'ri tip, runtime himoyani tekshiryapmiz
  expect(() => toEmail(123)).toThrow(TypeError);
});

Bonus: agar kimdir toEmail'ni string | number qabul qiladigan qilib o'zgartirsa, test faylida xato chiqadi va siz bu o'zgarish ataylab qilinganmi, yo'qmi, o'ylab ko'rasiz.

Tip testlari

Type'laringiz noto'g'ri ishlatishni taqiqlashini tekshirish uchun ham:

type UserId = Brand<number, "UserId">;
type OrderId = Brand<number, "OrderId">;
declare function deleteOrder(id: OrderId): void;
declare const userId: UserId;

// @ts-expect-error: UserId OrderId o'rniga o'tmasligi kerak
deleteOrder(userId);

Agar kimdir brand'ni (93-dars) buzib qo'ysa, bu qator "keraksiz izoh" xatosini beradi va buzilish darhol bilinadi.

Qoidalar

  • Doim sabab yozing: // @ts-expect-error: nima uchun. Ko'p jamoalar ESLint orqali buni majburiy qiladi (allow-with-description, 94-dars).
  • Hali ham qatordagi hamma xatoni bostiradi, shuning uchun qatorni qisqa tuting.
  • Bu @ts-ignore'ning xavfsizroq versiyasi, lekin baribir oxirgi chora. Avval haqiqiy yechim izlang.

Eslab qolish uchun

@ts-ignore @ts-expect-error
Xatoni bostiradi Ha Ha
Xato yo'q bo'lsa Jim Xato beradi
Eskirib qolsa Bilinmaydi Darhol bilinadi
Qachon Deyarli hech qachon Testlar, vaqtincha kutubxona xatolari