Series: Axios Lesson 112

Production Best Practices — Real loyihada Axios bilan ishlash standartlari

Katta hajmli frontend ilovalarida Axios va TypeScript bilan ishlashning eng muhim production standartlari: arxitektura, xavfsizlik, tokenlar, aborting, xatoliklarni markazlashgan boshqarish va unumdorlik qoidalari.

112-dars

Production Best Practices — Real loyihada Axios bilan ishlash standartlari

Axios va TypeScript yordamida yirik hajmli, tijorat darajasidagi (Production-ready) ilovalarni yaratish va uzoq muddat qo'llab-quvvatlash uchun qat'iy arxitekturaviy standartlarga amal qilish talab etiladi. Ushbu standartlar ilovangizning xavfsizligini, ishlash tezligini (Performance), kod sifatini va jamoaviy ishlash qulayligini ta'minlaydi.

Ushbu yakuniy darsda real production loyihalarda qo'llaniladigan eng muhim qoidalar va eng yaxshi amaliyotlar tizimlashtirilgan.


1. Arxitektura va Tashkil Etish Standartlari (Architecture)

1. Yagona API Client (Single Source of Truth)

Ilovaning hech bir joyida (komponentlar, hooklar yoki util funksiyalar ichida) to'g'ridan-to'g'ri axios.get yoki axios.post chaqirilmasligi kerak.

Barcha tarmoq so'rovlari faqat src/shared/api/client.ts faylida sozlangan global Axios instansiyasi orqali yuborilishi shart. Bu butun tizimda yagona baseURL, timeout, headerlar va interceptorlar ishlashini kafolatlaydi.

2. Feature-based Modulli Tuzilma

Katta loyihalarda barcha API xizmatlarini bitta umumiy papkaga joylash spagetti kodga olib keladi. API xizmatlarini biznes yo'nalishlar bo'yicha ajrating:

src/
├── shared/
│   └── api/
│       ├── client.ts              # Global Axios instansiyasi
│       ├── interceptors/          # Auth, Logger, Retry interceptorlari
│       └── utils/                 # Redaction va URL yordamchilari
│
└── features/
    ├── auth/
    │   └── api/auth.service.ts    # Faqat Auth xizmatlari
    └── products/
        └── api/products.service.ts # Faqat Mahsulotlar xizmati
flowchart TD
    UI["React Komponent / Sahifa"] --> Hook["Custom Hook / TanStack Query"]
    Hook --> Service["Feature API Service (e.g. products.service.ts)"]
    Service --> Client["Shared API Client (client.ts)"]
    Client --> Interceptors["Interceptors (Auth, Retry, Logger)"]
    Interceptors --> Network["Backend Server (REST API)"]

2. Xavfsizlik va Token Boshqaruvi (Security & Auth)

1. In-Memory Token Saqlash

Access token'larni localStorage yoki sessionStorageda saqlash XSS (Cross-Site Scripting) hujumlariga ochiq eshik qoldiradi.

  • Tavsiya: Access token'ni xotirada (JavaScript in-memory o'zgaruvchisida) saqlang.
  • Refresh Token: Uni faqat HttpOnly, Secure va SameSite=Strict bayroqlariga ega bo'lgan cookie orqali boshqaring.

