Seriya: TanStack Router Dars 50

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 (beforeLoad Redirect): 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:

  1. Agar siz to parametriga route daraxtida mavjud bo‘lmagan xato manzil yozsangiz (masalan, /profil), TypeScript darhol xato beradi.
  2. Agar manzil dinamik parametr talab qilsa (/users/$userId), params: { userId: '...' } berilmaguncha kod kompilyatsiya bo‘lmaydi.
  3. 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: 301 yoki 302 kabi HTTP status kodlarini to‘g‘ridan-to‘g‘ri sozlash mumkin.