Error handling — Route-level error boundary
TanStack Router'da errorComponent: beforeLoad, loader va rendering xatolarini ushlash, reset() orqali qayta urinish (retry), xatoliklar izolyatsiyasi va React Router bilan taqqos.
51-dars
Error handling — Route-level error boundary
Veb-ishlab chiqishda eng qo‘rqinchli holat — bitta kichik sahifadagi xatolik tufayli butun ilovaning qulashi va foydalanuvchi oldida "Oq ekran" (White Screen of Death) paydo bo‘lishidir.
TanStack Router’da xatoliklar nafaqat React komponentining render bosqichida, balki ma'lumot yuklanishidan oldingi beforeLoad yoki loader asinxron jarayonlarida ham yuz berishi mumkin. errorComponent ana shu barcha bosqichlardagi nosozliklarni o‘z doirasida ushlab qolib, butun ilovani himoya qiladi (Error Boundary).
1. Hayotiy o‘xshatish: Xonadon elektr avtomatlari (Saqlagichlar)
Tasavvur qiling, siz ko‘p xonali zamonaviy xonadondasiz. Har bir xona (oshxona, yotoqxona, mehmonxona) uchun alohida elektr saqlagich (errorComponent) o‘rnatilgan.
Agar oshxonadagi elektr choynakda qisqa tutashuv yuz bersa, faqat oshxonaning avtomati o‘chadi. Butun uyda chiroq o‘chib ketmaydi — mehmonxona televizori, muzlatgich va yoritgichlar bemalol ishlashda davom etadi. Xatolik tuzatilgach, siz oshxona avtomatini qayta ko‘tarasiz (reset()).
TanStack Router aynan shu tamoyilda ishlaydi: bitta ichki bo‘limdagi xatolik ota layout (navigatsiya, sidebar) ishini aslo to‘xtatmaydi!
2. errorComponent qanday ishlaydi?
createFileRoute konfiguratsiyasiga errorComponent qo‘shilganda, u o‘ziga ikkita asosiy argumentni qabul qiladi:
error: Yuzaga kelgan xatolik obyekti (Errorinstansiyasi yoki API javobi).reset: Xatolik holatini tozalab, route'ningloaderfunksiyasini qaytadan ishga tushiruvchi (Retry) kuchli funksiya.
// src/routes/posts/$postId.tsx
import { createFileRoute } from '@tanstack/react-router'
export const Route = createFileRoute('/posts/$postId')({
loader: async ({ params, abortSignal }) => {
const res = await fetch(`https://api.example.com/posts/${params.postId}`, {
signal: abortSignal,
})
if (!res.ok) {
throw new Error('Maqolani yuklashda xatolik yuz berdi yoki u mavjud emas.')
}
return res.json()
},
// 1. Ushbu marshrutda xatolik yuz berganda shu komponent render bo'ladi
errorComponent: ({ error, reset }) => {
return (
<div className="error-card">
<div className="error-icon">⚠️</div>
<h3>Xatolik yuz berdi!</h3>
<p className="error-message">{error.message}</p>
{/* 2. reset() yordamida qaytadan serverga so'rov yuboramiz */}
<button onClick={() => reset()} className="btn-retry">
Qaytadan urinib ko'rish
</button>
</div>
)
},
component: PostDetailPage,
})
function PostDetailPage() {
const post = Route.useLoaderData()
return (
<article>
<h1>{post.title}</h1>
<p>{post.content}</p>
</article>
)
}
[!TIP]
reset()funksiyasi foydalanuvchidan butun brauzer sahifasini qayta yangilashni (window.location.reload()) talab qilmaydi. U faqat buzilgan marshrutningloaderini fonda qayta chaqiradi va muvaffaqiyatli bo‘lsa, silliq ravishda asosiy komponentga qaytadi.
3. Qaysi xatoliklar avtomatik ushlanadi?
Route darajasidagi errorComponent quyidagi 3 ta kritik bosqichdagi barcha xatoliklarni tutib qoladi:
+-----------------------------------------------------------------------------------+
| XATOLIKLARNI USHLASHNING 3 TA BOSQICHI |
+-----------------------------------------------------------------------------------+
| 1. beforeLoad Bosqichi: |
| Avtorizatsiyani tekshirishda yoki tashqi API javobida xatolik chiqsa. |
| |
| 2. loader Bosqichi: |
| Tarmoq uzilishi, backend 500 xatosi yoki noto'g'ri JSON formatida. |
| |
| 3. Component Rendering Bosqichi: |
| React komponenti chizilayotgan paytda kutilmagan JavaScript xatosi bo'lsa. |
+-----------------------------------------------------------------------------------+
4. Xatoliklar izolyatsiyasi (Mermaid Diagram)
flowchart TD
subgraph Parent["Root Layout (Navigatsiya va Sidebar 100% ishlayapti)"]
Nav["Navbar Menyusi"]
Side["Sidebar Bo'limlari"]
subgraph OutletArea["<Outlet /> Maydoni"]
direction TB
LoaderFail["Posts/$postId loader() xatolik berdi (500 Error)"]
LoaderFail --> Boundary["Child errorComponent({ error, reset })"]
Boundary --> Action["Foydalanuvchi: 'Qaytadan urinib ko'rish' tugmasini bosadi"]
Action --> Retry["reset() -> loader qayta ishlaydi"]
end
end
E'tibor bering: butun sahifa qulamaydi. Foydalanuvchi bemalol navbar orqali boshqa sahifalarga o‘tib ketaverishi yoki o‘sha yerning o‘zida "Qaytadan urinish"ni bosishi mumkin.
5. Global Root Error Boundary (__root.tsx)
Agar bola marshrutlarda shaxsiy errorComponent belgilanmagan bo‘lsa, xatolik yuqoriga qarab ko‘tariladi (bubble up). Butun ilovani ushlab turuvchi oxirgi xavfsizlik qalqoni sifatida __root.tsx faylida global errorComponent e'lon qilinadi:
// src/routes/__root.tsx
import { createRootRouteWithContext, Outlet, Link } from '@tanstack/react-router'
export const Route = createRootRouteWithContext<RouterContext>()({
component: () => <Outlet />,
// Global zaxira xatolik ekrani
errorComponent: ({ error, reset }) => (
<div className="global-error-screen">
<h1>Kutilmagan xatolik yuz berdi 🚨</h1>
<p>{error.message}</p>
<div className="actions">
<button onClick={() => reset()}>Qayta urinish</button>
<Link to="/">Bosh sahifaga qaytish</Link>
</div>
</div>
),
})
6. React Router va TanStack Router taqqosi
| Xususiyat | React Router (errorElement) |
TanStack Router (errorComponent) |
|---|---|---|
| Qayta urinish (Retry) | ⚠️ Maxsus hook yo‘q (qo‘lda useRevalidator chaqirish kerak) |
✅ Biriktirilgan reset() funksiyasi tayyor beriladi |
| Xatolik ma'lumotini olish | useRouteError() hook'i orqali alohida chaqiriladi |
Prop sifatida to‘g‘ridan-to‘g‘ri uzatiladi ({ error }) |
beforeLoad xatolarini ushlash |
beforeLoad yo‘q |
beforeLoaddagi barcha nosozliklar to‘liq ushlanadi |
| Global fallback | Qo‘lda root errorElement o‘rnatiladi | defaultErrorComponent orqali butun routerga tatbiq etiladi |
| Izolyatsiya darajasi | Mavjud | Mukammal marshrut darajasidagi izolyatsiya |
Xulosa
errorComponent— marshrutda yuz bergan har qanday xatolikni ushlab qolib, ilovaning qulashini oldini oluvchi Error Boundary vositasidir.- U
beforeLoad,loaderva React rendering bosqichlaridagi barcha xatoliklarni bir joyda boshqaradi. - Taqdim etiladigan
reset()funksiyasi butun sahifani qayta yangilamasdan, aynan o‘sha nosoz marshrutningloaderini qayta ishga tushirish (retry) imkonini beradi. - Xatoliklar faqat o‘zining
<Outlet />sohasi bilan chegaralanadi va butun ilovaning tashqi karkasini (navbar, sidebar) buzmaydi.