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
resolvebo'ladi (ma'lumot.then()yokiawaitorqali to'g'ridan-to'g'ri olinadi). - 3xx, 4xx, 5xx (masalan, 400, 401, 404, 500): Kabi status kodlari xato deb topiladi va Promise
rejectbo'lib, darholcatchblokiga 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
trueqaytarsa → Axios buni muvaffaqiyatli so'rov deb bilib,resolveqiladi (ma'lumotresponse.dataga tushadi). - Agar funksiya
falseqaytarsa → Axios buni xato deb bilib,rejectqiladi vacatchga 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
2xxkodlarini muvaffaqiyatli deb biladi. validateStatus: Serverdan kelgan istalgan HTTP status kodini (masalan,404,302,422) xato yoki muvaffaqiyatli deb belgilashni o'zingizga topshiradi.