Series: Axios Lesson 45

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.