Seriya: TanStack Router Dars 44

Route.useLoaderData — Loader natijasini komponentda ishlatish

TanStack Router'da Route.useLoaderData: to'liq Type Inference, type casting'siz ishlash, ichki komponentlarda ma'lumot olish va React Router bilan taqqos.

44-dars

Route.useLoaderData — Loader natijasini komponentda ishlatish

Tasavvur qiling, siz bankning maxsus xizmat ko‘rsatish bo‘limidasiz. Kassir xodim (React Komponent) mijozga kredit yoki maxsus hujjatlarni topshirishi kerak.

Eski noqulay usulda kassir o‘rnidan turib, omborga borib, ma'lumot keldimi-yo‘qmi deb qarab, "hali kelmadi" degan yozuv bilan mijozni kuttirib qo‘yar edi (if (!data) return <Spinner />).

Route.useLoaderData arxitekturasida esa bankning ichki ekspertiza guruhi (Loader) mijoz kassir yoniga chaqirilishidan oldinroq barcha tekshiruvlarni yakunlaydi, hujjatlarni rasmiylashtiradi va kassirning stoliga muhrlangan tayyor papkani qo‘yadi. Kassir shubhasiz va ortiqcha kutishlarsiz to‘g‘ridan-to‘g‘ri ma'lumot bilan ishlay boshlaydi.


1. Route.useLoaderData qanday ishlaydi?

React Router yoki boshqa an'anaviy kutubxonalarda global useLoaderData() hook'i ishlatilganda, TypeScript uning ichida aynan nima borligini bilmaydi (turini any yoki unknown deb belgilaydi). Dasturchi esa uni majburan kasting qilishga (as UserProfile) majbur bo‘ladi.

TanStack Router’da esa Route.useLoaderData har bir route instansiyasiga qattiq bog‘langan bo‘lib, loader funksiyasining qaytargan qiymatiga qarab o‘z turini 100% avtomatik aniqlaydi:

// src/routes/users/$userId.tsx
import { createFileRoute } from '@tanstack/react-router'

// 1. Foydalanuvchi profili modeli
interface UserProfile {
  id: string
  name: string
  email: string
  role: 'admin' | 'moderator' | 'user'
  avatarUrl: string
}

export const Route = createFileRoute('/users/$userId')({
  // 2. Loader funksiyasi UserProfile turidagi ma'lumotni yuklaydi
  loader: async ({ params, abortSignal }): Promise<UserProfile> => {
    const res = await fetch(`https://api.example.com/users/${params.userId}`, {
      signal: abortSignal,
    })

    if (!res.ok) {
      throw new Error('Foydalanuvchi topilmadi')
    }

    return res.json()
  },

  component: UserProfilePage,
})

function UserProfilePage() {
  // 3. Route.useLoaderData orqali ma'lumotni olamiz
  // TypeScript 'user' ning turi UserProfile ekanini aniq biladi!
  const user = Route.useLoaderData()

  return (
    <div className="profile-container">
      <img src={user.avatarUrl} alt={user.name} className="avatar" />
      <h1>{user.name}</h1>
      <p>Email: {user.email}</p>
      <span className={`badge badge-${user.role}`}>
        Roli: {user.role.toUpperCase()}
      </span>
    </div>
  )
}

[!NOTE] E'tibor bering: komponent ichida if (!user) return <Loading /> deb yozish umuman shart emas! Chunki TanStack Router loader muvaffaqiyatli yakunlanmaguncha komponentni render qilmaydi. user hech qachon undefined yoki null bo‘lmaydi.


2. Ma'lumotning Loader'dan Komponentga oqimi (Mermaid Diagram)

flowchart TD
    URL["URL: /users/42"] --> Loader["Route loader() serverdan ma'lumotni olib keladi"]
    
    subgraph Guarantee["Kafolatlangan ma'lumot"]
        Loader --> Check{"Ma'lumot to'liq keldimi?"}
        Check -- "HA (Promise Resolved)" --> Ready["UserProfile obyekti tayyor"]
        Check -- "YO'Q (Error)" --> Catch["errorComponent ishga tushadi"]
    end

    Ready --> Hook["Route.useLoaderData()"]
    Hook --> Comp["UserProfilePage render bo'ladi (100% Type-Safe)"]

