Seriya: Axios Dars 89

Response Transformation — transformResponse orqali response ma'lumotlarini o'zgartirish

Axios transformResponse funksiyasi orqali serverdan kelgan response ma'lumotlarini o'zgartirish: snake_case dan camelCase ga o'tkazish, xavfsiz JSON parsing, Date/Blob istisnolari va Response Interceptor bilan farqi.

89-dars

Response Transformation — transformResponse orqali response ma'lumotlarini o'zgartirish

Oldingi darsda serverga yuboriladigan so'rov ma'lumotlarini camelCase dan snake_case ga o'tkazishni o'rgandik. Serverdan javob (response) kelganda esa ko'pincha buning aksi sodir bo'ladi: backend API ma'lumotlarni snake_case formatida (user_profile, created_at, is_active) qaytaradi, frontend ilovamiz va TypeScript interfeyslarimiz esa qat'iy ravishda camelCase (userProfile, createdAt, isActive) formatini talab qiladi.

Agar ushbu moslashtirishni har bir servis yoki komponent ichida qo'lda map qilib chiqsak, kodimiz takrorlanishlar va ortiqcha mantiqqa to'lib ketadi. Ushbu muammoni toza va markazlashgan holda hal qilish uchun Axios'ning transformResponse mexanizmidan foydalanamiz.


1. transformResponse o'zi nima va u qanday ishlaydi?

transformResponse — bu serverdan kelgan xom javobni (raw response data) ilova yoki komponentlarga yetib borishidan oldin qayta ishlovchi, formatlovchi yoki o'zgartiruvchi funksiyalar massividir (Array of functions).

flowchart LR
    A["Serverdan Xom Matn (Raw JSON)\n'{\"first_name\":\"Ali\",\"created_at\":\"2026-01-01\"}'"] --> B["transformResponse #1\n(JSON.parse)"]
    B --> C["transformResponse #2\n(snake_case -> camelCase)"]
    C --> D["Response Interceptor"]
    D --> E["Komponent / Servis\n{ firstName: 'Ali', createdAt: '2026-01-01' }"]

Asosiy xususiyatlari:

  1. Eng birinchi ishga tushadi: Serverdan javob kelishi bilanoq, hatto Axios Response Interceptor va .then() yoki await bloklariga yetib bormasdan oldin aynan transformResponse funksiyalari ishga tushadi.
  2. Standart vazifasi: Axios sukut bo'yicha o'zining standart transformatoriga ega bo'lib, u serverdan kelgan JSON matnini avtomatik tarzda JSON.parse() qilib JavaScript obyektiga aylantiradi.
  3. Zanjirli uzatish: Har bir transformator funksiya oldingi funksiyaning natijasini qabul qiladi va keyingisiga uzatadi.

2. Amaliyot: TypeScript yordamida Snake_Case'ni CamelCase'ga o'tkazish

Keling, serverdan kelgan barcha kalitlarni, shu jumladan ichma-ich joylashgan obyektlar va massivlarni avtomatik camelCase formatiga o'tkazuvchi toza funksiya yozamiz:

// src/utils/responseTransformers.ts

/**
 * Satrni snake_case yoki kebab-case dan camelCase ga o'tkazadi
 * Masalan: "first_name" -> "firstName", "order-status" -> "orderStatus"
 */
export const toCamelCase = (str: string): string => {
  return str.replace(/([-_][a-z0-9])/gi, (group) =>
    group.toUpperCase().replace('-', '').replace('_', '')
  );
};

/**
 * Obyekt yoki massiv ichidagi barcha kalitlarni rekursiv ravishda camelCase ga o'tkazadi
 */
