Series: Axios Lesson 61

toJSON() — Axios error ma'lumotlarini serialize qilish

AxiosError ichidagi toJSON() metodi: circular references muammosi, xatoni toza JSON obyektiga serialize qilish, log yuritish va Sentry/Analytics tizimlariga yuborish.

61-dars

toJSON() — Axios error ma'lumotlarini serialize qilish

Dasturlashda yuzaga kelgan xatolarni konsolga chiqarish oson (console.error(error)), lekin ularni tarmoq orqali monitoring serveriga jo'natish, LocalStorage'da saqlash yoki faylga yozish talab etilganda jiddiy muammo yuzaga keladi: standart JavaScript Error va AxiosError obyektlari JSON.stringify() yordamida to'g'ridan-to'g'ri to'liq serialize bo'lmaydi.


1. Nima uchun oddiy JSON.stringify(error) ishlamaydi?

AxiosError — bu oddiy JSON ma'lumotlar to'plami emas. U o'z ichiga brauzer tarmoq sathi (XMLHttpRequest), hodisalar tinglovchilari va o'zaro bog'langan doiraviy havolalarni (circular references) oladi (masalan, error.request, error.response.config va hokazo).

Agar siz AxiosError obyektini to'g'ridan-to'g'ri JSON.stringify qilib ko'rsangiz:

try {
  await apiClient.get('/data');
} catch (error) {
  // ⚠️ Natija shunchaki bo'sh "{}" yoki 
  // "TypeError: Converting circular structure to JSON" xatoligi bo'ladi!
  console.log(JSON.stringify(error)); 
}

Buning sababi — standart JavaScript JSON.stringify funksiyasi aylanma (circular) obyektlarni va meros olingan xossalarni xavfsizlik va xotira sababli o'tkazib yuboradi yoki xatolik bilan qulaydi.


2. Axios Error'ning toJSON() metodi

Axios jamoasi bu muammoni hal qilish uchun har bir AxiosError obyektiga maxsus .toJSON() metodini kiritgan.

Bu metod chaqirilganda, u barcha murakkab va aylanma (circular) qismlarni tozalab, faqat eng muhim va xavfsiz ma'lumotlarni o'z ichiga olgan oddiy toza JavaScript obyektini (Plain JavaScript Object) qaytaradi:

Qaytariladigan toza obyekt quyidagi asosiy maydonlardan iborat bo'ladi:

  • message — Xatolik matni.
  • name — Xato nomi (masalan, "AxiosError").
  • code — Xatolik kodi (masalan, "ERR_BAD_REQUEST", "ECONNABORTED").
  • status — HTTP status kodi (masalan, 404, 500).
  • method va url — Xatolik yuz bergan so'rov metod va manzili.
  • stack — Qo'ng'iroqlar stegi (Call stack).

3. Amaliy misol: Xatolarni log qilish va serverga jo'natish

.toJSON() metodidan foydalanib xatolarni qanday qilib xavfsiz serialize qilish va monitoring serveriga uzatish:

import axios, { AxiosError } from 'axios';

export const logErrorToAnalytics = async (error: unknown) => {
  if (axios.isAxiosError(error)) {
    
    // 1. .toJSON() metodi yordamida xatoni toza obyektga aylantiramiz
    const errorDetails = error.toJSON();
    
    /* 
      errorDetails quyidagi ko'rinishdagi toza obyekt bo'ladi:
      {
        message: "Request failed with status code 400",
        name: "AxiosError",
        code: "ERR_BAD_REQUEST",
        status: 400,
        method: "post",
        url: "/users"
      }
    */

    // 2. Endi buni xavfsiz tarzda JSON string ko'rinishida log qilish mumkin
    console.log('Serialized Error JSON:', JSON.stringify(errorDetails, null, 2));

    try {
      // 3. Masalan, xatoliklar hisobotini monitoring tizimiga yuborish:
      await axios.post('https://analytics.mysite.com/logs', {
        error: errorDetails,
        timestamp: new Date().toISOString(),
        userAgent: navigator.userAgent,
      });
    } catch (loggingError) {
      console.error('Log yuborishda ham xatolik chiqdi:', loggingError);
    }
  }
};

4. TypeScript muhitida toJSON() dan foydalanish

TypeScript AxiosError interfeysida .toJSON() metodi mavjudligini yaxshi taniydi. Metod odatda quyidagi strukturadagi obyektni qaytaradi:

// toJSON() natijasining ichki tuzilishi:
interface AxiosErrorJsonObject {
  message: string;
  name: string;
  code?: string;
  status?: number;
  method?: string;
  url?: string;
  stack?: string;
}

Shuning uchun siz error.toJSON() deb yozganingizda TypeScript hech qanday qizil xatolik ko'rsatmaydi va olingan obyektning barcha maydonlariga to'liq autocomplete bilan murojaat qilish imkonini beradi.


5. JSON.stringify(error) vs error.toJSON() taqqoslovi

Mezon To'g'ridan-to'g'ri JSON.stringify(error) error.toJSON() orqali
Natija Bo'sh {} yoki TypeError: circular structure To'liq va toza xatolik ma'lumotlari obyekti
Aylanma bog'lanishlar (Circular) Xatolikka sabab bo'ladi Avtomatik tozalab tashlanadi
Foydalanish qulayligi Xavfli, qo'shimcha parser talab etiladi Xavfsiz, to'g'ridan-to'g'ri JSON.stringify qilinadi
Tavsiya etilgan joy Ishlatmaslik kerak Sentry, Datadog, Analytics va faylga yozish

Xulosa

AxiosError ichidagi .toJSON() metodi — xatoliklarni xavfsiz serializatsiya qilishning rasmiy va eng qulay yechimidir. U tarmoq va circular elementlarni bartaraf etib, xatolarni tahlil qilish, saqlash yoki monitoring xizmatlariga uzatishni sodda va ishonchli qiladi.