Series: TanStack Router Lesson 28

validateSearch — Search parametrlarni validatsiya qilish

TanStack Router'da validateSearch: tashqi URL query parametrlarini Zod bilan tekshirish, type coercion, .catch() orqali fallback qiymatlar va React Router bilan taqqos.

28-dars

validateSearch — Search parametrlarni validatsiya qilish

Tasavvur qiling, siz ichimlik suvi ishlab chiqaruvchi zamonaviy korxonani boshqaryapsiz. Daryodan kelayotgan xom suvni to‘g‘ridan-to‘g‘ri shishalarga quyib sotib bo‘lmaydi — uning ichida qum, loy va turli xavfli moddalar bo‘lishi mumkin. Suv avval ko‘p bosqichli kuchli filtrdan (validateSearch) o‘tadi: barcha iflosliklar elanadi, minerallar me'yorlashtiriladi va faqatgina 100% xavfsiz toza ichimlik suvi iste'molchiga yetkaziladi. Agar suv juda iflos bo‘lsa ham, filtr avtomatik toza zaxira suvni ishga soladi (.catch()).

Brauzerdagi URL manzillar — bu aynan o‘sha ochiq daryo kabi ishonchsiz tashqi muhitdir. Har qanday foydalanuvchi manzil oxiriga istalgan narsani (masalan: ?page=salom&inStock=balki) qo‘lda yozishi mumkin.

Agar biz bu qiymatlarni tekshirmasdan to‘g‘ridan-to‘g‘ri dasturda ishlatsak, ilovamizda NaN xatolari ko‘payib, butun sahifa ishlamay qoladi (crash bo‘ladi). validateSearch ana shu muammoni hal qiluvchi asosiy darvozabondir.


1. validateSearch qanday ishlaydi?

Foydalanuvchi sahifaga kirganda yoki URL qidiruv qismi o‘zgarganda, TanStack Router xom (raw) query parametrlarni avtomatik ravishda validateSearch funksiyasiga uzatadi.

Sizning vazifangiz — o‘sha kelgan xom parametrlarni Zod (yoki Valibot) yordamida tekshirib, toza va to‘liq tiplangan obyekt qaytarishdir:

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

// 1. Zod yordamida qat'iy sxema tuzamiz
const productSearchSchema = z.object({
  // Agar page noto'g'ri kelsa yoki bo'sh bo'lsa, avtomatik 1 bo'ladi
  page: z.number().catch(1),
  // Agar category ko'rsatilmagan bo'lsa, 'all' deb olinadi
  category: z.string().default('all'),
  // Boolean qiymat, xato kiritilsa true fallback beriladi
  inStock: z.boolean().catch(true),
})

export const Route = createFileRoute('/products')({
  // 2. validateSearch barcha parametrlarni sxemadan o'tkazadi
  validateSearch: (search: Record<string, unknown>) => {
    return productSearchSchema.parse(search)
  },

  component: ProductsPageComponent,
})

function ProductsPageComponent() {
  // 3. Olingan parametrlar 100% toza, tiplangan va xavfsiz!
  const { page, category, inStock } = Route.useSearch()

  return (
    <div style={{ padding: '2rem' }}>
      <h1>Mahsulotlar katalogi</h1>
      <ul>
        <li>Joriy sahifa: <strong>{page}</strong> (Turi: {typeof page})</li>
        <li>Tanlangan kategoriya: <strong>{category}</strong></li>
        <li>Faqat omborda borlar: <strong>{inStock ? "Ha" : "Yo'q"}</strong></li>
      </ul>
    </div>
  )
}

2. validateSearchning 3 ta asosiy ustunligi

1. Tipni majburiy o‘tkazish (Type Coercion & Parsing)

URL'dan keladigan barcha query parametrlar aslida doimo string matn bo‘ladi (?page=3 aslida "3").

Zod va TanStack Router uni avtomatik ravishda haqiqiy JavaScript soniga (number), mantiqiy qiymatiga (boolean) yoki massiviga (array) aylantirib beradi.

2. Xavfsiz standart qiymatlar (.default() vs .catch())

Ikkala metod ham xatoliklardan himoya qiladi, lekin ular o‘rtasida nozik farq bor:

  • .default(qiymat): Parametr URL'da umuman yozilmagan bo‘lsa (?page=2 yozilganu, lekin category yo‘q), standart qiymatni qo‘yadi.
  • .catch(zaxira): Parametr yozilgan, lekin noto‘g‘ri turda kiritilgan bo‘lsa (masalan: ?page=not-a-number), Zod xatolik otib dasturni qulatmaydi, balki zaxiradagi xavfsiz qiymatni (1) o‘rnatadi!
const safeSchema = z.object({
  // Har qanday xato kirsa ham 1-sahifaga qaytaradi (Graceful Fallback)
  page: z.number().catch(1),
})

3. Butun ilova bo‘ylab Type-Safety tarqatilishi

validateSearch qaytargan obyekt turi avtomatik ravishda:

  • Route.useSearch();
  • <Link to="/products" search={{ ... }} />;
  • navigate({ to: '/products', search: { ... } })

kabi barcha joylarga tarqaladi. Natijada siz query parametrlar yozayotganda ham IDE tomonidan mukammal autocomplete yordamini olasiz.


3. Validatsiya oqimi (Mermaid Diagram)

flowchart TD
    URL["Foydalanuvchi kirdi: ?page=abc&category=phones"] --> Router["TanStack Router qabul qiladi"]
    Router --> ValSearch["validateSearch(search)"]
    
    subgraph ZodValidation["Zod Sxema Tahlili"]
        CheckPage{"page: 'abc' raqammi?"}
        CheckCat{"category: 'phones' to'g'rimi?"}
    end

    ValSearch --> CheckPage
    CheckPage -- "Yo'q (Xato!)" --> Catch[".catch(1) ishga tushadi -> page = 1"]
    CheckPage -- "Ha" --> KeepPage["page o'z holicha olinadi"]
    
    ValSearch --> CheckCat
    CheckCat -- "Ha" --> KeepCat["category = 'phones'"]

    Catch --> CleanObj["Xavfsiz Obyekt: { page: 1, category: 'phones', inStock: true }"]
    KeepPage --> CleanObj
    KeepCat --> CleanObj

    CleanObj --> UseSearch["Route.useSearch() & Komponent"]

4. React Router va TanStack Router taqqosi

Xususiyat React Router (useSearchParams) TanStack Router (validateSearch)
Validatsiya o‘rni Har bir komponent ichida tarqoq Route darajasida yagona va markazlashtirilgan
Xato kiritilganda NaN bo‘lib qolishi va komponent qulashi mumkin .catch() orqali zaxira qiymatga xavfsiz o‘tadi
Type Coercion Har safar Number(), Boolean() qo‘lda yoziladi Avtomatik pars qilinadi
Compile-time kafolat Mavjud emas (ixtiyoriy string yozish mumkin) 100% TypeScript Intellisense va Autocomplete

Xulosa

  • validateSearch — bu URL query parametrlarini dasturga kirishidan oldin tozalab, tekshirib beruvchi maxsus filtrdir.
  • Zod kutubxonasi bilan birgalikda u URL matnlarini real JavaScript tiplariga (number, boolean, object) o‘girib beradi.
  • .catch() metodidan foydalanish foydalanuvchilar tomonidan kiritilgan noto‘g‘ri yoki xavfli parametrlarni avtomatik xavfsiz qiymatga almashtirib, ilova barqarorligini ta'minlaydi.