Conditional Interceptors — runWhen orqali shartli interceptor ishlatish
Axios'da shartli interceptorlar: runWhen parametri orqali interceptorlarni faqat ma'lum so'rovlar yoki URL'lar uchun faollashtirish va public endpointlarni boshqarish.
40-dars
Conditional Interceptors — runWhen orqali shartli interceptor ishlatish
Ba'zida shunday holat yuzaga keladiki, bitta Axios instansiyasida bir nechta so'rovlar yuboriladi, lekin qaysidir interceptor faqat ma'lum bir shart bajarilgandagina (masalan, so'rov manzili /auth/ bilan boshlanmasa yoki maxsus header talab etilsa) ishlashi kerak bo'ladi.
Buni amalga oshirish uchun Axios request interceptor'ning uchinchi parametri sifatida runWhen funksiyasini qabul qiladi.
1. runWhen qanday ishlaydi?
runWhen — bu config obyektini qabul qilib, boolean (true yoki false) qiymat qaytaruvchi shart tekshiruvchi funksiya hisoblanadi:
- Agar
runWhentrueqaytarsa $\rightarrow$ o'sha interceptor ishga tushadi. - Agar
runWhenfalseqaytarsa $\rightarrow$ Axios o'sha interceptor'ni butunlay o'tkazib yuboradi va so'rovga ta'sir qilmaydi.
Sintaksisi:
axiosInstance.interceptors.request.use(
onFulfilled,
onRejected,
{
runWhen: (config) => {
// boolean qaytariladi: true bo'lsa ishlaydi, false bo'lsa o'tkazib yuboriladi
return true;
}
}
);
2. Real misol: Public endpoint'lar uchun tokenni o'tkazib yuborish
Tasavvur qiling, sizda umumiy apiClient bor va uning request interceptor'i avtomatik ravishda Authorization token qo'shadi. Lekin /auth/login yoki /auth/register kabi ochiq (public) sahifalarda foydalanuvchining tokeni hali yo'q yoki eski token jo'natilishi kerak emas.
Oldin buni interceptor ichida if sharti bilan yozgan bo'lsak, endi runWhen orqali yanada toza va qulay tashkil qilamiz:
import { apiClient } from './client';
// Token qo'shuvchi interceptor'ni faqat ma'lum URL'lar uchun ishlatamiz
apiClient.interceptors.request.use(
(config) => {
const token = localStorage.getItem('accessToken');
if (token) {
config.headers.Authorization = `Bearer ${token}`;
}
return config;
},
(error) => Promise.reject(error),
{
// RUNWHEN: Bu interceptor faqat quyidagi shart bajarilgandagina ishlaydi
runWhen: (config) => {
const url = config.url || '';
// Agar so'rov login yoki register ga ketsa, bu interceptor ISHLAMAYDI (false qaytaradi)
const isPublicEndpoint = url.includes('/auth/login') || url.includes('/auth/register');
return !isPublicEndpoint; // Faqat public bo'lmagan so'rovlarda ishlaydi
},
}
);
3. runWhen ning afzalliklari
- Toza va tushunarli kod (Clean Code): Interceptor funksiyasining ichida qatorlab
if/elseshartlarini yozib o'tirishga hojat qolmaydi. Boshqaruv sharti alohidarunWhenopsiyasida aniq ko'rsatib qo'yiladi. - Granular nazorat: Bitta instansiya ichidagi har bir alohida interceptor qaysi turdagi so'rovlarda faol bo'lishini alohida shart bilan aniq boshqarasiz.
- Xatoliklarning oldini olish: Ba'zi so'rovlarga keraksiz header'lar yoki ma'lumotlar qo'shilib ketishining oldini oladi.
- Resurs va unumdorlik: Shart bajarilmaganda interceptor logikasi umuman ishga tushmaydi, natijada ortiqcha hisoblashlar bo'lmaydi.
4. runWhen vs Interceptor ichidagi if sharti
| Xususiyat | runWhen parametri | Interceptor ichidagi if |
|---|---|---|
| Ajratilganlik | Interceptor logikasi va shart bir-biridan mustaqil ajralgan | Shart va asosiy logika bitta funksiya ichida qorishadi |
| O'qilishi | Toza, opsiyalar obyektida deklarativ beriladi | Murakkab shartlar bo'lsa handler kodini chalkashtiradi |
| Moslashuvchanlik | Har bir interceptor'ga alohida shart biriktirish oson | Har safar handler ichida return config bilan chiqib ketish kerak |
Xulosa
runWhen opsiyasi Axios interceptor'lariga shartli (conditional) ishlash imkoniyatini beradi. U ayniqsa ochiq (public) va yopiq (protected) API endpoint'larini bitta umumiy apiClient orqali boshqarganda kodni toza, xavfsiz va ixcham saqlashga xizmat qiladi.