AxiosRequestConfig — Request konfiguratsiyasini tipizatsiya qilish
AxiosRequestConfig interfeysi: request sozlamalarini to'liq tiplashtirish, Service qatlamida ixtiyoriy config parametrini uzatish va AbortSignal bilan integratsiya.
45-dars
AxiosRequestConfig — Request konfiguratsiyasini tipizatsiya qilish
AxiosRequestConfig — bu Axios orqali so'rov yuborayotganingizda (yoki yangi instansiya yaratayotganingizda) beriladigan barcha sozlamalarni (url, method, headers, params, data, signal va hokazo) o'z ichiga olgan TypeScript interfeysidir.
Ushbu interfeysdagi deyarli barcha maydonlar ixtiyoriy (optional) hisoblanadi.
1. AxiosRequestConfig ning asosiy tuzilishi
Axios kutubxonasidagi AxiosRequestConfig interfeysining ichki tuzilishi quyidagicha ko'rinishga ega:
export interface AxiosRequestConfig<D = any> {
url?: string;
method?: Method | string;
baseURL?: string;
headers?: AxiosRequestHeaders;
params?: any;
data?: D; // Yuboriladigan payload (body) turi
timeout?: number;
signal?: AbortSignal; // So'rovni bekor qilish uchun (Cancellation)
withCredentials?: boolean;
responseType?: ResponseType;
// va yana o'nlab boshqa konfiguratsion sozlamalar...
}
Generik <D> yuborilayotgan data (request body) turini belgilash uchun xizmat qiladi.
2. Amaliy misol: Service qatlamida moslashuvchanlikni oshirish
Service qatlamida funksiyalar yozayotganingizda, ba'zida UI komponentdan turib maxsus sarlavhalar (headers), URL query parametrlari (params), timeout yoki so'rovni bekor qilish signalini (AbortSignal) uzatishga ehtiyoj tug'iladi.
Buning uchun servis funksiyasining oxirgi parametriga AxiosRequestConfig ni ixtiyoriy (optional) qilib qo'shish eng yaxshi amaliyot hisoblanadi:
// src/services/productService.ts
import { apiClient } from '../api/client';
import { AxiosRequestConfig } from 'axios';
import { Product } from '../types';
export const ProductService = {
// config parametri orqali komponentdan xohlagan qo'shimcha sozlamani qabul qilamiz
getAll: async (config?: AxiosRequestConfig): Promise<Product[]> => {
const res = await apiClient.get<Product[]>('/products', config);
return res.data;
},
create: async (
data: Partial<Product>,
config?: AxiosRequestConfig
): Promise<Product> => {
const res = await apiClient.post<Product>('/products', data, config);
return res.data;
}
};
3. UI Komponentda qanday ishlatiladi?
Endi komponent ichidan turib faqatgina shu so'rov uchun xos bo'lgan parametrlarni bemalol va xavfsiz uzata olamiz:
// src/components/ProductList.tsx
import React, { useEffect, useState } from 'react';
import { ProductService } from '../services/productService';
import { Product } from '../types';
export const ProductList = () => {
const [products, setProducts] = useState<Product[]>([]);
useEffect(() => {
// 1. So'rovni bekor qilish uchun AbortController yaratamiz
const controller = new AbortController();
// 2. Query parametrlar, maxsus header va signal yuboramiz:
ProductService.getAll({
params: { category: 'electronics', sortBy: 'price' },
headers: { 'X-Custom-Filter': 'true' },
timeout: 5000, // Faqat shu so'rov uchun 5 soniya
signal: controller.signal // Komponent o'chsa so'rov bekor qilinadi
})
.then((data) => setProducts(data))
.catch((err) => {
if (err.name !== 'CanceledError') {
console.error(err);
}
});
// 3. Cleanup funksiyasida so'rovni bekor qilamiz
return () => {
controller.abort();
};
}, []);
return (
<div>
<h2>Mahsulotlar</h2>
{products.map((p) => (
<div key={p.id}>{p.title}</div>
))}
</div>
);
};
4. AxiosRequestConfig ning eng muhim maydonlari
| Maydon | Turi | Tavsifi |
|---|---|---|
params |
any / Record<string, any> |
URL query parametrlarini obyekt sifatida uzatish (?key=value) |
headers |
AxiosRequestHeaders |
Muayyan so'rov uchun maxsus HTTP sarlavhalar |
signal |
AbortSignal |
AbortController.signal orqali so'rovni bekor qilish |
timeout |
number |
Muayyan so'rov uchun millisekundlarda vaqt chegarasi |
responseType |
'json' | 'blob' | 'text' ... |
Serverdan kutilayotgan javob formati (masalan, fayl yuklab olish uchun blob) |
withCredentials |
boolean |
Cross-site so'rovlarda cookie'larni birga yuborish |
Xulosa
AxiosRequestConfig yordamida servis metodlariga qo'shimcha moslashuvchanlik kiritiladi. Servis qatlami asosiy endpoint va ma'lumotlarni o'zida saqlagan holda, UI qatlamiga dinamik query parametrlar, saralash, qidiruv va AbortSignal orqali so'rovni bekor qilish erkinligini taqdim etadi.