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¤cy=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. |
+-----------------------------------------------------------------------------------+
- Oldindan tayyor parametrlar (Zero Delay):
loaderishlashni boshlagan paytda URL manzildagi barcha dinamik segmentlar ($productId) va filtrlar (tab=specs) allaqachon parse qilingan va tayyor bo‘ladi. - Kompilyatsiya darajasidagi xavfsizlik:
Agar siz fayl nomini
$productId.tsxdan$id.tsxga o‘zgartirsangiz, TypeScriptloaderichidagiparams.productIdxatolik ekanini darhol ko‘rsatadi va xatolarning production'ga chiqib ketishini to‘xtatadi. - Standart qiymatlar (Defaults) avtomatik o‘rnatilgan:
Foydalanuvchi URL'da hech qanday
?tab=kiritmagan bo‘lsa ham,validateSearchdagi.default('overview')tufaylisearch.tabqiymati 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
loaderReact Hook'laridan foydalana olmaydi, chunki u komponent render bo‘lishidan oldin chaqiriladigan sof asinxron funksiya.- TanStack Router barcha URL segmentlarini
paramsva query parametrlarnisearchargumenti orqali to‘liq tiplangan holda loader'ga uzatadi. validateSearchyordamida 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.