3. Ichki bola komponentlarda ma'lumot olish (No Prop Drilling)

Agar sizda bitta sahifaning ichida chuqur joylashgan kichik komponentlar bo‘lsa, loader ma'lumotlarini barcha bolalarga prop orqali qavatma-qavat uzatish shart emas.

Istalgan bola komponent o‘sha Route instansiyasining o‘zidan to‘g‘ridan-to‘g‘ri ma'lumotni o‘qiy oladi:

// Shu fayl ichidagi yoki alohida eksport qilingan kichik komponent
function UserRoleBadge() {
  // Ota sahifadagi Route'dan ma'lumotni props'siz to'g'ridan-to'g'ri olamiz:
  const user = Route.useLoaderData()

  return <div className="role-tag">{user.role}</div>
}

Agar komponent butunlay boshqa faylda bo‘lsa, TanStack Router’ning global useLoaderData({ from: '/users/$userId' }) funksiyasi yordamida from xossasini ko‘rsatish orqali ham to‘liq tiplangan ma'lumotni olish mumkin!


4. Route.useLoaderData ning asosiy afzalliklari

+-----------------------------------------------------------------------------------+
|                        Route.useLoaderData AVZALLIKLARI                           |
+-----------------------------------------------------------------------------------+
| 1. Nol Type Casting (Zero Casting):                                               |
|    Hech qanday `as UserProfile` yoki qo'lda generic berish talab etilmaydi.       |
|                                                                                   |
| 2. Avtomatik Refaktoring Himoyasi:                                                |
|    Loader qaytargan ma'lumot turi o'zgarsa, komponentdagi barcha xatolar          |
|    darhol qizil bo'lib ko'rinadi.                                                 |
|                                                                                   |
| 3. Miltillash va Sakrashlar Yo'qligi (No Layout Shifts):                          |
|    Bo'sh loader spinnerlari o'rniga bir zumda tayyor UI chiziladi.                |
|                                                                                   |
| 4. Prop Drilling'ga Hojat Yo'q:                                                   |
|    Ixtiyoriy ichki komponentlar ma'lumotni mustaqil o'qiy oladi.                  |
+-----------------------------------------------------------------------------------+

5. React Router va TanStack Router taqqosi

Xususiyat React Router (useLoaderData) TanStack Router (Route.useLoaderData)
Qaytarish turi (Type) unknown yoki any Loader return turiga 100% mos keladi
Type xavfsizligi useLoaderData() as MyType (xavfli) Kasting talab qilinmaydi (Zero casting)
Route'ga bog'liqlik Butun ilova uchun yagona umumiy hook Har bir route o‘zining mustaqil Route.useLoaderData()siga ega
Boshqa komponentdan olish Faqat useRouteLoaderData(id) (tiplanmagan) useLoaderData({ from: '/route/path' }) (to‘liq tiplangan)
Yuklanish kafolati Komponentda data?.prop deb tekshirish kerak Ma'lumot doimo mavjudligi kafolatlangan

Xulosa

  • Route.useLoaderData — marshrut komponentiga loader funksiyasi qaytargan ma'lumotlarni uzatuvchi qat'iy tiplangan hook.
  • U qo‘lda type casting qilish ehtiyojini yo‘qotadi va dastur kodini toza, xavfsiz saqlaydi.
  • Loader muvaffaqiyatli tugagandan keyingina sahifa ochilgani sababli, komponent ichida ortiqcha if (!data) tekshiruvlari talab qilinmaydi.
  • Sahifaning ixtiyoriy ichki komponentlari ham Route.useLoaderData() orqali prop drilling'siz to‘g‘ridan-to‘g‘ri ma'lumotdan foydalana oladi.