Seriya: Axios Dars 48

isAxiosError() — Axios xatolarini type-safe aniqlash

axios.isAxiosError() Type Guard funksiyasi: unknown xatolarini AxiosError ga aylantirish (Type Narrowing), generiklar bilan xato ma'lumotlarini aniqlash va instanceof bilan farqi.

48-dars

isAxiosError() — Axios xatolarini type-safe aniqlash

TypeScript muhitida try / catch bloki ichida xatoni ushlaganingizda, catch (error) dagi error o'zgaruvchisi sukut bo'yicha unknown (yoki eski TypeScript versiyalarida any) turiga ega bo'ladi.

Bu shuni anglatadiki, siz to'g'ridan-to'g'ri error.response yoki error.code deb yozmoqchi bo'lsangiz, TypeScript darhol xatolik chiqaradi, chunki u error oddiy JavaScript xatosi (Error) yoki shunchaki matn (string) bo'lishi mumkinligidan ogohlantiradi.

Ushbu muammoni type-safe tarzda hal qilish uchun Axios maxsus Type Guard funksiyasi — axios.isAxiosError() ni taqdim etadi.


1. isAxiosError() qanday ishlaydi?

Bu funksiya oddiy boolean (true yoki false) qiymat qaytaradi, lekin TypeScript kompilyatori uchun u maxsus vazifani bajaradi: agar u true qaytarsa, TypeScript avtomatik ravishda error o'zgaruvchisining turini AxiosError ga toraytiradi (Type Narrowing).

import axios from 'axios';
import { ApiWrapper } from '../api/ApiWrapper';

export const handleApiRequest = async () => {
  try {
    await ApiWrapper.get('/profile');
  } catch (error) {
    // error tipi bu yerda 'unknown'

    if (axios.isAxiosError(error)) {
      // TypeScript TURLARNI TORAYTIRDI (Type Narrowing)!
      // Endi 'error' avtomatik ravishda AxiosError turiga aylandi:
      
      console.error('Status kodi:', error.response?.status);
      console.error('Server xabari:', error.response?.data);
      console.error('So\'rov URL:', error.config?.url);
    } else {
      // Agar bu Axios xatosi bo'lmasa (masalan, kodda syntax error yoki boshqa nosozlik)
      console.error('Noma\'lum JavaScript xatoligi:', error);
    }
  }
};

2. Generiklar bilan birga ishlatish (axios.isAxiosError<T>)

Agar serveringiz xato yuz berganda aniq bir JSON formatini qaytarishini bilsangiz, axios.isAxiosError funksiyasiga generik tip berish orqali xato ma'lumotlarini ham 100% tiplashtirishingiz mumkin:

import axios from 'axios';
import { ApiWrapper } from '../api/ApiWrapper';

// Backend qaytaradigan aniq xato interfeysi
interface CustomErrorData {
  errorCode: string;
  errorMessage: string;
}

export const updateUserSettings = async (settings: Record<string, unknown>) => {
  try {
    await ApiWrapper.put('/settings', settings);
  } catch (error) {
    // Generik <CustomErrorData> orqali data turini qat'iy belgilaymiz:
    if (axios.isAxiosError<CustomErrorData>(error)) {
      
      // error.response?.data tipi endi to'g'ridan-to'g'ri CustomErrorData bo'ladi!
      const errorData = error.response?.data;
      
      if (errorData) {
        console.error(`Xatolik kodi: ${errorData.errorCode}`);
        console.error(`Tafsilot: ${errorData.errorMessage}`);
      }
    } else {
      console.error('Kutilmagan xato:', error);
    }
  }
};

3. Nima uchun instanceof AxiosError o'rniga axios.isAxiosError() ishlatish kerak?

JavaScript dasturchilari ko'pincha xatolarni tekshirish uchun instanceof operatoridan foydalanishga o'rganib qolgan (error instanceof AxiosError). Biroq Axios bilan ishlaganda bu har doim ham to'g'ri ishlamasligi mumkin:

  1. Loyiha versiyalari to'qnashuvi (Multiple Axios Instances):
    • Agar ilovangizda yoki siz foydalanayotgan uchinchi tomon kutubxonasida Axios'ning boshqa versiyasi yuklangan bo'lsa, prototiplar zanjiri mos kelmay qoladi va instanceof xato tarzda false qaytaradi.
  2. Plain Objects va SSR (Server-Side Rendering):
    • Server yoki iframe orqali serializatsiya qilingan xatolarda prototip yo'qolishi mumkin.
    • axios.isAxiosError() esa ichki isAxiosError: true flag'ini tekshiradi va har qanday sharoitda 100% ishonchli natija beradi.

4. axios.isAxiosError vs instanceof AxiosError taqqoslovi

Mezon axios.isAxiosError() error instanceof AxiosError
Tekshirish usuli Ichki isAxiosError: true flag'ini tekshiradi Prototip zanjirini (prototype) tekshiradi
Ko'p versiyali muhit 100% ishonchli ishlaydi Turli versiyalarda false berishi mumkin
Generik qo'llab-quvvatlashi isAxiosError<CustomError>(error) orqali data'ni tiplashtiradi Qo'shimcha type assertion (as) talab etiladi
Tavsiya Rasmiy va qat'iy tavsiya etiladi Tavsiya etilmaydi

Xulosa

axios.isAxiosError(error) — bu TypeScript loyihalarida API xatolarini xavfsiz va to'g'ri aniqlashning rasmiy Type Guard vositasidir. U catch blokidagi noma'lum unknown xatoni xavfsiz tarzda AxiosError turiga aylantirib, error.response, error.status va error.config kabi barcha muhim maydonlarga xavfsiz murojaat qilish imkonini beradi.