Series: Axios Lesson 41

Interceptor Error Handling — Interceptor ichidagi xatolarni boshqarish

Axios interceptorlarida xatoliklarni boshqarish: Request va Response xatolari, AxiosError tahlili, 401/403/500 xatolarini markazlashtirilgan holda qayta ishlash va Promise.reject qoidasi.

41-dars

Interceptor Error Handling — Interceptor ichidagi xatolarni boshqarish

Interceptor'lar nafaqat so'rov va javobni o'zgartirish, balki ular davomida yuzaga keladigan xatoliklarni ushlab qolish va to'g'ri boshqarish uchun ham xizmat qiladi. Axios'da xatolarni boshqarish jarayoni ikkita alohida bosqichga bo'linadi: Request xatolari va Response xatolari.


1. Request Interceptor ichidagi xatoliklar

Request interceptor'ning ikkinchi parametri (onRejected) so'rov serverga chiqib ketishidan oldin sodir bo'ladigan xatolarni ushlaydi.

Qachon yuz beradi? Odatda bu yerda xatolik juda kam uchraydi, chunki bu lokal brauzer kodi hisoblanadi (masalan, tokenni o'qishda yoki config obyektini tayyorlashda kutilmagan JavaScript xatosi chiqsa).

import { apiClient } from './client';

apiClient.interceptors.request.use(
  (config) => {
    // So'rovni tayyorlash jarayoni
    return config;
  },
  (error) => {
    // Request bosqichidagi xatolikni ushlab qolamiz
    console.error('[Request Error] So\'rovni shakllantirishda xatolik:', error);
    
    // Albatta Promise.reject qaytarish kerak, aks holda zanjir uzilib qoladi
    return Promise.reject(error);
  }
);

2. Response Interceptor ichidagi xatoliklar (Asosiy e'tibor)

Serverdan xato javob kelsa (400, 401, 403, 404, 500 va hokazo) yoki internet aloqasi uzilib qolsa (Network Error), response interceptor'ning ikkinchi parametri ishga tushadi.

Professional arxitekturada response error handler quyidagi uchta asosiy vazifani bajarishi lozim:

  1. Xato turini aniqlash: Server javob qaytarganmi yoki tarmoq uzilganmi?
  2. Global xatoliklarni hal qilish: Masalan, 401 kelsa tokenni tozalash va login sahifasiga yo'naltirish.
  3. Xatoni komponentga uzatish: Komponent o'zida ham qandaydir xabar (masalan, "Foydalanuvchi topilmadi" deb modal oynada ko'rsatish) chiqarishi uchun xatoni to'g'ri formatda Promise.reject(error) orqali uzatish.
import { apiClient } from './client';
import axios, { AxiosError } from 'axios';

apiClient.interceptors.response.use(
  (response) => response,
  (error: AxiosError) => {
    // 1. Server javob qaytargan holat (Masalan: 400, 401, 500)
    if (error.response) {
      const status = error.response.status;
      const data = error.response.data;

      if (status === 401) {
        console.warn('Avtorizatsiya muddati tugadi.');
        localStorage.removeItem('accessToken');
        // window.location.href = '/login';
      } else if (status === 403) {
        console.error('Bu amalga ruxsat yo\'q.');
      } else if (status >= 500) {
        console.error('Server xatoligi. Keyinroq urinib ko\'ring.');
      }

      // Serverdan kelgan aniq xabar yoki butun error obyektini uzatamiz
      return Promise.reject(error);
    } 
    
    // 2. Tarmoq uzilgan yoki server umuman javob bermagan holat (Timeout / Network Error)
    else if (error.code === 'ECONNABORTED') {
      console.error('So\'rov vaqti tugadi (Timeout). Internetni tekshiring.');
    } else if (!navigator.onLine) {
      console.error('Internet aloqasi mavjud emas.');
    }

    // 3. Xatoni keyingi catch blokiga uzatamiz
    return Promise.reject(error);
  }
);

3. Eng muhim qoida: Promise.reject(error) ni unutmang!

Interceptor ichida xatoni ushlaganingizdan so'ng, uni har doim Promise.reject(...) yordamida qaytadan otib yuborishingiz (re-throw) shart.

[!WARNING] Agar shunchaki console.error qilib qo'yib, hech narsa qaytarmasangiz (yoki return qilib yuborsangiz), Axios bu xato to'liq hal qilindi deb hisoblaydi va komponentdagi catch blokiga emas, to'g'ridan-to'g'ri .then() muvaffaqiyat blokiga o'tkazib yuboradi! Bu esa ilovada kutilmagan mantiqiy xatoliklarga (bug) sabab bo'ladi.

// ❌ XATO USUL:
apiClient.interceptors.response.use(
  (response) => response,
  (error) => {
    console.error(error);
    // return yo'q yoki return error; -> Komponent buni SUCCESS deb qabul qiladi!
  }
);

// ✅ TO'G'RI USUL:
apiClient.interceptors.response.use(
  (response) => response,
  (error) => {
    console.error(error);
    return Promise.reject(error); // Komponentning catch blokiga o'tadi
  }
);

4. Xatolik turlari va ularni qayta ishlash jadvali

Holat / Status Sababi Interceptor'dagi to'g'ri harakat
error.response mavjud (401) Token muddati o'tgan yoki yaroqsiz Tokenni xotiradan tozalash, /login sahifasiga yo'naltirish
error.response mavjud (403) Foydalanuvchida ruxsat huquqi yo'q Ruxsat cheklanganligi haqida xabarnoma ko'rsatish
error.response mavjud (500+) Backend server ichki xatosi Umumiy texnik xatolik xabarini berish
ECONNABORTED Timeout vaqti tugagan "So'rov vaqti tugadi, qaytadan urinib ko'ring" xabarini berish
!error.response && !navigator.onLine Internet aloqasi uzilgan Oflayn rejim xabarini ko'rsatish

Xulosa

Response interceptor ichida xatolarni markazlashtirilgan tarzda boshqarish butun ilovada kodning takrorlanishini keskin kamaytiradi. Barcha xatoliklar bir joyda filtrlanadi, sessiya tugashi avtomatik nazorat qilinadi va eng muhimi, Promise.reject(error) yordamida UI komponentlariga aniq xato xabari yetib borishi kafolatlanadi.