Route.useSearch — Validatsiyalangan search state'ni olish
TanStack Router'da Route.useSearch: route-scoped qidiruv parametrlarini olish, avtomatik tozalangan turlar, select orqali render optimallashuvi va React Router bilan taqqoslash.
30-dars
Route.useSearch — Validatsiyalangan search state'ni olish
Tasavvur qiling, siz nufuzli restoranga tushlik qilgani kirdingiz. Agar ofitsiant dasturxoningizga xom go‘sht, tozalanmagan sabzavotlar va pichoq olib kelib qo‘ysa (React Router’dagi xom string query parametrlar kabi), siz ovqatlanish o‘rniga o‘zingiz uni tozalab, pishirib o‘tirishga majbur bo‘lardingiz.
Ammo mukammal oshxonada barcha masalliqlar avval qattiq oshpazlik nazoratidan (validateSearch) o‘tadi: tozalanadi, mukammal pishiriladi va sizning oldingizga iste'molga 100% tayyor, shohona taom (Route.useSearch) sifatida tortiladi.
TanStack Router’dagi Route.useSearch() hook'i aynan shu tayyor taom kabi ishlaydi. U shunchaki URL manzilidagi xom matnlarni o‘qib bermaydi — u barcha tekshiruvlardan o‘tgan, turlari (number, boolean, array) aniqlangan va standart qiymatlari o‘rnatilgan toza JavaScript obyektini taqdim etadi.
1. Route.useSearch qanday ishlaydi?
Oldingi darsda ko‘rganimizdek, har bir fayl moduli o‘zining Route obyektini eksport qiladi. Ushbu obyekt ichidagi Route.useSearch() aynan shu marshrut uchun belgilangan sxemani mukammal taniydi:
// src/routes/catalog.tsx
import { createFileRoute } from '@tanstack/react-router'
import { z } from 'zod'
// 1. Zod sxemasi orqali qoidalar o'rnatiladi
const catalogSearchSchema = z.object({
page: z.number().catch(1),
q: z.string().optional(),
sortBy: z.enum(['price', 'date', 'popularity']).default('popularity'),
})
export const Route = createFileRoute('/catalog')({
validateSearch: (search) => catalogSearchSchema.parse(search),
component: CatalogPageComponent,
})
function CatalogPageComponent() {
// 2. Route.useSearch() orqali to'liq tozalangan va tiplangan qiymatlarni olamiz
const { page, q, sortBy } = Route.useSearch()
// TypeScript aniq biladi:
// page: number (hech qachon string bo'lmaydi)
// q: string | undefined
// sortBy: 'price' | 'date' | 'popularity'
return (
<div style={{ padding: '2rem' }}>
<h1>Mahsulotlar Katalogi</h1>
<div style={{ background: '#f8fafc', padding: '1rem', borderRadius: '8px' }}>
<p>Qidiruv so‘zi: <strong>{q || 'Barcha mahsulotlar'}</strong></p>
<p>Joriy sahifa: <strong>{page}</strong></p>
<p>Saralash tartibi: <strong>{sortBy.toUpperCase()}</strong></p>
</div>
</div>
)
}
2. Nima uchun Route.useSearch ancha qulay va xavfsiz?
1. Global noaniqliklar yo'q (Route-Scoped Access)
React Router’dagi useSearchParams() butun brauzer URL'ini o‘qib beradi. Natijada boshqa sahifaning parametrlari bilan adashib ketish ehtimoli yuqori. Route.useSearch() esa faqat va faqat shu route moduli ichida e'lon qilingan parametrlarnigina ko‘rsatadi.
2. Qo‘lda kasting qilishdan to'liq xalos bo'lish (Zero-Coercion)
Komponentingiz ichida ortiqcha xavfli kodlar yozmaysiz:
// React Router uslubi (Ko'p takrorlanuvchi va xavfli):
const [searchParams] = useSearchParams()
const page = Number(searchParams.get('page') || 1) // NaN chiqib qolishi mumkin!
const isStock = searchParams.get('inStock') === 'true'
// TanStack Router uslubi (100% toza va xavfsiz):
const { page, inStock } = Route.useSearch() // page -> number, inStock -> boolean!
3. Mukammal Autocomplete (Intellisense)
IDE muharriringizda const search = Route.useSearch() deb yozib, search. nuqta qo‘yishingiz bilan barcha ruxsat etilgan parametrlar o‘z turlari bilan chiqib keladi.
3. Render samaradorligi: select orqali optimallashtirish
Agar sahifangizda juda ko‘p search parametrlar bo‘lsa (page, filter, sort, view, tab), komponentingiz faqat o‘ziga tegishli bitta parametr o‘zgargandagina qayta render bo‘lishi uchun select opsiyasidan foydalanishingiz mumkin:
// Faqat 'page' o'zgargandagina Pagination komponenti qayta chiziladi:
const page = Route.useSearch({
select: (search) => search.page,
})
[!TIP] Agar foydalanuvchi qidiruv maydoniga matn kiritayotgan bo‘lsa (
qparametri o‘zgarsa),select: (s) => s.pageqilib olingan komponent ortiqcha qayta render bo‘lmaydi. Bu esa katta ro‘yxatlarda unumdorlikni (performance) keskin oshiradi.
4. Search parametrlarining qayta ishlanish zanjiri (Mermaid Diagram)
flowchart LR
Browser["Brauzer URL: ?page=4&sortBy=price"] --> Router["TanStack Router"]
Router --> Validator["validateSearch (Zod Coercion & Defaults)"]
Validator --> Sanitized["Toza JSON Obyekti: { page: 4, sortBy: 'price' }"]
Sanitized --> Hook["Route.useSearch()"]
Hook --> Component["React Komponent (Tayyor va 100% xavfsiz holatda)"]
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router (useSearchParams) |
TanStack Router (Route.useSearch) |
|---|---|---|
| Qaytaradigan qiymat | URLSearchParams obyekti (stringlar) |
To‘liq tiplangan JavaScript JSON obyekti |
| Ma'lumotlar tozaligi | Xom matn, null yoki noto‘g‘ri qiymatlar bo‘lishi mumkin |
Avval validateSearchdan o‘tgan, 100% toza |
| Doirasi (Scope) | Global (barcha query'larni qaytaradi) | Faqat joriy route'ga tegishli parametrlar |
| Re-render nazorati | Har qanday query o‘zgarganda qayta render | select opsiyasi orqali mikroskopik nazorat |
| Type safety | Qo‘lda generic berish talab qilinadi | Avtomatik infer qilinadi |
Xulosa
Route.useSearch()— buvalidateSearchtomonidan tozalangan va tiplangan search parametrlarni komponent ichida xavfsiz olish uchun ishlatiladi.- Barcha raqamlar, mantiqiy qiymatlar va sanalar avtomatik to‘g‘ri turga (type) ega bo‘ladi, qo‘lda kasting qilish shart emas.
selectimkoniyati yordamida komponentni faqat kerakli parametr o‘zgargandagina yangilab, ilovaning ishlash tezligini maksimal darajaga ko‘tarish mumkin.