@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-ignorebo'lganda: izoh abadiy qoladi, kelajakdagi yangi xatolarni ham yashiradi.@ts-expect-errorbo'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 |