Route loaders — Route ochilishidan oldin data olish
TanStack Router'da Route loader'lar: ma'lumotlarni renderdan oldin yuklash, abortSignal, parallel data fetching, Route.useLoaderData va React Router bilan taqqos.
40-dars
Route loaders — Route ochilishidan oldin data olish
Tasavvur qiling, siz nufuzli restoranga tantanali kechki ovqatga bordingiz.
Eski an'anaviy yondashuvda (Fetch-on-render / useEffect) siz bo‘sh xonaga kirasiz, stol yo‘q — sizga stol olib kelinadi (loading spinner), so‘ngra menyu olib kelinadi (ikkinchi spinner), buyurtma berasiz va taom kelishini intiqib kutib o‘tirasiz (uchinchi spinner). Ekranda elementlar ketma-ket sakrab miltillaydi (layout shift).
Route Loader esa "Oldindan bron qilingan dasturxon" kabi ishlaydi: siz zalga kirishingizdan (sahifa ekranga chiqishidan) oldin oshpazlar barcha taomlar, salatlar va ichimliklarni stolda tayyorlab qo‘yishadi. Sahifa ochilgan ondayoq foydalanuvchi to‘laqonli ma'lumotga ega bo‘ladi.
1. Loader qanday ishlaydi?
createFileRoute yordamida yaratilgan har qanday route konfiguratsiyasiga loader asinxron funksiyasini biriktirish mumkin. Bu funksiya sahifa komponenti render bo‘lishidan oldin serverdan yoki keshdan kerakli ma'lumotlarni yuklab oladi:
// src/routes/posts/$postId.tsx
import { createFileRoute } from '@tanstack/react-router'
interface Post {
id: string
title: string
content: string
author: string
}
export const Route = createFileRoute('/posts/$postId')({
// 1. Route ochilishidan oldin ma'lumotni yuklaymiz
loader: async ({ params, abortSignal }) => {
// params.postId avtomatik tarzda tiplangan
const response = await fetch(`https://api.example.com/posts/${params.postId}`, {
signal: abortSignal, // Foydalanuvchi sahifadan chiqib ketsa, so'rov to'xtatiladi
})
if (!response.ok) {
throw new Error('Maqola topilmadi')
}
const post: Post = await response.json()
return post // Qaytarilgan qiymat to'g'ridan-to'g'ri komponentga uzatiladi
},
component: PostDetailPage,
})
function PostDetailPage() {
// 2. Route.useLoaderData orqali tiplangan ma'lumotni o'qiymiz
const post = Route.useLoaderData()
return (
<article className="post-detail">
<h1>{post.title}</h1>
<p className="author">Muallif: {post.author}</p>
<div className="content">{post.content}</div>
</article>
)
}
[!NOTE]
Route.useLoaderData()hech qanday qo‘shimchaPostturini kasting qilishni (as Post) talab qilmaydi. TypeScriptloadernima qaytargan bo‘lsa, uni 100% aniqlik bilan avtomatik taniydi.
2. Loader argumentlari: Har tomonlama qurollangan funksiya
loader funksiyasi o‘z argumentida routing tizimining barcha muhim vositalarini jamlagan obyektni qabul qiladi:
loader: async ({ params, search, context, abortSignal }) => {
// 1. params: URL segmentlari ($postId, $userId)
console.log(params.postId)
// 2. search: Zod orqali validatsiyalangan query parametrlar (?tab=comments)
console.log(search.tab)
// 3. context: Root va Parent routelardan meros bo'lgan obyektlar
console.log(context.queryClient, context.auth.user)
// 4. abortSignal: Brauzer so'rovini bekor qiluvchi signal
return fetch(`/api/data`, { signal: abortSignal })
}
abortSignalning muhim roli:
Agar foydalanuvchi sekin ishlayotgan sahifaga kirsa va ma'lumot to‘liq kelmasidanoq boshqa sahifaga o‘tib ketsa, TanStack Router abortSignal orqali eski tarmoq so‘rovini darhol bekor qiladi. Bu server va foydalanuvchi trafigini ortiqcha yuklanishdan asraydi.
3. Parallel Yuklash (No Waterfalls)
An'anaviy React ilovalarida eng katta og‘riqli nuqtalardan biri — bu Network Waterfalls (Zinasimon so‘rovlar). Ota komponent ma'lumotni yuklab bo‘lmaguncha bola komponent render bo‘lmaydi va o‘z ma'lumotini yuklashni boshlay olmaydi.
TanStack Router esa URL o‘zgargan zahoti barcha mos keluvchi ota va bola routelarning loaderlarini bir vaqtning o‘zida parallel ishga tushiradi:
flowchart TD
subgraph Bad["Eski Usul (Sequential Waterfalls)"]
direction TB
WRoot["Ota Route yuklanadi (500ms)"] --> WChild["Bola Route yuklanadi (500ms)"] --> WDone["Jami: 1000ms kutish"]
end
subgraph Good["TanStack Router (Parallel Loaders)"]
direction TB
URL["Navigatsiya: /posts/42/comments"]
URL --> PLoader1["Ota Loader: Post ma'lumotlari (500ms)"]
URL --> PLoader2["Bola Loader: Izohlar ro'yxati (500ms)"]
PLoader1 & PLoader2 --> PDone["Jami: 500ms (Bir vaqtda!)"]
end
4. TanStack Query bilan birgalikda ishlash
Haqiqiy yirik loyihalarda loader ichida oddiy fetch o‘rniga ko‘pincha TanStack Query keshidan foydalaniladi:
// src/routes/posts/$postId.tsx
import { createFileRoute } from '@tanstack/react-router'
import { postQueryOptions } from '../queries/posts'
export const Route = createFileRoute('/posts/$postId')({
loader: async ({ params, context }) => {
// context.queryClient orqali ma'lumot keshda bormi-yo'qligini tekshiramiz
return context.queryClient.ensureQueryData(
postQueryOptions(params.postId)
)
},
component: PostDetailPage,
})
Bu usul orqali:
- Agar ma'lumot keshda bo‘lsa — sahifa bir zumda (0 ms) ochiladi.
- Agar keshda bo‘lmasa — serverdan yuklanadi va keshga saqlanadi.
5. React Router va TanStack Router Loader taqqosi
| Xususiyat | React Router (loader) |
TanStack Router (loader) |
|---|---|---|
| Type Inference | ⚠️ Cheklangan (useLoaderData() as MyType) |
✅ To‘liq avtomatik inference (Route.useLoaderData()) |
| Search (Query) Params | Qo‘lda new URL(request.url) qilish kerak |
✅ Zod tomonidan validatsiyalangan search tayyor keladi |
| Dependency Injection | ❌ Yo‘q (Global importlar kerak) | ✅ context orqali queryClient va auth yetkaziladi |
| Avtomatik AbortSignal | request.signal orqali |
abortSignal sifatida to‘g‘ridan-to‘g‘ri beriladi |
| Parallel Yuklash | Mavjud | Mukammal optimallashtirilgan parallel arxitektura |
Xulosa
- Route Loader — sahifa komponenti render bo‘lishidan oldin ma'lumotlarni asinxron yuklash uchun mas'ul bo‘lgan asosiy vosita.
- Loader ichida
params, validatsiyalangansearch, ierarxikcontextva tarmoqni to‘xtatuvchiabortSignalmavjud. - TanStack Router ota va bola marshrutlarning barcha loaderlarini parallel ravishda bir vaqtda ishga tushirib, tarmoq zinasini (waterfall) yo‘qotadi.
Route.useLoaderData()yordamida yuklangan ma'lumotlarni hech qanday xavfli type casting'larsiz xavfsiz o‘qish mumkin.