Seriya: TanStack Router Dars 41

Loader params — Loader ichida URL parametrlarini olish

TanStack Router'da loader parametrlari: nega hook ishlatib bo'lmasligi, params va search argumentlari, Zod integratsiyasi va React Router bilan taqqos.

41-dars

Loader params — Loader ichida URL parametrlarini olish

React dasturchilari orasida eng ko‘p uchraydigan savollardan biri: "Nega men loader funksiyasi ichida Route.useParams() yoki Route.useSearch() hook'larini chaqira olmayman?"

Buning sababi juda oddiy: React Hook'lari faqat React komponentlari yoki maxsus Custom Hook'lar ichida ishlashi mumkin. loader esa React komponenti emas — u oddiy sof asinxron JavaScript funksiyasi bo‘lib, u komponentlar umuman ekranga chiqmasidan (mount bo‘lmasidan) oldinroq ishga tushadi!

Shuning uchun TanStack Router barcha kerakli URL parametrlarini loader'ga to‘g‘ridan-to‘g‘ri argument obyekti sifatida taqdim etadi.


1. Hayotiy o‘xshatish: Shifokor qabulxonasi

Tasavvur qiling, siz shifoxonaga ko‘rikka bordingiz. Bemor shifokor xonasiga (React Component) kirishidan oldin, qabulxona xodimi shifokorga (Loader) bemorning tibbiy kartasi raqami (params.patientId) va tahlil turini (search.analysisType) solingan tayyor konvertni topshiradi.

Shifokor bemor ichkariga kirib unga o‘z ID'sini aytishini kutib o‘tirmaydi — u oldindan stolida turgan tayyor hujjatlar asosida kompyuterdan bemor tarixini yuklab oladi. Bemor xonaga kirganda barcha tahlil natijalari stolda tayyor turgan bo‘ladi.


2. params va searchni Loader ichida qabul qilish

Har bir loader funksiyasi o‘ziga bitta umumiy obyektni argument sifatida qabul qiladi. Bu obyektdan params, search, context va abortSignalni to‘g‘ridan-to‘g‘ri destrukturizatsiya qilish mumkin:

// src/routes/products/$productId.tsx
import { createFileRoute } from '@tanstack/react-router'
import { z } from 'zod'

// 1. URL search (query) parametrlari uchun Zod sxemasi
const productSearchSchema = z.object({
  tab: z.enum(['overview', 'specs', 'reviews']).default('overview'),
  currency: z.enum(['USD', 'UZS']).default('USD'),
})

export const Route = createFileRoute('/products/$productId')({
  // 2. Query parametrlarni validatsiya qilamiz
  validateSearch: (search) => productSearchSchema.parse(search),

  // 3. Loader ichida params va search tayyor holda keladi
  loader: async ({ params, search, abortSignal }) => {
    // params.productId -> avtomatik ravishda string tipida
    // search.tab -> 'overview' | 'specs' | 'reviews' (to'liq tiplangan!)
    // search.currency -> 'USD' | 'UZS'

    const { productId } = params
    const { tab, currency } = search

    const response = await fetch(
      `https://api.store.com/products/${productId}?tab=${tab}&curr=${currency}`,
      { signal: abortSignal }
    )

    if (!response.ok) {
      throw new Error('Mahsulot topilmadi yoki xatolik yuz berdi')
    }

    return response.json()
  },

  component: ProductDetailPage,
})

function ProductDetailPage() {
  // 4. Komponent ichida yuklangan ma'lumot va parametrlardan foydalanish
  const product = Route.useLoaderData()
  const { productId } = Route.useParams()
  const { tab } = Route.useSearch()

  return (
    <div className="product-page">
      <h1>{product.title}</h1>
      <p>Mahsulot kodi: {productId}</p>
      <p>Faol bo'lim: <strong>{tab}</strong></p>
      <div className="price">Narxi: {product.price}</div>
    </div>
  )
}