export const transformKeysToCamelCase = (data: unknown): unknown => {
  // Agar ma'lumot massiv bo'lsa, har bir elementini qayta ishlaymiz
  if (Array.isArray(data)) {
    return data.map((item) => transformKeysToCamelCase(item));
  }

  // Agar oddiy obyekt bo'lsa (Date, Blob, RegExp kabi maxsus turlar istisno qilinadi)
  if (
    data !== null &&
    typeof data === 'object' &&
    !(data instanceof Date) &&
    !(data instanceof RegExp) &&
    !(data instanceof Blob)
  ) {
    const rawObject = data as Record<string, unknown>;
    return Object.keys(rawObject).reduce<Record<string, unknown>>((acc, key) => {
      const camelKey = toCamelCase(key);
      acc[camelKey] = transformKeysToCamelCase(rawObject[key]);
      return acc;
    }, {});
  }

  // Ibtidoiy turlar (string, number, boolean) o'zgarishsiz qoladi
  return data;
};

3. Axios Instansiyasida transformResponse ni qo'llash

Endi ushbu transformatorni global API mijozimizga ulaymiz:

// src/api/client.ts
import axios, { AxiosResponseTransformer } from 'axios';
import { transformKeysToCamelCase } from '../utils/responseTransformers';

export const apiClient = axios.create({
  baseURL: 'https://api.mysite.com/v1',
  timeout: 10000,

  // --- RESPONSE TRANSFORMATION ---
  transformResponse: [
    // 1-QADAM: Axios'ning standart transformatsiyasini bajaramiz
    // (Serverdan kelgan xom matnni xavfsiz JSON.parse qilish)
    (data) => {
      if (typeof data === 'string') {
        try {
          return JSON.parse(data);
        } catch {
          // Agar JSON bo'lmasa (masalan, oddiy matn yoki HTML xatolik), o'z holicha qaytaramiz
          return data;
        }
      }
      return data;
    },

    // 2-QADAM: Olingan obyektning kalitlarini camelCase formatiga o'tkazamiz
    (parsedData) => {
      if (parsedData && typeof parsedData === 'object') {
        return transformKeysToCamelCase(parsedData);
      }
      return parsedData;
    },
  ],
});

Natijani sinab ko'ramiz:

Server quyidagi snake_case JSON javobini qaytardi:

{
  "user_id": 101,
  "first_name": "Sardor",
  "account_details": {
    "is_premium": true,
    "last_login_at": "2026-11-16T10:00:00Z"
  }
}

Frontend servisimizda qabul qilingan toza camelCase ma'lumot:

interface UserResponse {
  userId: number;
  firstName: string;
  accountDetails: {
    isPremium: boolean;
    lastLoginAt: string;
  };
}

const response = await apiClient.get<UserResponse>('/users/101');

// TypeScript interfeysi bilan 100% mos keladi:
console.log(response.data.userId); // 101
console.log(response.data.accountDetails.isPremium); // true

4. transformResponse va Response Interceptor Farqi

Mezon transformResponse Response Interceptor
Ishga tushish tartibi Birinchi navbatda (tarmoqdan kelishi bilanoq) transformResponse dan keyin ishga tushadi
Qamrovi Faqat javob tanasi (data), headers, status Butun javob obyekti (response.data, status, config, headers)
Asinxronlik (Async/Await) Faqat sinxron ishlaydi Asinxron amallarni (Promise) qo'llab-quvvatlaydi
Xatoliklarni boshqarish Faqat muvaffaqiyatli ma'lumotlar tanasi uchun 4xx va 5xx xatolarini tutish va Silent Refresh uchun
Asosiy maqsadi Ma'lumotlarni normalizatsiya qilish va parse qilish Global xatolarni ushlash, avtomatik refresh, redirect

[!TIP] Agar sizga ma'lumotlar strukturasini (kalitlar nomini yoki sanalar formatini) o'zgartirish kerak bo'lsa, transformResponse eng to'g'ri joy. Agar sizga 401 Unauthorized bo'lganda tokenni yangilash yoki xatoni toast xabarida ko'rsatish kerak bo'lsa, Response Interceptor ishlatiladi.


Xulosa

Axios'ning transformResponse imkoniyati frontend va backend jamoalari o'rtasidagi kelishuvlarni osonlashtiradi. Backend dasturchilar o'zlarining snake_case standartlaridan voz kechmagan holda, frontend dasturchilar TypeScript'ning camelCase konvensiyalariga to'liq rioya qilgan holda toza va sifatli kod yozish imkoniyatiga ega bo'ladilar.