Series: TanStack Router Lesson 30

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 (q parametri o‘zgarsa), select: (s) => s.page qilib 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() — bu validateSearch tomonidan 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.
  • select imkoniyati yordamida komponentni faqat kerakli parametr o‘zgargandagina yangilab, ilovaning ishlash tezligini maksimal darajaga ko‘tarish mumkin.