3. Parametrlarning Loader'ga yetib borish oqimi (Mermaid Diagram)

flowchart TD
    URL["URL: /products/p-99?tab=specs&currency=USD"] --> Parse["TanStack Router URL Parser"]

    subgraph Extraction["Parametrlarni tayyorlash"]
        Parse --> Segments["Dinamik Segment: params = { productId: 'p-99' }"]
        Parse --> Validate["validateSearch: search = { tab: 'specs', currency: 'USD' }"]
    end

    Segments & Validate --> LoaderArgs["loader({ params, search, context, abortSignal })"]
    
    LoaderArgs --> Fetch["API Fetch: /products/p-99?tab=specs..."]
    Fetch --> Component["Komponent render bo'ladi (useLoaderData)"]

4. Nima uchun bu yondashuv juda kuchli?

+-----------------------------------------------------------------------------------+
|                           LOADER PARAMS AVZALLIKLARI                              |
+-----------------------------------------------------------------------------------+
| 1. Komponentdan oldin yuklash (True Pre-fetching):                                |
|    Komponent hali re-render bo'lmasidan turib barcha parametrlar aniq ma'lum.     |
|                                                                                   |
| 2. Nol qo'lda parse qilish (Zero Manual Parsing):                                 |
|    URL query parametrlar string emas, to'g'ridan-to'g'ri tiplangan JSON obyekt.   |
|                                                                                   |
| 3. TypeScript Autocomplete:                                                       |
|    params. yoki search. deb yozishingiz bilan mavjud barcha maydonlar chiqadi.    |
+-----------------------------------------------------------------------------------+
  1. Oldindan tayyor parametrlar (Zero Delay): loader ishlashni boshlagan paytda URL manzildagi barcha dinamik segmentlar ($productId) va filtrlar (tab=specs) allaqachon parse qilingan va tayyor bo‘ladi.
  2. Kompilyatsiya darajasidagi xavfsizlik: Agar siz fayl nomini $productId.tsx dan $id.tsx ga o‘zgartirsangiz, TypeScript loader ichidagi params.productId xatolik ekanini darhol ko‘rsatadi va xatolarning production'ga chiqib ketishini to‘xtatadi.
  3. Standart qiymatlar (Defaults) avtomatik o‘rnatilgan: Foydalanuvchi URL'da hech qanday ?tab= kiritmagan bo‘lsa ham, validateSearchdagi .default('overview') tufayli search.tab qiymati loader ichida "overview" bo‘lib keladi.

5. React Router va TanStack Router taqqosi

Xususiyat React Router (loader) TanStack Router (loader)
URL segmentlari (params) Record<string, string | undefined> (noaniq) To‘liq tiplangan obyekt (params.productId)
Query parametrlar (search) new URL(request.url).searchParams.get('tab') Zod tomonidan tozalangan tayyor tiplangan obyekt
Tiplarni o‘girish (Type coercion) Qo‘lda Number(searchParams.get('page')) Avtomatik raqam, boolean yoki enum ko‘rinishida
Standart qiymatlar (Defaults) Qo‘lda `tab
Xatoliklarni ushlash Runtime vaqtida xatolik yuz beradi Schema buzilsa, loader ishlamasdanoq to‘xtatiladi

Xulosa

  • loader React Hook'laridan foydalana olmaydi, chunki u komponent render bo‘lishidan oldin chaqiriladigan sof asinxron funksiya.
  • TanStack Router barcha URL segmentlarini params va query parametrlarni search argumenti orqali to‘liq tiplangan holda loader'ga uzatadi.
  • validateSearch yordamida belgilangan Zod sxemasi tufayli query parametrlar avtomatik ravishda to‘g‘ri ma'lumot turlariga aylanadi va standart qiymatlarga ega bo‘ladi.
  • Bu arxitektura komponent ichida ortiqcha ma'lumot qidirish va qo‘lda string parse qilish muammolarini butunlay yo‘q qiladi.