Seriya: Axios Dars 22

validateStatus — HTTP status code asosida Promise resolve/reject boshqaruvi

Axios'da validateStatus parametrining vazifasi: sukutdagi 2xx qoidasi, 404 yoki 422 statuslarini resolve qilish, instansiya darajasida sozlash va xatolarni to'g'ri boshqarish.

22-dars

validateStatus — HTTP status code asosida Promise resolve/reject boshqaruvi

Standart holat qanday ishlaydi?

Axios o'zining sukutdagi (default) sozlamasida quyidagi qoidaga amal qiladi:

  • 2xx (200–299): Oraliqdagi barcha HTTP status kodlari muvaffaqiyatli deb hisoblanadi va Promise resolve bo'ladi (ma'lumot .then() yoki await orqali to'g'ridan-to'g'ri olinadi).
  • 3xx, 4xx, 5xx (masalan, 400, 401, 404, 500): Kabi status kodlari xato deb topiladi va Promise reject bo'lib, darhol catch blokiga tushib ketadi.

Lekin ba'zida biznes-mantiqqa ko'ra sizga serverdan kelgan 404 (Topilmadi) yoki 422 (Validatsiya xatosi) kodlarini xato sifatida emas, balki oddiy javob sifatida qabul qilib, ma'lumotni o'qib olish kerak bo'ladi. Mana shunday paytda validateStatus funksiyasi yordamga keladi.

1. validateStatus qanday yoziladi?

validateStatus bu shunchaki status kodini qabul qilib, mantiqiy (true yoki false) qiymat qaytaruvchi funksiyadir:

  • Agar funksiya true qaytarsa → Axios buni muvaffaqiyatli so'rov deb bilib, resolve qiladi (ma'lumot response.data ga tushadi).
  • Agar funksiya false qaytarsa → Axios buni xato deb bilib, reject qiladi va catch ga otib yuboradi.

2. Real misol: 404 xatosini ham resolve qilish

Tasavvur qiling, biz foydalanuvchini ID bo'yicha qidiryapmiz. Agar foydalanuvchi topilmasa, server 404 Not Found qaytaradi. Standart holatda bu catch ga tushib, xato chiqaradi. Lekin biz uni xato sifatida emas, "foydalanuvchi topilmadi" deb oddiy holatda boshqarishni istaymiz:

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

interface User {
  id: number;
  name: string;
}

export const findUserById = async (userId: number) => {
  try {
    const response = await apiClient.get<User>(`/users/${userId}`, {
      // validateStatus orqali qaysi statuslar muvaffaqiyatli ekanini o'zimiz belgilaymiz
      validateStatus: (status) => {
        // 2xx oralig'idagi kodlar VA 404 kodini ham muvaffaqiyatli deb qabul qilamiz
        return (status >= 200 && status < 300) || status === 404;
      },
    });

    // Agar server 404 qaytarsa ham bu yerga kelib ishlaydi
    if (response.status === 404) {
      console.warn('Foydalanuvchi topilmadi (404)');
      return null;
    }

    return response.data;
  } catch (error: any) {
    // Endi faqat haqiqiy tarmoq xatolari yoki 500 server xatolari shu yerga tushadi
    console.error('Kutilmagan xatolik yuz berdi:', error.message);
    throw error;
  }
};

3. Instansiya darajasida validateStatus ni sozlash

Agar siz butun ilovangiz bo'ylab ma'lum bir status kodlarini (masalan, server ma'lum sabablarga ko'ra xato xabarlarini 400 statusi bilan birga maxsus JSON body'da jo'natishini bilsangiz va ularni catch ga tashlamasdan o'qimoqchi bo'lsangiz) global instansiyada sozlashingiz mumkin:

import axios, { AxiosInstance } from 'axios';

export const customApiClient: AxiosInstance = axios.create({
  baseURL: 'https://api.example.com/v1',
  // Global miqyosda barcha 500 dan kichik statuslarni resolve qilishga ruxsat beramiz
  // (Lekin buni ehtiyotkorlik bilan ishlatish kerak!)
  validateStatus: (status) => {
    return status < 500; // Faqat 500 va undan yuqori server xatolari catch'ga tushadi
  },
});

Xulosa

  • Default: Axios faqat 2xx kodlarini muvaffaqiyatli deb biladi.
  • validateStatus: Serverdan kelgan istalgan HTTP status kodini (masalan, 404, 302, 422) xato yoki muvaffaqiyatli deb belgilashni o'zingizga topshiradi.