errorComponent — Route xatolarini ko‘rsatish
TanStack Router'da errorComponent: turli xatoliklarni (403, 500, Tarmoq) ajratish va mos UI ko'rsatish, maxsus ApiError sinflari, reset() mexanizmi va React Router bilan taqqos.
52-dars
errorComponent — Route xatolarini ko‘rsatish
Haqiqiy real loyihalarda xatoliklar bir xil bo‘lmaydi. Ular butunlay boshqa-boshqa sabablar bilan yuzaga keladi:
- Tarmoq uzilishi (Network Error): Foydalanuvchida internet o‘chib qolishi.
- Ruxsat yo‘qligi (403 Forbidden): Foydalanuvchida ushbu bo‘limni ko‘rish huquqi yo‘qligi.
- Server nosozligi (500 Server Error): Backend ma'lumotlar bazasida nosozlik yuz berishi.
Agar barcha holatlarda shunchaki umumiy "Xatolik yuz berdi" deb ko‘rsatilsa, foydalanuvchi nima qilishni bilmay qoladi. TanStack Router’dagi errorComponent yuzaga kelgan xatolik turiga qarab foydalanuvchiga eng to‘g‘ri va qulay interfeysni taqdim etish imkonini beradi.
1. Hayotiy o‘xshatish: Avtomobilning aqlli asboblar paneli
Tasavvur qiling, siz zamonaviy avtomobil haydayapsiz. Mashinada nosozlik yuz berganda asboblar paneli shunchaki "Mashina buzildi!" deb to‘xtab qolmaydi:
- Agar benzin tugayotgan bo‘lsa — sariq yoqilg‘i belgisi ⛽ yonadi va yaqin oradagi zapravkani ko‘rsatadi.
- Agar eshik ochiq qolgan bo‘lsa — qaysi eshik ochiqligi ko‘rsatiladi.
- Agar dvigatelda jiddiy nosozlik bo‘lsa — qizil "Check Engine" chiqadi va servisga murojaat qilish tavsiya etiladi.
errorComponent aynan shu aqlli diagnostika paneli kabi ishlaydi: u xatolik sababini tahlil qiladi va foydalanuvchiga yechim taklif qiladi (qaytadan urinish, login qilish yoki administratorga murojaat qilish).
2. Maxsus ApiError sinfi va xatoliklarni ajratish
Xatoliklarni turlarga ajratish uchun maxsus xatolik sinfidan (Custom Error Class) foydalanish eng toza arxitektura hisoblanadi:
// src/utils/errors.ts
export class ApiError extends Error {
constructor(
public status: number,
message: string,
public code?: string
) {
super(message)
this.name = 'ApiError'
}
}
Endi sahifa marshrutida ushbu xatoliklarni qaytarish va errorComponentda ularni tahlil qilishni ko‘rib chiqamiz:
// src/routes/dashboard/analytics.tsx
import { createFileRoute, Link } from '@tanstack/react-router'
import { ApiError } from '../../utils/errors'
export const Route = createFileRoute('/dashboard/analytics')({
loader: async ({ abortSignal }) => {
const res = await fetch('https://api.example.com/analytics', { signal: abortSignal })
if (res.status === 403) {
throw new ApiError(403, 'Sizda ushbu analitikani ko‘rish ruxsati yo‘q', 'FORBIDDEN')
}
if (res.status >= 500) {
throw new ApiError(500, 'Serverda ichki nosozlik yuz berdi', 'SERVER_ERROR')
}
if (!res.ok) {
throw new ApiError(res.status, 'Ma’lumotlarni yuklab bo‘lmadi', 'NETWORK_ERROR')
}
return res.json()
},
// 1. Xatolik turiga qarab mos interfeys ko'rsatamiz:
errorComponent: ({ error, reset }) => {
// Agar xatolik ApiError bo'lsa, uning status kodini tekshiramiz
if (error instanceof ApiError) {
if (error.status === 403) {
return (
<div className="error-box forbidden">
<div className="icon">🔒</div>
<h2>Ruxsat etilmagan hudud</h2>
<p>{error.message}</p>
<Link to="/dashboard" className="btn-back">
Boshqaruv paneliga qaytish
</Link>
</div>
)
}
if (error.status >= 500) {
return (
<div className="error-box server-error">
<div className="icon">🛠️</div>
<h2>Serverda texnik ishlar</h2>
<p>Muammo biz tomonda. Iltimos, bir necha daqiqadan so'ng qayta urinib ko'ring.</p>
<button onClick={() => reset()} className="btn-retry">
Qaytadan yuklash
</button>
</div>
)
}
}
// Boshqa standart tarmoq yoki kutilmagan xatoliklar uchun umumiy UI:
return (
<div className="error-box fallback">
<div className="icon">⚠️</div>
<h2>Aloqa uzildi</h2>
<p>Internet aloqangizni tekshiring va qayta urinib ko‘ring.</p>
<button onClick={() => reset()} className="btn-retry">
Qayta urinish
</button>
</div>
)
},
component: AnalyticsPage,
})
function AnalyticsPage() {
const data = Route.useLoaderData()
return <div>Analitika xulosasi: {data.totalVisitors}</div>
}
3. Xatoliklarni boshqarish qarorlar daraxti (Mermaid Diagram)
flowchart TD
Err["loader() xatolik keltirib chiqardi"] --> Boundary["errorComponent({ error, reset })"]
Boundary --> TypeCheck{"error qaysi turga mansub?"}
TypeCheck -- "status === 403 (Forbidden)" --> UI_403["🔒 Ruxsat yo'q ekrani (Qayta urinish tugmasi yo'q, Orqaga qaytish bor)"]
TypeCheck -- "status >= 500 (Server Error)" --> UI_500["🛠️ Server nosozligi ekrani (reset() tugmasi bilan)"]
TypeCheck -- "Boshqa xatolar / Tarmoq" --> UI_Network["⚠️ Tarmoq xatosi ekrani (reset() tugmasi bilan)"]
UI_500 & UI_Network --> RetryAction["Foydalanuvchi 'Qayta urinish'ni bosadi"]
RetryAction --> ReRun["reset() -> Route loader'i qayta ishga tushadi"]
4. errorComponentning asosiy afzalliklari
+-----------------------------------------------------------------------------------+
| errorComponent AFZALLIKLARI |
+-----------------------------------------------------------------------------------+
| 1. Aniq va To'g'ri Kommunikatsiya: |
| Foydalanuvchi xato nima sababdan bo'lganini (huquq yetishmasligimi yoki |
| internet uzilishimi) aniq tushunadi. |
| |
| 2. Mukammal Izolyatsiya (Fault Isolation): |
| Xatolik faqat ushbu route chegarasida qoladi. Saytning menyusi va boshqa |
| bo'limlari to'laqonli ishlashda davom etadi. |
| |
| 3. Aqlli Qayta Tiklash (Smart Retry): |
| reset() brauzer sahifasini to'liq yangilamasdan, aynan buzilgan loader'ni |
| fonda qayta chaqiradi. |
+-----------------------------------------------------------------------------------+
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router (errorElement) |
TanStack Router (errorComponent) |
|---|---|---|
| Xatolik tahlili | isRouteErrorResponse(error) yordamida ajratish kerak |
JavaScript instanceof yoki error obyekti orqali tabiiy |
| Qayta urinish mexanizmi | Maxsus o‘rnatilgan prop yo‘q (qo‘lda qilish kerak) | Tayyor reset() prop beriladi |
| Keshni boshqarish | Kesh o‘rnatilmagani uchun qayta tiklash noaniq | Keshni avtomatik tozalab, loaderni yangitdan chaqiradi |
| Type Safety | error tipi unknown bo‘lib keladi |
To‘liq tiplangan va TypeScript bilan oson kengaytiriladi |
Xulosa
errorComponent— marshrutda sodir bo‘lgan xatoliklarni ushlab, ularning sababiga qarab moslashtirilgan interfeys ko‘rsatish vositasidir.- Xatoliklarni
ApiErrorkabi maxsus sinflar orqali ajratish (403, 500, Tarmoq) foydalanuvchiga aniq yo‘l-yo‘riq beradi. - Ruxsat etilmagan holatlarda (403) foydalanuvchiga orqaga qaytish taklif qilinsa, tarmoq xatolarida
reset()orqali qayta urinish imkoniyati beriladi. - Bu yondashuv dasturni mustahkam (resilient), xatoliklarga chidamli va professional darajaga olib chiqadi.