Series: TanStack Router Lesson 40

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‘shimcha Post turini kasting qilishni (as Post) talab qilmaydi. TypeScript loader nima 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:

  1. Agar ma'lumot keshda bo‘lsa — sahifa bir zumda (0 ms) ochiladi.
  2. 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, validatsiyalangan search, ierarxik context va tarmoqni to‘xtatuvchi abortSignal mavjud.
  • 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.