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:
- Reysni aniqlash (Matching): Tabloda chiptangiz qaysi terminal va darvozaga (Gate) tegishli ekani tekshiriladi;
- Pasport nazorati (beforeLoad): Viza va ruxsatnomangiz bormi? Ruxsat bo‘lmasa, siz darhol qaytarib yuborilasiz (redirect);
- Bagajni yuklash va kutish (Loader & Pending): Samolyotga yuklar ortiladi, texnik ko‘rik tugaguncha kutish zalida kutiladi (Pending / Spinner);
- 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,
matchesmassivi 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‘ziningbeforeLoadfunksiyasiga 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
loaderfunksiyalari 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
pendingholatiga o‘tadi; - Sahifada
pendingComponent(Skeleton yoki Spinner) ko‘rsatiladi; useRouterStateorqali ekranning tepasida ingichka Global Progress Bar harakatlanadi;- Miltillashdan himoya (Flicker prevention): TanStack Router’dagi
defaultPendingMs: 150sozlamasi 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.
Matchingmanzilni aniqlaydi,beforeLoadxavfsizlikni tekshiradi,loaderma'lumotlarni parallel yuklaydi,pendingComponentkutish jarayonini boshqaradi va nihoyatcomponentsahifani ekranga chizadi.- Ushbu qat'iy zanjir ilovaning barqaror ishlashini va foydalanuvchi uchun ajoyib tajribani (UX) kafolatlaydi.