AxiosInstance — Instance API va uning imkoniyatlari
TypeScript'da AxiosInstance interfeysi: qisqa metodlar, interceptorlar va defaults boshqaruvi, dependency injection orqali instansiyani uzatish va dinamik sozlash.
24-dars
AxiosInstance — Instance API va uning imkoniyatlari
Oldingi mavzuda axios.create() yordamida shaxsiy instance yaratishni ko'rdik. AxiosInstance esa TypeScript'da ana shu yaratilgan instansiyaning tiplashtirilgan turi (interface) hisoblanadi.
Aslida, AxiosInstance obyektining o'zi ham funksiya, ham obyekt bo'lib ishlaydi. Keling, uning barcha imkoniyatlarini ko'rib chiqamiz.
1. AxiosInstance qanday imkoniyatlarga ega?
Siz yaratgan har bir apiClient instansiyasi oddiy axios kutubxonasi egalik qiladigan barcha metodlarga to'liq ega bo'ladi:
- Qisqa metodlar (Shortcut methods):
apiClient.get(url, config)apiClient.post(url, data, config)apiClient.put(url, data, config)apiClient.patch(url, data, config)apiClient.delete(url, config)apiClient.options(url, config)apiClient.head(url, config)
- Universal config usuli:
apiClient({ method: 'post', url: '/users', data: ... })
- Interceptors (To'siqlar) boshqaruvi:
apiClient.interceptors.request.use(...)apiClient.interceptors.response.use(...)
- Defaults (Standart sozlamalar):
apiClient.defaults.baseURLapiClient.defaults.headersapiClient.defaults.timeout
2. Real misol: AxiosInstance turini TypeScript'da ishlatish
TypeScript loyihalarida funksiyalarga argument sifatida instansiyani uzatishda yoki maxsus yordamchi (helper) funksiyalar yozishda AxiosInstance turidan foydalanish juda muhim (Dependency Injection):
import axios, { AxiosInstance, AxiosRequestConfig } from 'axios';
// 1. Instansiyani yaratamiz va uni AxiosInstance sifatida tiplashtiramiz
export const apiClient: AxiosInstance = axios.create({
baseURL: 'https://api.example.com/v1',
timeout: 10000,
});
// 2. AxiosInstance'ni qabul qiluvchi yordamchi funksiya (Dependency Injection)
// Bu kodni test qilish yoki boshqa instance'ga ulashni osonlashtiradi
export const fetchDataWithCustomInstance = async (client: AxiosInstance, endpoint: string) => {
const response = await client.get(endpoint);
return response.data;
};
// Ishlatilishi:
// await fetchDataWithCustomInstance(apiClient, '/users');
3. Instansiyani keyinchalik o'zgartirish (Mutating defaults)
AxiosInstance yaratilgandan keyin ham uning default qiymatlarini dastur davomida dinamik ravishda o'zgartirishingiz mumkin. Bu ayniqsa foydalanuvchi tizimga kirgandan keyin token yoki tildagi o'zgarishlarni global qo'shishda qo'l keladi:
import { apiClient } from './axiosInstance';
// Foydalanuvchi tizimga kirgach, token o'zgardi va biz uni instansiyaning global header'iga yozib qo'yamiz:
export const setAuthTokenInInstance = (token: string) => {
apiClient.defaults.headers.common['Authorization'] = `Bearer ${token}`;
};
// Agar foydalanuvchi tizimdan chiqib ketsa (Logout):
export const clearAuthTokenFromInstance = () => {
delete apiClient.defaults.headers.common['Authorization'];
};
4. Instansiya ichida boshqa instansiyani yaratish
Katta arxitekturali loyihalarda asosiy instansiyadan uning sozlamalarini meros qilib olib, yangi instansiyalarni yaratish ham mumkin:
import axios from 'axios';
import { apiClient } from './axiosInstance';
// apiClient asosida maxsus version 2 uchun yangi instance yaratamiz
const apiV2 = axios.create({
...apiClient.defaults, // Asosiy instansiyaning sozlamalarini meros qilib olamiz
baseURL: 'https://api.example.com/v2', // URL'ni o'zgartiramiz
});