Seriya: Axios Dars 21

Config Precedence — Request, instance va global konfiguratsiyalar ustuvorligi

Axios'da konfiguratsiya ustuvorligi (precedence): Global defaults, Instance defaults va Request config darajalari, qiymatlarning ustun kelishi va deep merge mexanizmi.

21-dars

Config Precedence — Request, instance va global konfiguratsiyalar ustuvorligi

Axios'da bir xil parametr (masalan, timeout, headers yoki baseURL) bir vaqtning o'zida bir nechta joyda ko'rsatilgan bo'lishi mumkin. Axios ularni qanday tartibda ustun qo'yishini (prioritetini) aniq qoida asosida hal qiladi.

1. Ustuvorlik tartibi (Eng pastdan eng yuqori darajagacha)

Agar bitta parametr har xil darajada berilgan bo'lsa, quyidagi tartib amal qiladi:

  1. Global Defaults (axios.defaults) — Eng past ustuvorlik
  2. Instance Defaults (axios.create({...})) — O'rta ustuvorlik (Global'ni ustiga yozadi)
  3. Request Config (axios.get(url, { ... })) — Eng yuqori ustuvorlik (Instance va Global'ni ustiga yozadi)

2. Real misol: Qaysi qiymat g'alaba qozonadi?

Keling, buni amalda timeout va headers misolida ko'rib chiqamiz:

import axios from 'axios';

// 1. GLOBAL DARAJA (Eng past prioritet)
axios.defaults.timeout = 10000; // 10 soniya
axios.defaults.headers.common['X-Source'] = 'GlobalApp';

// 2. INSTANCE DARAJA (Global'ni ustiga yozadi)
const api = axios.create({
  baseURL: 'https://api.example.com',
  timeout: 5000, // Globaldagi 10 soniyani 5 soniyaga o'zgartiradi (ustun keladi)
  headers: {
    'X-Source': 'CustomInstance', // Globaldagi 'GlobalApp' ni almashtiradi
    'X-Client-Type': 'Web',
  },
});

// 3. REQUEST DARAJA (Eng yuqori prioritet — hammasini ustiga yozadi)
const fetchData = async () => {
  const response = await api.get('/data', {
    timeout: 2000, // Bu so'rov uchun timeout 2 soniya bo'ladi (Instance'dagi 5 soniyani yutadi)
    headers: {
      'X-Source': 'DirectRequest', // Eng oxirgi va eng kuchli qiymat
    },
  });

  return response.data;
};

Natijada bu so'rov uchun yakuniy konfiguratsiya:

  • timeout: 2000 — Request darajasidagisi ustun keldi.
  • baseURL: 'https://api.example.com' — Faqat instance'da mavjud bo'lgani uchun o'zgarishsiz qoldi.
  • headers — Birlashtiriladi (merge qilinadi), lekin umumiy X-Source qiymati 'DirectRequest' ga o'zgaradi:
{
  "X-Source": "DirectRequest",
  "X-Client-Type": "Web"
}

3. Obyektlar va oddiy qiymatlarning birlashish farqi

Oddiy qiymatlar (timeout, baseURL, method):

Yuqori darajadagisi past darajadagisini to'liq almashtiradi (overwrite qiladi). Masalan, request darajasida timeout berilsa, instansiyadagi timeout butunlay e'tiborga olinmaydi.

Obyekt qiymatlar (headers, params):

To'liq o'rnini bosmaydi, balki chuqur birlashtiriladi (deep merge). Agar turli darajalarda har xil header'lar berilgan bo'lsa, ular yig'ilib bitta umumiy obyektga aylanadi. Faqat bitta kalit (key) ikkala joyda uchrasagina, yuqori darajadagisi pastdagining ustiga yoziladi.