Seriya: TanStack Router Dars 51

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:

  1. error: Yuzaga kelgan xatolik obyekti (Error instansiyasi yoki API javobi).
  2. reset: Xatolik holatini tozalab, route'ning loader funksiyasini 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 marshrutning loaderini 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["&lt;Outlet /&gt; 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, loader va React rendering bosqichlaridagi barcha xatoliklarni bir joyda boshqaradi.
  • Taqdim etiladigan reset() funksiyasi butun sahifani qayta yangilamasdan, aynan o‘sha nosoz marshrutning loaderini qayta ishga tushirish (retry) imkonini beradi.
  • Xatoliklar faqat o‘zining <Outlet /> sohasi bilan chegaralanadi va butun ilovaning tashqi karkasini (navbar, sidebar) buzmaydi.