params — URL query parametrlarini yuborish
Axios'da params obyekti yordamida query parametrlarini xavfsiz URL-encode qilish, pagination, undefined qiymatlarni avtofiltrlash va paramsSerializer bilan ishlash.
14-dars
params — URL query parametrlarini yuborish
Nima uchun URL'ni qo'lda yozmagan ma'qul?
Tasavvur qiling, siz foydalanuvchini qidirmoqchisiz va so'rov matnida bo'sh joy (space yoki maxsus belgilar) bor. Agar uni qo'lda URL'ga ulasangiz:
// ❌ NOTO'G'RI YONDASHUV
apiClient.get('/users?search=' + text);
Agar text ichida o'zbekcha harflar, bo'sh joylar yoki maxsus belgilar bo'lsa, URL buzilib ketishi va server xato berishi mumkin (URL Encoding muammosi).
Axios'ning params obyekti esa barcha maxsus belgilarni va bo'sh joylarni avtomatik ravishda to'g'ri kodlab (URL-encode qilib), xavfsiz holatda serverga jo'natadi.
1. Real misol: params yordamida qidiruv va sahifalash
Keling, TypeScript yordamida mahsulotlarni qidirish va sahifalarga bo'lib olish (pagination) so'rovini yozamiz:
import { apiClient } from '../api/axios';
interface Product {
id: number;
title: string;
price: number;
}
interface ProductResponse {
data: Product[];
total: number;
page: number;
}
interface SearchFilterParams {
query: string;
page: number;
limit: number;
sortBy: 'price' | 'date';
}
// Mahsulotlarni filtrlar asosida olish funksiyasi
export const searchProducts = async (filters: SearchFilterParams): Promise<ProductResponse> => {
// Axios bu yerda berilgan object'ni avtomatik ravishda quyidagi ko'rinishga o'tkazadi:
// /products/search?q=iphone&page=1&limit=10&sort=price
const response = await apiClient.get<ProductResponse>('/products/search', {
params: {
q: filters.query,
page: filters.page,
limit: filters.limit,
sort: filters.sortBy,
},
});
return response.data;
};
2. undefined yoki null qiymatlarni avtofiltrlash
Axios'ning yana bir ajoyib xususiyati shundaki, agar params obyekti ichida qiymati undefined yoki null bo'lgan maydonlar bo'lsa, Axios ularni URL'ga qo'shib yubormaydi (avtomatik tashlab yuboradi).
interface UserFilter {
role?: string;
status?: string;
search?: string;
}
export const getUsers = async (filter: UserFilter) => {
// Agar filter.status undefined bo'lsa, URL'ga status qo'shilmaydi
const response = await apiClient.get('/users', {
params: {
role: filter.role,
status: filter.status, // Agar yo'q bo'lsa, e'tiborga olinmaydi
search: filter.search,
},
});
return response.data;
};
3. Massiv (Array) parametrlarni yuborish va paramsSerializer
Ba'zida server bir nechta ID'larni massiv ko'rinishida so'raydi (masalan, tanlangan mahsulotlarni filtrlash yoki o'chirish uchun: ids=[1, 2, 3]). Axios standart holatda bunday massivlarni ids[]=1&ids[]=2 ko'rinishida serialize qiladi.
Lekin ayrim backend serverlar boshqa formatni talab qiladi (masalan, ids=1,2,3 yoki ids=1&ids=2). Bunday paytda paramsSerializer yordamga keladi:
import { apiClient } from '../api/axios';
export const getProductsByIds = async (ids: number[]) => {
const response = await apiClient.get('/products', {
params: {
ids: ids, // [1, 2, 3]
status: 'active',
},
// paramsSerializer orqali query string qanday yasalishini o'zimiz boshqaramiz
paramsSerializer: (params) => {
return new URLSearchParams(params as any).toString();
},
});
return response.data;
};