Seriya: TanStack Router Dars 35

Route lifecycle — Matching, preload, loading va rendering ketma-ketligi

TanStack Router'da navigatsiya hayot sikli (Lifecycle): Matching, beforeLoad, parallel loaderlar, pending holati va render bosqichlarining qat'iy ketma-ketligi.

35-dars

Route lifecycle — Matching, preload, loading va rendering ketma-ketligi

Tasavvur qiling, siz xalqaro aeroportdan xorijga uchmoqchisiz. Siz to‘g‘ridan-to‘g‘ri uchish-qo‘nish yo‘lagiga yugurib borib samolyotga o‘tira olmaysiz. Jarayon qat'iy 4 ta bosqichdan iborat hayot sikliga (Lifecycle) bo‘ysunadi:

  1. Reysni aniqlash (Matching): Tabloda chiptangiz qaysi terminal va darvozaga (Gate) tegishli ekani tekshiriladi;
  2. Pasport nazorati (beforeLoad): Viza va ruxsatnomangiz bormi? Ruxsat bo‘lmasa, siz darhol qaytarib yuborilasiz (redirect);
  3. Bagajni yuklash va kutish (Loader & Pending): Samolyotga yuklar ortiladi, texnik ko‘rik tugaguncha kutish zalida kutiladi (Pending / Spinner);
  4. Parvozning boshlanishi (Render): Barcha tayyorgarlik tugagach, samolyot havoga ko‘tariladi va siz o‘z o‘rindig‘ingizga o‘tirasiz (Sahifa render bo‘ladi).

Foydalanuvchi biror havolani bosganida, TanStack Router aynan mana shu qat'iy Route Lifecycle (Marshrut Hayot Sikli) bo‘yicha harakat qiladi.


1. Hayot siklining 4 ta asosiy bosqichi

