Seriya: Axios Dars 57

error.message va error.code — Xatolarni aniqlash

AxiosError obyektidagi error.message va error.code xossalari: matnli tavsif, dasturiy identifikatorlar (ECONNABORTED, ERR_NETWORK, ERR_BAD_REQUEST), ularning farqi va qo'llanishi.

57-dars

error.message va error.code — Xatolarni aniqlash

catch (error) blokida ushlangan AxiosError obyektining dasturchilar tomonidan eng ko'p murojaat qilinadigan ikkita xossasi bu uning xabari (error.message) va xatolik kodi (error.code) hisoblanadi. Ularning har biri xatolikni tahlil qilishda alohida o'ringa ega.


1. error.message — Inson o'qiy oladigan xabar

error.message — bu standart JavaScript Error sinfidan meros bo'lib o'tgan xossa bo'lib, yuzaga kelgan muammoning qisqacha matnli tavsifini ifodalaydi.

Odatda uchraydigan standart qiymatlar:

  • Server xato qaytarganda: "Request failed with status code 404" yoki "Request failed with status code 500"
  • Tarmoq uzilib qolganda: "Network Error"
  • Vaqt tugaganda: "timeout of 5000ms exceeded"

[!WARNING] error.message asosan konsolga log qilish (debugging) va xatoliklarni kuzatish (monitoring) uchun qulay. Biroq uni to'g'ridan-to'g'ri oxirgi foydalanuvchiga (UI da) ko'rsatish tavsiya etilmaydi. Chunki u ingliz tilida, juda texnik va oddiy foydalanuvchi uchun tushunarsiz bo'ladi.


2. error.code — Dasturiy xatolik kodi (String Identifier)

error.code — bu Axios tomonidan biriktiriladigan maxsus satrli (string) identifikator bo'lib, xatolik turini dasturiy yo'l bilan aniqlash va shartlar yozish uchun ishlatiladi. error.message matni tilga yoki versiyaga qarab o'zgarishi mumkin, biroq error.code doimo barqaror va o'zgarmas qoladi.

Eng ko'p uchraydigan Axios xatolik kodlari:

  • ECONNABORTED — So'rov uchun belgilangan vaqt (timeout) tugadi.
  • ERR_NETWORK — Internet aloqasi yo'q, server o'chiq yoki CORS sababli so'rov bloklandi.
  • ERR_BAD_REQUEST — Server 4xx turidagi status kodi qaytardi (masalan, 400, 404).
  • ERR_BAD_RESPONSE — Server 5xx turidagi ichki xatolik status kodi qaytardi.
  • ERR_CANCELED — So'rov AbortController orqali dasturchi yoki foydalanuvchi tomonidan bekor qilindi.
  • ERR_INVALID_URL — Berilgan URL manzili noto'g'ri formatda shakllantirilgan.

3. Amaliy misol: error.code va error.message ni birgalikda ishlatish

TypeScript yordamida ushbu ikkala xossadan to'g'ri va xavfsiz foydalanish amaliyoti:

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

export const fetchDashboardData = async () => {
  try {
    const response = await apiClient.get('/dashboard');
    return response.data;
  } catch (error) {
    if (axios.isAxiosError(error)) {
      
      // 1. Dasturiy kod (error.code) orqali aniq shartlarni tekshiramiz
      switch (error.code) {
        case 'ECONNABORTED':
          console.warn('[Timeout]: Server javob berishi juda uzoq cho\'zildi.');
          alert('Serverdan javob kelish vaqti tugadi. Qaytadan urinib ko\'ring.');
          break;

        case 'ERR_NETWORK':
          console.error('[Network Error]: Internet yo\'q yoki server o\'chiq.');
          alert('Internet aloqasi uzildi! Tarmoqni tekshiring.');
          break;

        case 'ERR_CANCELED':
          console.log('[Cancelled]: So\'rov foydalanuvchi tomonidan bekor qilindi.');
          break;

        case 'ERR_BAD_REQUEST':
          console.warn('[Bad Request]: 4xx xatoligi yuz berdi.');
          if (error.response) {
            console.warn(`Status: ${error.response.status}`, error.response.data);
          }
          break;

        default:
          // 2. Agar maxsus code bo'lmasa, error.message ni log qilamiz
          console.error('[Kutilmagan xato xabari]:', error.message);
          
          if (error.response) {
            console.error('Server status kodi:', error.response.status);
          }
      }
    } else {
      // Oddiy JavaScript xatolari uchun
      console.error('Umumiy JavaScript xatosi:', (error as Error).message);
    }
  }
};

4. error.message va error.code taqqoslash jadvali

Xususiyat error.message error.code
Maqsadi Inson o'qishi uchun qisqa matnli tavsif Dasturiy shartlar yozish uchun barqaror identifikator
Qiymat turi string (erkin matn) string (standart enum o'xshash kodlar)
Misol "timeout of 5000ms exceeded" "ECONNABORTED"
Qayerda ishlatiladi? console.error, Sentry / Datadog loglari switch (error.code), if/else shartlari
Foydalanuvchiga ko'rsatish Tavsiya etilmaydi (juda texnik) Foydalanuvchi tiliga tarjima qilish uchun asos bo'ladi

Xulosa

  • error.message — bu xatolikning nima sababdan kelib chiqqanini tushuntiruvchi matndir. Uni asosan log qilish va dasturchilar tahlili uchun saqlash lozim.
  • error.code — xatolikning dasturiy belgisidir (ECONNABORTED, ERR_NETWORK). Kodda switch/case orqali turli stsenariylarni avtomatlashtirishda eng ishonchli vosita aynan error.code hisoblanadi.