Series: Axios Lesson 26

Instance Defaults — Har bir instance uchun alohida konfiguratsiya

Axios'da instance defaults bilan ishlash: instansiya yaratishda default sozlamalarni berish, dastur davomida dinamik o'zgartirish (mutating defaults) va metodlar bo'yicha sarlavhalar.

26-dars

Instance Defaults — Har bir instance uchun alohida konfiguratsiya

axios.create() yordamida ma'lum bir instansiyani yaratganingizda, unga bergan barcha sozlamalar (masalan, baseURL, timeout, headers) o'sha instansiyaning Default (boshlang'ich) konfiguratsiyasiga aylanadi. Keyinchalik har safar shu instansiya orqali so'rov yuborganingizda, bu sozlamalar avtomatik ravishda qo'shiladi.

1. Instansiya yaratish paytida default qiymatlarni berish

Instansiya yaratilayotgan vaqtda uning defaults obyektiga asosiy qoidalar kiritiladi:

import axios, { AxiosInstance } from 'axios';

export const apiClient: AxiosInstance = axios.create({
  // Bu yerda ko'rsatilganlar — ushbu instance'ning default (sukutdagi) qiymatlari hisoblanadi
  baseURL: 'https://api.mysite.com/v1',
  timeout: 8000,
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'X-App-Version': '2.4.0',
  },
});

2. Instansiya default qiymatlarini keyinchalik o'zgartirish (Dynamic Mutation)

Instance yaratilib bo'lingandan keyin ham, uning default qiymatlarini dastur davomida dinamik ravishda o'zgartirishingiz mumkin. Bu juda qulay, masalan, foydalanuvchi tizimga kirgach (login), umumiy baseURL yoki global headers'ga tokenni birdaniga qo'shib qo'yishda ishlatiladi:

import { apiClient } from './apiClient';

// 1. Sukutdagi timeout vaqtini keyinchalik o'zgartirish
apiClient.defaults.timeout = 15000; // 8 soniyadan 15 soniyaga oshiramiz

// 2. Sukutdagi headers'ga yangi umumiy header qo'shish
apiClient.defaults.headers.common['X-Custom-Tracking-Id'] = 'tracker_xyz_999';

// 3. Foydalanuvchi tizimga kirgach, token'ni instance defaults'ga o'rnatish
export const setAuthHeader = (token: string) => {
  // common barcha HTTP metodlar (GET, POST, PUT va h.k.) uchun umumiy sarlavha degani
  apiClient.defaults.headers.common['Authorization'] = `Bearer ${token}`;
};

// 4. Foydalanuvchi tizimdan chiqqanda (Logout) tokenni tozalash
export const removeAuthHeader = () => {
  delete apiClient.defaults.headers.common['Authorization'];
};

3. Muayyan HTTP metod uchun default header'ni o'zgartirish

Ba'zida barcha so'rovlar uchun emas, masalan, faqat POST yoki PUT so'rovlari uchun sukutdagi sarlavhani belgilash kerak bo'ladi. Axios bunda ham maxsus imkoniyat beradi:

// Faqat POST va PUT so'rovlari uchun default Content-Type'ni boshqacha qilish
apiClient.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
apiClient.defaults.headers.put['Content-Type'] = 'application/x-www-form-urlencoded';

Xulosa

  • Instance Defaults: Instansiya yaratilganda unga biriktirilgan va o'sha instansiyaning barcha so'rovlariga avtomatik tarqaladigan boshlang'ich sozlamalar to'plami.
  • Dinamik boshqaruv: instance.defaults orqali tokenlar, timeoutlar yoki bazaviy manzillarni istalgan vaqtda dastur davomida o'zgartirishingiz mumkin.