sequenceDiagram
    autonumber
    actor User as Foydalanuvchi
    participant Router as TanStack Router
    participant Guard as beforeLoad (Himoya)
    participant Loader as loader (Ma'lumotlar)
    participant UI as Komponent (Render)

    User->>Router: Havola bosildi (/dashboard/analytics)
    Router->>Router: 1. Matching: Route Tree bo'ylab moslik qidiriladi
    Router->>Guard: 2. beforeLoad: Ruxsatlar va Auth tekshiriladi
    alt Ruxsat berilmasa
        Guard-->>User: throw redirect({ to: '/login' })
    else Ruxsat berilsa
        Guard->>Loader: 3. loader() parallel ravishda ishga tushadi
        Note over Router,UI: Ma'lumot kutilayotganda pendingComponent ko'rsatiladi
        Loader-->>Router: Ma'lumotlar tayyor bo'ldi
        Router->>UI: 4. Sahifa va Outlet to'liq render qilinadi!
    end

1-bosqich: Matching (Moslashtirish)

Foydalanuvchi tugmani bosgan onda router URL manzilini tahlil qiladi va Route Tree bo‘ylab qaysi ota va bola marshrutlar ishga tushishini aniqlaydi.

  • Barcha mos keluvchi marshrutlar aniqlanib, matches massivi shakllantiriladi;
  • Agar URL manzil loyihada umuman mavjud bo‘lmasa, jarayon shu yerdayoq to‘xtatilib, Catch-all (404 Not Found) sahifasi ochiladi.

2-bosqich: Preload & beforeLoad (Oldindan yuklash va Himoya)

Sahifa komponenti ekranga chizilishidan oldin uning xavfsizligi va ruxsatnomalari tekshiriladi:

  • beforeLoad: Har bir route o‘zining beforeLoad funksiyasiga ega bo‘lishi mumkin. Bu yerda foydalanuvchi tizimga kirganmi (auth), admin huquqi bormi deb tekshiriladi. Agar shart bajarilmasa, komponent yuklanib o‘tirmasdan darhol boshqa sahifaga yo‘naltiriladi:
    beforeLoad: ({ context }) => {
      if (!context.auth.isLoggedIn) {
        throw redirect({ to: '/login' })
      }
    }
    
  • Parallel Loader: Agar xavfsizlik tekshiruvidan muvaffaqiyatli o‘tilsa, ota va bola routelarning barcha loader funksiyalari bir vaqtning o‘zida parallel ravishda serverdan ma'lumotlarni tortishni boshlaydi.

3-bosqich: Loading & Pending (Kutish holati)

Agar serverdan ma'lumotlar kelishi biroz vaqt talab qilsa, ilova qotib qolmasligi lozim.

  • Router avtomatik ravishda pending holatiga o‘tadi;
  • Sahifada pendingComponent (Skeleton yoki Spinner) ko‘rsatiladi;
  • useRouterState orqali ekranning tepasida ingichka Global Progress Bar harakatlanadi;
  • Miltillashdan himoya (Flicker prevention): TanStack Router’dagi defaultPendingMs: 150 sozlamasi tufayli, agar so‘rov 150 millisekunddan tez javob bersa, ortiqcha yuklanish animatsiyasi umuman ko‘rsatilmaydi, sahifa silliq ochiladi.

4-bosqich: Rendering (Chiqarish va Ko'rsatish)

Barcha ma'lumotlar to‘liq kelib tushgach, so‘nggi yakuniy bosqich boshlanadi:

  • Ota layoutdagi <Outlet /> va bola sahifa komponentlari birgalikda DOM'ga chiziladi;
  • Loader ma'lumotlari Route.useLoaderData() orqali komponentga topshiriladi;
  • Foydalanuvchi to‘liq tayyor, ma'lumotlarga to‘la go‘zal sahifani ko‘radi.

2. To'liq hayot siklini birlashtirgan kod namunasi

// src/routes/dashboard/analytics.tsx
import { createFileRoute, redirect } from '@tanstack/react-router'

export const Route = createFileRoute('/dashboard/analytics')({
  // 1. HIMOYALASH (beforeLoad)
  beforeLoad: async ({ context }) => {
    const user = (context as any)?.auth?.user
    if (!user || user.role !== 'ADMIN') {
      // Ruxsat yo'q bo'lsa darhol yo'naltiramiz
      throw redirect({ to: '/dashboard' })
    }
  },

  // 2. MA'LUMOT YUKLASH (loader)
  loader: async () => {
    const res = await fetch('https://api.example.com/analytics')
    return (await res.json()) as { visits: number; revenue: number }
  },

  // 3. KUTISH HOLATI (pendingComponent)
  pendingComponent: () => (
    <div style={{ padding: '2rem', color: '#64748b' }}>
      Analitika ma'lumotlari yuklanmoqda...
    </div>
  ),

  // 4. ASOSIY SAHIFA (component)
  component: AnalyticsPageComponent,

  // XATOLIKLAR BILAN ISHLASH (errorComponent)
  errorComponent: ({ error }) => (
    <div style={{ color: 'red', padding: '2rem' }}>
      Xatolik yuz berdi: {error.message}
    </div>
  ),
})

function AnalyticsPageComponent() {
  const data = Route.useLoaderData()

  return (
    <div style={{ padding: '2rem' }}>
      <h1>Analitika Paneli</h1>
      <p>Tashriflar: {data.visits}</p>
      <p>Daromad: ${data.revenue}</p>
    </div>
  )
}

3. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router (Lifecycle)
Bosqichlar ketma-ketligi Birmuncha erkin va tarqoq Qat'iy: Matching $\to$ beforeLoad $\to$ Loader $\to$ Render
Himoyalash (Route Guards) Komponent ichida useEffect yoki loaderda redirect beforeLoad orqali komponentga kirmasdan to‘xtatiladi
Yuklanishni parallel qilish Qo‘shimcha optimizatsiya talab qiladi Barcha ota-bola loaderlar doimo 100% parallel
Pending UI miltillashidan himoya Qo‘lda taymerlar yozish kerak defaultPendingMs o‘rnatilgan tayyor mexanizm

Xulosa

  • Route Lifecycle — har bir navigatsiya jarayonining bosqichma-bosqich bajarilish zanjiridir.
  • Matching manzilni aniqlaydi, beforeLoad xavfsizlikni tekshiradi, loader ma'lumotlarni parallel yuklaydi, pendingComponent kutish jarayonini boshqaradi va nihoyat component sahifani ekranga chizadi.
  • Ushbu qat'iy zanjir ilovaning barqaror ishlashini va foydalanuvchi uchun ajoyib tajribani (UX) kafolatlaydi.