Series: Axios Lesson 40

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 runWhen true qaytarsa $\rightarrow$ o'sha interceptor ishga tushadi.
  • Agar runWhen false qaytarsa $\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

  1. Toza va tushunarli kod (Clean Code): Interceptor funksiyasining ichida qatorlab if/else shartlarini yozib o'tirishga hojat qolmaydi. Boshqaruv sharti alohida runWhen opsiyasida aniq ko'rsatib qo'yiladi.
  2. Granular nazorat: Bitta instansiya ichidagi har bir alohida interceptor qaysi turdagi so'rovlarda faol bo'lishini alohida shart bilan aniq boshqarasiz.
  3. Xatoliklarning oldini olish: Ba'zi so'rovlarga keraksiz header'lar yoki ma'lumotlar qo'shilib ketishining oldini oladi.
  4. 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.