Search params TypeScript inference — Schema asosida avtomatik type inference
TanStack Router'da Search Params Type Inference: validateSearch sxemasidan avtomatik turlar hosil qilish, DRY prinsipi, useSearch, Link va navigate'da to'liq tiplash.
29-dars
Search params TypeScript inference — Schema asosida avtomatik type inference
Tasavvur qiling, siz zargarlik ustaxonasida ishlaysiz. Har safar yangi uzuk yasaganingizda, uning o‘lchamlarini qog‘ozga, keyin daftarga, so‘ng qutining ustiga qayta-qayta qo‘lda yozib chiqmaysiz. Buning o‘rniga siz bitta mukammal 3D qolip shablonini yaratasiz. Shu shablon asosida uzuk quyiladi, o‘lchami aniqlanadi va qadoqlash qutisi ham avtomatik ravishda aynan shu shablonga moslab ishlab chiqariladi.
TypeScript bilan ishlaganda dasturchilarni eng ko‘p charchatadigan narsa — bu bir xil ma'lumotlar turini (types/interfaces) qayta-qayta yozishdir: komponent uchun alohida, loader uchun alohida, linklar uchun alohida.
TanStack Router’da Type Inference (turlarni avtomatik chiqarish) mexanizmi shunday qurilganki, siz validateSearch ichida bitta Zod sxemasini e'lon qilasiz — qolgan barcha turlarni TypeScript o‘sha yagona manbadan avtomatik ravishda hosil qiladi.
1. Avtomatik zanjir qanday ishlaydi?
Keling, bitta real misolni ko‘rib chiqamiz:
// src/routes/posts.tsx
import { createFileRoute, Link, useNavigate } from '@tanstack/react-router'
import { z } from 'zod'
// 1. Yagona manba (Single Source of Truth) — Zod sxemasi
const postsSearchSchema = z.object({
tab: z.enum(['all', 'trending', 'latest']).catch('all'),
page: z.number().catch(1),
searchQuery: z.string().optional(),
})
export const Route = createFileRoute('/posts')({
// 2. Sxemani validateSearch ga bog'laymiz
validateSearch: (search) => postsSearchSchema.parse(search),
component: PostsPageComponent,
})
function PostsPageComponent() {
// 3. Route.useSearch() ichida turlar 100% AVTOMATIK aniqlanadi!
const { tab, page, searchQuery } = Route.useSearch()
// TypeScript biladi:
// tab: "all" | "trending" | "latest" (oddiy string emas!)
// page: number
// searchQuery: string | undefined
return (
<div style={{ padding: '2rem' }}>
<h2>Postlar bo'limi: {tab.toUpperCase()}</h2>
<p>Sahifa: {page}</p>
{searchQuery && <p>Qidiruv natijasi: "{searchQuery}"</p>}
</div>
)
}
Hech qanday qo‘shimcha interface PostSearch { ... } yozilmadi! Sxemaning o‘zi butun turlarni to‘liq yaratib berdi.
2. Autocomplete va Navigatsiyadagi kuch
Bu avtomatik turlar nafaqat joriy sahifada, balki ilovangizning boshqa istalgan qismida <Link> yoki navigate ishlatganda ham xizmat qiladi:
A. <Link> komponentidagi Autocomplete:
import { Link } from '@tanstack/react-router'
export function NavigationTabs() {
return (
<div style={{ display: 'flex', gap: '1rem' }}>
{/* IDE 'tab' uchun faqat 'all' | 'trending' | 'latest' qiymatlarini taklif qiladi */}
<Link
to="/posts"
search={{ tab: 'trending', page: 1 }}
>
Trenddagilar
</Link>
{/* XATO! TypeScript ruxsat bermaydi, chunki 'popular' degan variant sxemada yo'q: */}
{/* <Link to="/posts" search={{ tab: 'popular', page: 1 }}>Mashhur</Link> */}
</div>
)
}
B. navigate funksiyasidagi xavfsizlik:
const navigate = useNavigate()
// Funksional tarzda o'zgartirish:
navigate({
to: '/posts',
search: (prev) => ({
...prev,
page: prev.page + 1, // prev.page to'liq number ekani kafolatlangan
}),
})
3. Nima uchun bu dasturchi uchun ulkan yutuq?
1. DRY prinsipi (Don't Repeat Yourself)
Siz bitta Zod sxemasini yozasiz, u bir vaqtning o‘zida:
- Brauzerda runtime paytida parametrlarni xatodan tozalaydi;
- TypeScript uchun statik tiplarni generatsiya qiladi;
- Komponentlar, havolalar va dasturiy navigatsiyani type-safe qiladi.
2. Zero-Drift (Mos kelmaslik xavfining yo‘qligi)
An'anaviy tizimlarda kod o‘zgarganda xatoliklar ko‘p uchraydi: validatsiya kodini o‘zgartirasiz, lekin alohida yozilgan TypeScript interfaceni yangilashni unutasiz. Natijada kod va turlar bir-biriga to‘g‘ri kelmay qoladi (Type Drift).
TanStack Router’da esa sxemaga yangi parametr qo‘shishingiz bilan (sortBy: z.enum(['date', 'views'])):
- Butun loyihada
Route.useSearch()darhol yangi parametrni taniydi; - Noto‘g‘ri yozilgan barcha joylar qizil chiziq bilan darhol ko‘rsatib beriladi.
4. Type Inference oqimi (Mermaid Diagram)
flowchart TD
Schema["Zod Schema (postsSearchSchema)"] --> ValSearch["validateSearch: (s) => schema.parse(s)"]
subgraph Inference["TypeScript Avtomatik Turlar Zanjiri"]
ValSearch --> InferredType["Inferred Type: { tab: 'all'|'trending'|'latest', page: number }"]
end
InferredType --> Hook["Route.useSearch() -> 100% Tiplangan"]
InferredType --> LinkProp["<Link to='/posts' search={{ tab: '...' }} />"]
InferredType --> NavProp["navigate({ to: '/posts', search })"]
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router | TanStack Router |
|---|---|---|
| Type yaratish usuli | Qo‘lda alohida interface yozish shart |
validateSearch sxemasidan 100% avtomatik |
| Type Drift (Sinxron buzilishi) | Juda yuqori (sxema va interface alohida) | Mutlaqo yo‘q (Yagona haqiqat manbai) |
| Link Autocomplete | Mavjud emas (ixtiyoriy query yozish mumkin) | Faqat sxemada ruxsat etilgan qiymatlar chiqadi |
| Enum qiymatlar nazorati | Faqat runtime'da ma'lum bo‘ladi | Kodni yozish paytidayoq tekshiriladi |
Xulosa
- Search params Type Inference — bu
validateSearchsxemasiga asoslanib butun loyihada qidiruv parametrlari turlarini avtomatik shakllantirish mexanizmidir. - Siz ortiqcha alohida TypeScript
interfaceyokitypeyozmaysiz — barchasi Zod sxemasidan infer qilinadi. - Bu yondashuv DRY prinsipiga to‘liq javob beradi va butun ilovada havolalar hamda navigatsiyani xatosiz ishlashini ta'minlaydi.