Axios Request — HTTP so'rov yuborish usullari va konfiguratsiya
Axios'da so'rov yuborish usullari (shortcut va config object), Request Configuration parametrlari, dinamik so'rovlar, fayl yuklash va yuklab olish (blob, FormData).
7-dars
Axios Request — HTTP so'rov yuborish usullari va konfiguratsiya
Axios'da so'rov yuborishning ikkita asosiy yo'li bor:
- Shortcut methods (Qisqa metodlar):
axios.get(url, config),axios.post(url, data, config) - Config object method (To'liq konfiguratsiya obyekti):
axios({ ...config })
Katta hajmli va murakkab loyihalarda ikkinchi usul yoki maxsus instansiya orqali barcha parametrlarni bir joyda boshqarish juda qulay.
1. Request Configuration (Konfiguratsiya xususiyatlari)
Axios so'rov yuborishda juda ko'p parametrlarni qabul qiladi. Keling, eng muhim va ko'p ishlatiladiganlarini ko'rib chiqamiz:
interface RequestOptions {
url: string; // So'rov manzili (masalan, '/users')
method: string; // 'get', 'post', 'put', 'delete', 'patch'
baseURL?: string; // Asosiy domen (masalan, 'https://api.example.com')
headers?: object; // HTTP sarlavhalar (Headers)
params?: object; // Query parametrlar (?search=react&page=2)
data?: object; // POST/PUT so'rovlarida yuboriladigan asosiy ma'lumot (Payload)
timeout?: number; // Vaqt cheklovi (ms da, masalan 5000)
responseType?: 'json' | 'text' | 'blob' | 'arraybuffer'; // Javob formati
}
2. Real misol: To'liq konfiguratsiya obyektidan foydalanish
Tasavvur qiling, biz fayl yuklashimiz yoki maxsus responseType (masalan, PDF faylni blob ko'rinishida) olishimiz kerak. Bunday paytda qisqa metodlar yetarli bo'lmaydi va to'liq config obyektidan foydalanamiz.
import { apiClient } from '../api/axios';
interface UserProfile {
id: number;
username: string;
avatarUrl: string;
}
// Foydalanuvchi hisobotini PDF formatida yuklab olish misoli
export const downloadUserReport = async (userId: number): Promise<Blob> => {
try {
// Axios'ga bitta katta obyekt uzatamiz
const response = await apiClient({
method: 'GET',
url: `/users/${userId}/report`,
params: {
format: 'pdf',
includeDetails: true,
},
headers: {
'X-Custom-Header': 'ReportService',
},
responseType: 'blob', // MUHIM: Serverdan fayl (binary) kelishini bildiramiz
timeout: 30000, // Fayl og'ir bo'lishi mumkinligi uchun vaqtni uzaytiramiz
});
// response.data endi Blob formatida qaytadi
return response.data;
} catch (error: any) {
console.error('Hisobotni yuklab olishda xatolik:', error.message);
throw error;
}
};
3. Dinamik Request (So'rov turini o'zgaruvchan qilish)
Ba'zida umumiy bir universal funksiya yozish kerak bo'ladi va so'rov metodi (GET, POST va hokazo) parametr sifatida keladi. Config obyekt usuli buni juda oson hal qiladi:
type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
interface ApiRequestParams<TData = any> {
method: HttpMethod;
url: string;
data?: TData;
params?: Record<string, any>;
}
// Universal so'rov yuboruvchi yordamchi funksiya (Helper)
export const sendDynamicRequest = async <TResponse, TData = any>(
{ method, url, data, params }: ApiRequestParams<TData>
): Promise<TResponse> => {
const response = await apiClient({
method,
url,
data,
params,
});
return response.data;
};
// --- Ishlatilish misoli ---
// const users = await sendDynamicRequest<User[]>({ method: 'GET', url: '/users' });
// const newUser = await sendDynamicRequest<User, { name: string }>({ method: 'POST', url: '/users', data: { name: 'Ali' } });
4. Headers (Sarlavhalar) bilan ishlash darajalari
Axios so'rov yuborishda sarlavhalarni 3 xil joyda berish mumkin va ular bir-birini ustiga yozib boradi (merge qilinadi):
- Global/Instance darajadagi headers:
axios.create({ headers: { 'Authorization': '...' } }) - Method/Config darajadagi headers:
apiClient.get('/posts', { headers: { 'X-Cache': 'no-cache' } }) - Alohida so'rovda o'zgartirish: Ma'lum bir so'rov uchun oldingi tokenni bekor qilish yoki boshqa turdagi
Content-Type(masalan,multipart/form-data) berish.
// FormData (Fayl yuklash) uchun sarlavhani avtomatik moslashtirish
const uploadAvatar = async (file: File) => {
const formData = new FormData();
formData.append('avatar', file);
const response = await apiClient.post('/users/avatar', formData, {
headers: {
'Content-Type': 'multipart/form-data', // Fayl yuborilganda brauzer buni o'zi ham qo'yadi
},
});
return response.data;
};