Series: Axios Lesson 11

Request Config — Axios request konfiguratsiyasi

AxiosRequestConfig interfeysi: url, method, headers, params, data, timeout, withCredentials, validateStatus, paramsSerializer va signal parametrlarini chuqur o'rganish.

11-dars

Request Config — Axios request konfiguratsiyasi

Axios'da AxiosRequestConfig (TypeScript'da) bu so'rovning barcha parametrlarini o'z ichiga olgan asosiy interfeysdir. Uni to'g'ri sozlash orqali so'rovlarni mukammal va moslashuvchan boshqarish mumkin.

Asosiy Config xususiyatlari (Properties)

Keling, eng ko'p ishlatiladigan va muhim konfiguratsiya maydonlarini ko'rib chiqamiz:

import { AxiosRequestConfig } from 'axios';

const config: AxiosRequestConfig = {
  url: '/users',            // So'rov yuboriladigan manzil
  method: 'POST',           // HTTP metod ('GET', 'POST', 'PUT', 'DELETE', va h.k.)
  baseURL: 'https://api.example.com', // Asosiy domen
  headers: {                // HTTP sarlavhalar
    'Content-Type': 'application/json',
    'Authorization': 'Bearer token123',
  },
  params: {                 // URL query parametrlari (?search=react&page=1)
    search: 'react',
    page: 1,
  },
  data: {                   // POST/PUT so'rovlarida yuboriladigan asosiy ma'lumot (Payload)
    name: 'Jasur',
    role: 'Frontend Developer',
  },
  timeout: 10000,           // Vaqt chegarasi (ms). 10 sekunddan oshsa so'rov to'xtatiladi
  responseType: 'json',     // Javob formati ('json', 'text', 'blob', 'arraybuffer')
  withCredentials: true,    // Cookie'larni so'rov bilan birga yuborish uchun
};

Real misol va ilg'or sozlamalar

Keling, TypeScript va Axios yordamida maxsus konfiguratsiyaga ega murakkabroq so'rov yozamiz. Shuningdek, validateStatus va paramsSerializer kabi ilg'or sozlamalarni ko'rib chiqamiz:

import axios, { AxiosRequestConfig } from 'axios';

interface User {
  id: number;
  name: string;
}

export const fetchActiveUsers = async (searchTerm: string): Promise<User[]> => {
  // Konfiguratsiya obyektini alohida e'lon qilamiz
  const config: AxiosRequestConfig = {
    method: 'GET',
    url: '/users/search',
    baseURL: 'https://api.example.com/v1',
    params: {
      q: searchTerm,
      status: 'active',
    },
    headers: {
      'X-Client-Version': '2.1.0',
    },
    timeout: 5000, // 5 soniya timeout
    
    // 1. MUHIM: validateStatus orqali qaysi HTTP status kodlarini muvaffaqiyatli deb 
    // qabul qilishni o'zimiz belgilaymiz. Standart holatda faqat 2xx muvaffaqiyatli sanaladi.
    validateStatus: (status) => {
      return status >= 200 && status < 300; // Faqat 2xx lar catch'ga tushmaydi
    },
  };

  try {
    const response = await axios<User[]>(config);
    return response.data;
  } catch (error: any) {
    if (axios.isAxiosError(error)) {
      console.error(`So'rov xatosi [Status: ${error.response?.status}]:`, error.message);
    } else {
      console.error('Nomaʼlum xatolik:', error);
    }
    throw error;
  }
};

Maxsus sozlamalar va ularning ahamiyati

1. paramsSerializer (Query parametrlarni moslash):

Ba'zida backend serveri massiv shaklidagi query parametrlarni (ids=1&ids=2 yoki ids[]=1&ids[]=2) o'ziga xos formatda kutadi. paramsSerializer yordamida ularni o'zingiz istagan formatga o'tkazishingiz mumkin:

const config: AxiosRequestConfig = {
  params: { ids: [1, 2, 3] },
  paramsSerializer: (params) => {
    // Parametrlarni o'zimiz istagan ko'rinishda string'ga aylantiramiz
    return new URLSearchParams(params).toString();
  },
};

2. signal (So'rovni bekor qilish):

Oldingi mavzularda ko'rganimizdek, AbortController signali ham aynan Request Config ichiga beriladi:

const controller = new AbortController();

axios.get('/data', {
  signal: controller.signal,
});

// Kerak bo'lganda so'rovni to'xtatish uchun:
// controller.abort();