Route.useParams — URL parametrlarini type-safe olish
TanStack Router'da Route.useParams: route-scoped parametrlar, aniq turlar (hech qachon undefined bo'lmaslik), xatolardan himoyalanish va React Router bilan taqqoslash.
23-dars
Route.useParams — URL parametrlarini type-safe olish
Tasavvur qiling, siz poyezd vokzaliga keldingiz va chiptaxona oynasiga yaqinlashdingiz. Agar siz kassirga shunchaki "Menga chipta bering" desangiz (React Router'dagi global useParams kabi), u sizdan "Qayerga? Qaysi vagon? Qaysi joy?" deb qayta so‘rashga majbur bo‘ladi va bu yerda noaniqlik yuzaga keladi. Ammo qo‘lingizda 42-joy uchun bron qilingan aniq chek bo‘lsa (Route-scoped Route.useParams), kassir hech qanday savollarsiz sizga aynan kerakli chiptani beradi. Chek bor ekan, unda joy raqami yo‘q (undefined) bo‘lishi mutlaqo imkonsiz!
TanStack Router’ning eng inqilobiy jihatlaridan biri shundaki, u global va noaniq hooklar o‘rniga har bir marshrutning o‘ziga tegishli bo‘lgan Route.useParams() metodini taqdim etadi.
1. Global useParams va Route.useParams farqi
Ko‘pgina router kutubxonalarida hamma joyda bir xil global useParams() chaqiriladi. Ammo bunday hook qaysi sahifada turganini aniq bilmagani uchun barcha parametrlarni string | undefined deb taxmin qiladi.
TanStack Router’da esa har bir createFileRoute fayl moduli o‘zining shaxsiy Route obyektini eksport qiladi:
// src/routes/products/$productId.tsx
import { createFileRoute } from '@tanstack/react-router'
// 1. Marshrut moduli e'lon qilinadi
export const Route = createFileRoute('/products/$productId')({
component: ProductDetailPage,
})
function ProductDetailPage() {
// 2. Aynan shu Route obyektining useParams() metodi chaqiriladi!
const { productId } = Route.useParams()
return (
<div style={{ padding: '2rem', fontFamily: 'sans-serif' }}>
<h1>Mahsulot sahifasi</h1>
<p>
Hozir ko‘rsatilayotgan mahsulot ID raqami: <strong>{productId}</strong>
</p>
</div>
)
}
[!NOTE]
Route.useParams()chaqirilganda, unga hech qanday TypeScript generic (<Params>) yoki fayl yo‘lini (from: '...') qo‘lda yozish shart emas — u o‘zi turgan fayldan barcha bilimlarni avtomatik meros qilib oladi.
2. Nima uchun bu React Router’dan ancha ustun?
1. Parametrlar hech qachon undefined bo'lmaydi (Strict Types)
React Router’da URL parametrlarini olganingizda quyidagi muammoga duch kelasiz:
// React Router usuli (Noaniq va xavfli):
const params = useParams()
// params.productId ning turi: string | undefined
// TypeScript talab qiladi:
if (!params.productId) {
return <div>Xatolik: ID topilmadi!</div>
}
const id = params.productId // yoki "params.productId as string" kasting kerak
TanStack Router’da esa ushbu sahifa faqatgina $productId mavjud bo‘lgandagina ochiladi. Shu sababli Route.useParams() qaytaradigan obyektda productId har doim kafolatlangan string turida bo‘ladi:
// TanStack Router usuli (100% Xavfsiz):
const { productId } = Route.useParams()
// productId ning turi: string (hech qachon undefined bo'lmaydi!)
2. Xato parametr nomini yozish imkonsiz (Compile-Time Validation)
Agar siz fayl nomini $productId.tsx deb qo‘yib, komponent ichida adashib userId deb yozib yuborsangiz:
// XATO! Bunday parametr fayl yo'lida yo'q!
const { userId } = Route.useParams()
// TypeScript xatosi:
// Property 'userId' does not exist on type '{ productId: string; }'.
IDE va TypeScript darhol kodni qizil chiziq bilan belgilab beradi. Siz xatoni loyihani serverga yuklashdan (deploy qilishdan) oldinroq bir lahzada sezasiz!
3. Parametrlarni optimallashgan holda olish (select opsiyasi)
Agar komponentingizda bir nechta parametrlar bo‘lsa ($categoryId, $productId), siz faqat o‘zingizga keraklisini select orqali ajratib olishingiz mumkin:
// Faqat bitta parametr o'zgargandagina komponent qayta render bo'ladi:
const productId = Route.useParams({
select: (params) => params.productId,
})
4. Parametrlarni tahlil qilish oqimi (Mermaid Diagram)
flowchart TD
File["src/routes/products/$productId.tsx"] --> Router["createFileRoute('/products/$productId')"]
Router --> Export["export const Route"]
subgraph Component["Komponent ichida"]
Export --> Hook["Route.useParams()"]
Hook --> Guard["Kafolat: { productId: string }"]
Guard --> NoCast["Typecasting (as string) SHART EMAS!"]
Guard --> NoUndef["Undefined tekshiruvi SHART EMAS!"]
end
5. React Router va TanStack Router taqqosi
| Xususiyat | React Router (useParams) |
TanStack Router (Route.useParams) |
|---|---|---|
| Qaytaradigan turi | Record<string, string | undefined> |
Aniq { [param]: string } |
undefined ehtimoli |
Har doim mavjud (qo‘lda if shart kerak) |
Mutlaqo yo‘q (Kafolatlangan qiymat) |
Qo‘lda kasting (as string) |
Deyarli har doim talab qilinadi | Hech qachon talab qilinmaydi |
| Autocomplete yordami | Mavjud emas | IDE to‘g‘ri nomlarni taklif qiladi |
| Noto‘g‘ri nom yozilsa | Brauzerda xato yuz beradi | TypeScript yozish paytidayoq to‘xtatadi |
Xulosa
Route.useParams()— bu o‘sha sahifa moduliga bog‘langan, 100% type-safe bo‘lgan maxsus hookdir.- Olingan parametrlar hech qachon
undefinedbo‘lmaydi va ularnias stringdeb kasting qilish talab etilmaydi. - Mavjud bo‘lmagan parametrlarni chaqirish yoki nomini adashtirish TypeScript tomonidan kod yozilayotgandayoq to‘xtatiladi.