2. Sensitive Data Redaction (Maxfiy Ma'lumotlarni Niqoblash)

Konsolga yoki tashqi monitoring tizimlariga (Sentry, Datadog) yuborilayotgan loglarda foydalanuvchilarning parollari, karta raqamlari (CVV) va tokenlari hech qachon ochiq ko'rinmasligi kerak. Buning uchun rekursiv redactData tozalash qatlamini doimiy faol tuting.

[!CAUTION] Production muhitida konsolga log yozishni (console.log) butunlay o'chiring (import.meta.env.DEV sharti bilan). Ochiq loglar xavfsizlikka ziyon yetkazadi va xotirani band qiladi.


3. Tarmoq va Unumdorlik (Performance & Reliability)

1. Avtomatik Request Bekor Qilish (AbortSignal)

Foydalanuvchi sahifani tezda tark etganda yoki inputga ketma-ket yozganda (autocomplete), avvalgi tugallanmagan so'rovlarni AbortController signali yordamida bekor qilish shart:

// TanStack Router yoki React useEffect ichida signal uzatish
export const fetchUserData = async (userId: string, signal?: AbortSignal) => {
  const response = await apiClient.get<User>(`/users/${userId}`, { signal });
  return response.data;
};

2. Markazlashgan Xatoliklarni Boshqarish (Centralized Error Handling)

Har bir komponentda 401, 403 yoki 500 xatolarini tekshirib o'tirmang. Bularni global Response Interceptor darajasida bir joyda hal qiling:

  • 401 Unauthorized: Silent token refresh qilish yoki foydalanuvchini logout qilib login sahifasiga yo'naltirish.
  • 403 Forbidden: "Ruxsat yo'q" xabarini yoki sahifasini ko'rsatish.
  • 500 Server Error: Global xatolik bildirishnomasi (Toast / Notification) chiqarish.

3. Oqilona Timeout Sozlamalari

Har doim timeout belgilang (masalan, 10–15 soniya). Timeout bo'lmasa, sekin tarmoqda so'rov cheksiz osilib qoladi va brauzer resurslarini yeydi:

export const apiClient = axios.create({
  baseURL: import.meta.env.VITE_API_BASE_URL,
  timeout: 15000, // 15 soniya
});

4. TypeScript Standartlari (Type Safety)

1. Generik Tiplar Bilan Ishlash (Generic Typed Methods)

So'rov natijalarini hech qachon any turida qoldirmang. Har doim aniq interfeyslarni generic sifatida uzating:

// ❌ YOMON AMALIYOT: any ishlatish
const { data } = await apiClient.get('/products'); // data turi: any

// ✅ PRODUCTION STANDARTI: To'liq tiplashtirish
export interface Product {
  id: string;
  name: string;
  price: number;
}

export const getProducts = async (): Promise<Product[]> => {
  const response = await apiClient.get<Product[]>('/products');
  return response.data; // data turi: Product[]
};

2. Environment Variables Tiplashtirilishi

Muhit o'zgaruvchilarini TypeScript orqali qat'iy tekshirib qo'ying:

// src/vite-env.d.ts
interface ImportMetaEnv {
  readonly VITE_API_BASE_URL: string;
  readonly VITE_APP_ENV: 'development' | 'staging' | 'production';
}

interface ImportMeta {
  readonly env: ImportMetaEnv;
}

[!TIP] Agar loyihada Zod yoki Valibot mavjud bo'lsa, backenddan kelayotgan JSON ma'lumotlarini runtime darajasida tekshirish (Schema Validation) ilovaning kutilmagan undefined xatoliklaridan to'liq himoyalaydi.


5. Production Readiness Nazorat Jadvali (Checklist)

Loyiha ishlab chiqarishga (production) chiqarilishidan oldin quyidagi nazorat ro'yxatidan o'tishi tavsiya etiladi:

Yo'nalish Qoida / Standart Xavf Darajasi Natija
Arxitektura Yagona shared/api/client.ts instansiyasi Yuqori 🔴 Butun ilovada yagona konfiguratsiya kafolatlanadi
Xavfsizlik Tokenlarni faqat xotirada yoki HttpOnly cookie'da saqlash Kritik 🛑 XSS va ma'lumot o'g'irlanishining oldi olinadi
Xavfsizlik Sensitive data redaction va dev logging izolyatsiyasi Yuqori 🔴 Log tizimlariga parollar va tokenlar sizib chiqmaydi
Tarmoq 10-15s Timeout va AbortSignal integratsiyasi O'rta 🟡 Sahifa osilib qolmaydi, keraksiz so'rovlar bekor bo'ladi
Xatoliklar Markazlashgan interceptor (401, 403, 500) Yuqori 🔴 UI kodlari toza qoladi, sessiya barqaror boshqariladi
TypeScript any turlaridan to'liq voz kechish va DTO tiplar Yuqori 🔴 Refaktoring xavfsiz va auto-complete to'liq ishlaydi
Testlash axios-mock-adapter orqali unit testlar O'rta 🟡 CI/CD pipeline barqaror va tezkor ishlaydi

6. Xulosa

Axios va TypeScript bilan ishlashda ushbu standartlarga rioya qilish shunchaki kodni chiroyli qilish emas, balki biznes darajasidagi dasturiy mahsulotning xavfsizligi, tezkorligi va o'zgarishlarga moslashuvchanligini kafolatlovchi mustahkam poydevordir.