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).methodvaurl— 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.