Series: Axios Lesson 47

AxiosError — Error response'larini tipizatsiya qilish

AxiosError<T> interfeysi: backend xato modellarini tiplashtirish, response.data tahlili, interceptorlarda xatolarni qayta ishlash va axios.isAxiosError() type guard.

47-dars

AxiosError — Error response'larini tipizatsiya qilish

Server muvaffaqiyatli javob qaytarganda biz uni AxiosResponse<T> orqali tiplashtirgan edik. Lekin serverdan xatolik (400 Bad Request, 401 Unauthorized, 422 Unprocessable Entity) kelganda-chi?

Odatda backend xatolik yuz berganda ham o'zining maxsus JSON formatini qaytaradi (masalan: { message: "Email allaqachon band", errorCode: "EMAIL_EXISTS" }). AxiosError<T> interfeysi aynan mana shu xato ma'lumotlarini qat'iy tiplashtirish uchun xizmat qiladi.


1. AxiosError<T> ning tuzilishi

Axios kutubxonasida AxiosError interfeysi quyidagi asosiy ko'rinishga ega:

export interface AxiosError<T = unknown, D = any> extends Error {
  config: InternalAxiosRequestConfig<D>;
  code?: string;
  request?: any;
  response?: AxiosResponse<T, D>; // <T> aynan xato kelgandagi data turini bildiradi!
  isAxiosError: boolean;
  status?: number;
}

E'tibor bering, response?.data maydoni <T> generigi orqali tiplashtiriladi. Agar siz tip bermasangiz, u sukut bo'yicha unknown bo'ladi va har safar uning xossalariga murojaat qilganda TypeScript xatolik beradi.


2. Amaliy misol: Komponentda xatolarni tiplashtirib ushlash

Tasavvur qiling, foydalanuvchi ro'yxatdan o'tish formasini to'ldirmoqda va backend ma'lumotlar noto'g'ri bo'lsa maxsus xato obyekti qaytaradi. Buni TypeScript'da qanday qilib xavfsiz boshqaramiz?

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

// 1. Backend qaytaradigan xato obyektining tipi (DTO)
interface BackendErrorResponse {
  message: string;
  errorCode: string;
  fieldErrors?: {
    email?: string;
    password?: string;
  };
}

// 2. So'rov yuborish funksiyasi
export const registerUser = async (formData: { email: string; pass: string }) => {
  try {
    const response = await ApiWrapper.post('/auth/register', formData);
    return response;
  } catch (error) {
    // 3. Kelgan error'ni AxiosError<BackendErrorResponse> sifatida kast qilamiz
    const err = error as AxiosError<BackendErrorResponse>;

    if (err.response) {
      // TypeScript endi err.response.data ichida nima borligini aniq biladi!
      const errorData = err.response.data;
      
      console.error(`Xatolik kodi: ${errorData.errorCode}`);
      console.error(`Xabar: ${errorData.message}`);
      
      if (errorData.fieldErrors?.email) {
        console.warn(`Email maydonidagi xato: ${errorData.fieldErrors.email}`);
      }
    } else {
      console.error('Tarmoq yoki server bilan aloqa yo\'q:', err.message);
    }
  }
};

3. Response Interceptor ichida AxiosError<T> dan foydalanish

Global xatoliklarni boshqaruvchi response interceptor'da ham tiplashtirilgan AxiosError dan foydalanish kodni juda toza va xavfsiz qiladi:

import { apiClient } from './client';
import { AxiosError } from 'axios';

interface GlobalErrorDto {
  message: string;
  status: number;
}

apiClient.interceptors.response.use(
  (response) => response,
  (error: AxiosError<GlobalErrorDto>) => {
    // error.response?.data tipi endi aniq GlobalErrorDto hisoblanadi
    if (error.response) {
      const { message, status } = error.response.data;
      
      if (status === 401) {
        console.warn(`Autentifikatsiya xatosi: ${message}`);
      }
    }

    return Promise.reject(error);
  }
);

4. axios.isAxiosError() yordamchi funksiyasi (Type Guard)

JavaScript'da catch (error) bloki har qanday xatoni (unknown) ushlaydi. Kelayotgan xato oddiy JavaScript xatosimi (new Error()) yoki Axios orqali kelgan HTTP xatosimi ekanligini xavfsiz tekshirish uchun Axios o'zining axios.isAxiosError() type guard funksiyasini taqdim etadi:

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

interface ApiError {
  message: string;
}

export const loadData = async () => {
  try {
    return await ApiWrapper.get('/data');
  } catch (error) {
    // Type Guard orqali aniq tekshiramiz:
    if (axios.isAxiosError<ApiError>(error)) {
      // Bu blok ichida TypeScript error'ni to'liq AxiosError<ApiError> deb biladi
      console.error('HTTP Status:', error.response?.status);
      console.error('Server xabari:', error.response?.data.message);
    } else {
      // Tarmoqdan tashqari boshqa kutilmagan JavaScript xatosi
      console.error('Noma\'lum xatolik:', error);
    }
  }
};

5. Xatolarni tekshirish usullari taqqoslovi

Usul Qayerda ishlatiladi? Xavfsizlik darajasi Tavsif
error as AxiosError<T> Komponent va servis catch bloklarida O'rtacha Type Assertion — dasturchi xatoning Axios ekanligiga 100% ishongan holatlar uchun
axios.isAxiosError<T>(error) Universal catch bloklarida Yuqori (Tavsiya etiladi) Haqiqiy runtime tekshiruv va avtomatik TypeScript type narrowing
error: AxiosError<T> Interceptor onRejected funksiyasida Yuqori Interceptor xato parametrini to'g'ridan-to'g'ri tiplashtirish

Xulosa

AxiosError<T> va axios.isAxiosError() kombinatsiyasi server xatolarini xavfsiz va aniq boshqarishning standart vositasidir. Generik orqali server qaytargan xato modellarini belgilash xatolik xabarlarini foydalanuvchiga to'g'ri ko'rsatish va undefined xatolarining oldini olishga xizmat qiladi.