Redirects — redirect va beforeLoad orqali yo‘naltirish
TanStack Router'da Type-Safe redirect: beforeLoad va loader orqali yo'naltirish, throw redirect afzalliklari, HTTP status kodlari (301, 302) va React Router bilan taqqos.
50-dars
Redirects — redirect va beforeLoad orqali yo‘naltirish
React ilovalarida foydalanuvchini bir sahifadan boshqasiga yo‘naltirishda (redirection) ko‘p uchraydigan noqulayliklardan biri — UI miltillashi (Flash of Redirect):
Foydalanuvchi sahifaga kiradi, komponent render bo‘ladi, useEffect ishlaydi va nihoyat <Navigate> yoki useNavigate() chaqirilib boshqa manzilga otilib ketadi. Bu foydalanuvchi ko‘ziga yoqimsiz sakrash sifatida ko‘rinadi.
TanStack Router’da esa yo‘naltirishlar routing poydevorining o‘zida (beforeLoad yoki loader), sahifa kodi va komponenti brauzerga umuman render bo‘lmasidan oldin amalga oshiriladi.
1. Hayotiy o‘xshatish: Yo‘l ta'miri va Aylanib o‘tish belgisi
Tasavvur qiling, siz avtomobilda notanish shaharda harakatlanyapsiz.
- Eski usul (UI Redirect): Siz ta'mirlanayotgan ko‘chaga to‘liq kirib borasiz. Oxiriga yetganda berk ko‘chaga tiralib to‘xtaysiz (Komponent render bo‘ldi) va o‘sha yerdagi "Yo‘l yo‘q, orqaga qayting" degan yozuvni ko‘rib, orqaga burilishga majbur bo‘lasiz (Kechikish va ortiqcha xarajat).
- TanStack Router usuli (
beforeLoadRedirect): Ko‘chaning eng kirish qismidayoq (beforeLoad) yo‘l harakati xizmati "Aylanib o‘tish yo‘li" belgisini o‘rnatgan bo‘ladi. Siz berk ko‘chaga bir qadam ham kirmasdan, to‘g‘ridan-to‘g‘ri yangi ravon yo‘lga yo‘naltirilasiz.
2. redirect funksiyasi qanday ishlaydi?
redirect — bu TanStack Router tomonidan taqdim etiladigan maxsus yordamchi funksiya. Uni throw redirect(...) qilib ishlatish tavsiya etiladi.
Nega aynan throw?
Chunki throw qilingan zahoti funksiyaning keyingi qatorlari, router'ning loaderi va uning bola marshrutlari bajarilishi zudlik bilan to‘xtatiladi:
// src/routes/old-path.tsx
import { createFileRoute, redirect } from '@tanstack/react-router'
export const Route = createFileRoute('/old-path')({
beforeLoad: async () => {
// Foydalanuvchi bu manzilga kelganda darhol yangi manzilga yo'naltiriladi
throw redirect({
to: '/new-path',
})
},
})
3. Type-Safe Redirect: Parametrlar va Search nazorati
TanStack Router'dagi redirect funksiyasining eng katta ustunligi — bu 100% Type-Safety:
- Agar siz
toparametriga route daraxtida mavjud bo‘lmagan xato manzil yozsangiz (masalan,/profil), TypeScript darhol xato beradi. - Agar manzil dinamik parametr talab qilsa (
/users/$userId),params: { userId: '...' }berilmaguncha kod kompilyatsiya bo‘lmaydi. - Agar manzil Zod search sxemasiga ega bo‘lsa, barcha majburiy query parametrlar tekshiriladi.
// src/routes/posts/$postId.tsx
import { createFileRoute, redirect } from '@tanstack/react-router'
export const Route = createFileRoute('/posts/$postId')({
beforeLoad: async ({ params }) => {
const postExists = await checkPostExistsInDb(params.postId)
if (!postExists) {
// Agar maqola topilmasa, qidiruv sahifasiga parametrlar bilan yo'naltiramiz
throw redirect({
to: '/search',
search: {
error: 'not_found',
failedId: params.postId,
},
})
}
},
component: PostDetailPage,
})
function PostDetailPage() {
return <div>Maqola tafsilotlari</div>
}
async function checkPostExistsInDb(id: string) {
return id !== '404'
}
4. SSR va SEO uchun HTTP Status Kodlari (301, 302, 307)
Server tomonlama render qilish (SSR) va qidiruv tizimlari (Google bot) uchun redirect qanday HTTP status kod bilan bajarilayotgani hal qiluvchi ahamiyatga ega.
TanStack Router statusCode xossasini ko‘rsatish imkonini beradi:
// src/routes/legacy-articles.tsx
import { createFileRoute, redirect } from '@tanstack/react-router'
export const Route = createFileRoute('/legacy-articles')({
beforeLoad: () => {
throw redirect({
to: '/blog',
// 301 - Doimiy yo'naltirish (Permanent Redirect - SEO reytingini saqlab qoladi)
statusCode: 301,
})
},
})
// Dinamik shartlar uchun esa odatda 302 yoki 307 ishlatiladi:
throw redirect({
to: '/login',
// 302 / 307 - Vaqtinchalik yo'naltirish (Temporary Redirect)
statusCode: 302,
})
5. Redirect jarayoni arxitekturasi (Mermaid Diagram)
sequenceDiagram
autonumber
actor User as Foydalanuvchi
participant Router as TanStack Router
participant Guard as beforeLoad / loader
participant Target as Yangi Manzil (/new-path)
User->>Router: URL ochildi: /old-path
Router->>Guard: beforeLoad() ishga tushadi
Guard->>Guard: Shart tekshirildi (Manzil eskirgan yoki ruxsat yo'q)
Guard-->>Router: throw redirect({ to: '/new-path', statusCode: 301 })
Note over Router: /old-path ning komponenti va loader'i BEKOR QILINADI!
Router->>Target: Yangi manzilga yo'naltirish
Target-->>User: Foydalanuvchiga to'g'ridan-to'g'ri yangi sahifa ochiladi (0 miltillash!)
6. React Router va TanStack Router taqqosi
| Xususiyat | React Router (redirect) |
TanStack Router (throw redirect) |
|---|---|---|
| Yo‘naltirish turi | Oddiy string (redirect('/posts/' + id)) |
Type-Safe obyekt ({ to: '/posts/$id', params }) |
| Xato manzil kiritish | Mumkin (xato faqat runtime'da ma'lum bo‘ladi) | TypeScript tahrirlash paytidayoq qizil bilan ko‘rsatadi |
| Parametrlarni majburlash | Nazoratsiz (parametrni unutish juda oson) | Barcha majburiy params va search qat'iy talab qilinadi |
| To‘xtatish mexanizmi | return redirect(...) |
throw redirect(...) (Zudlik bilan execution to‘xtaydi) |
| HTTP Status boshqaruvi | new Response('', { status: 302 }) |
**Deklarativ `statusCode: 301 |
Xulosa
redirect— foydalanuvchini sahifa komponenti render bo‘lishidan oldin yangi manzilga o‘tkazuvchi asosiy funksiya.- Kod bajarilishini zudlik bilan to‘xtatish va ortiqcha hisob-kitoblarning oldini olish uchun
throw redirect(...)shakli tavsiya etiladi. - TanStack Router yo‘nalish manzili (
to), dinamik segmentlar (params) va qidiruv parametrlarini (search) to‘liq Type-Safe holatda tekshiradi. - SSR va SEO maqsadlari uchun
statusCode: 301yoki302kabi HTTP status kodlarini to‘g‘ridan-to‘g‘ri sozlash mumkin.