Series: TanStack Router Lesson 48

Protected routes — Authentication talab qiladigan route'lar

TanStack Router'da himoyalangan marshrutlar: beforeLoad va redirect, miltillashning oldini olish, redirect-back patterni va React Router bilan taqqos.

48-dars

Protected routes — Authentication talab qiladigan route'lar

Tasavvur qiling, siz xalqaro aeroportdasiz. Samolyotga chiqishdan oldin har bir yo‘lovchi xavfsizlik va pasport nazorati postidan (beforeLoad) o‘tadi.

Agar sizda bilet yoki pasport bo‘lmasa, sizni samolyot saloniga (React Komponent) kiritib, o‘rindiqqa o‘tirgach "sizga ruxsat yo‘q ekan" deb haydab chiqarishmaydi. Xavfsizlik xodimlari sizni samolyotga qadam qo‘yishingizdanoq to‘xtatib, ro‘yxatdan o‘tish oynasiga (Login sahifasi) yo‘naltiradi.

An'anaviy React ilovalarida himoyalangan sahifalar ko‘pincha UI qatlamida (<ProtectedRoute><Dashboard /></ProtectedRoute>) yozilar edi. Bu esa yomon oqibatga — maxfiy sahifaning bir lahzaga miltillab ochilib, keyin loginga otilib ketishiga (Flash of Protected Content) olib kelardi. TanStack Router esa himoyani routing poydevorining o‘zida hal qiladi.


1. beforeLoad orqali marshrutni himoyalash

TanStack Router'da himoya beforeLoad va throw redirect() orqali amalga oshiriladi. Bu funksiya sahifaning loaderi ishlashidan va komponenti yuklanishidan oldinroq darvozabon kabi yo‘lni to‘sadi:

// src/routes/admin.tsx
import { createFileRoute, redirect } from '@tanstack/react-router'

export const Route = createFileRoute('/admin')({
  // 1. Sahifa ochilishidan oldin auth holati tekshiriladi
  beforeLoad: async ({ context, location }) => {
    // Global context orqali auth obyektini o'qiymiz
    if (!context.auth.isAuthenticated) {
      // Ruxsatsiz foydalanuvchini zudlik bilan Login'ga yo'naltiramiz
      throw redirect({
        to: '/login',
        search: {
          // Foydalanuvchi login qilgach qaytib kelishi uchun joriy manzilni saqlaymiz
          redirect: location.href,
        },
      })
    }
  },

  component: AdminDashboardPage,
})

function AdminDashboardPage() {
  const { auth } = Route.useRouteContext()

  return (
    <div className="admin-page">
      <h1>Admin Boshqaruv Paneli</h1>
      <p>Xush kelibsiz, {auth.user?.name}!</p>
    </div>
  )
}

[!IMPORTANT] throw redirect(...) qilingan zahoti router barcha keyingi operatsiyalarni to‘xtatadi: sahifa kodi brauzerga yuklanmaydi, loader ishga tushmaydi va nozik ma'lumotlar tarmoqqa chiqmaydi!


2. Qayta yo‘naltirishdan keyin ortga qaytarish (Redirect Back Pattern)

Foydalanuvchi /admin/billing manziliga kirmoqchi bo‘lib /login sahifasiga tushsa, tizimga kirgandan so‘ng uni bosh sahifaga emas, aynan u bormoqchi bo‘lgan /admin/billing sahifasiga qaytarish zarur:

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

// 1. Login sahifasi uchun redirect parametrini Zod orqali qabul qilamiz
const loginSearchSchema = z.object({
  redirect: z.string().optional(),
})

export const Route = createFileRoute('/login')({
  validateSearch: (search) => loginSearchSchema.parse(search),
  component: LoginPage,
})

function LoginPage() {
  const { redirect: redirectTo } = Route.useSearch()
  const navigate = useNavigate()

  const handleLoginSubmit = async (e: React.FormEvent) => {
    e.preventDefault()
    
    // Tizimga muvaffaqiyatli kirish logikasi...
    await loginUserApi()

    // 2. Agar redirect manzili bo'lsa o'sha yerga, aks holda bosh sahifaga yo'naltiramiz
    navigate({ to: redirectTo || '/' })
  }

  return (
    <form onSubmit={handleLoginSubmit} className="login-form">
      <h2>Tizimga kirish</h2>
      <input type="email" placeholder="Email" required />
      <input type="password" placeholder="Parol" required />
      <button type="submit">Kirish</button>
    </form>
  )
}

async function loginUserApi() {
  return true
}

3. Pathless Layout orqali barcha sahifalarni birdaniga himoyalash

Agar sizda 20 ta himoyalangan sahifa bo‘lsa, har bir faylga beforeLoad yozib chiqish shart emas. Barcha sahifalarni bitta Pathless Layout (_authenticated.tsx) ostiga birlashtirish mumkin:

src/routes/
├── _authenticated.tsx         <-- Barcha ichki routelar uchun yagona himoya qalqoni
├── _authenticated/
│   ├── dashboard.tsx
│   ├── profile.tsx
│   └── settings.tsx
├── login.tsx
└── __root.tsx
// src/routes/_authenticated.tsx
import { createFileRoute, Outlet, redirect } from '@tanstack/react-router'

export const Route = createFileRoute('/_authenticated')({
  // Barcha ichki bolalar (/dashboard, /profile, /settings) uchun yagona Guard:
  beforeLoad: ({ context, location }) => {
    if (!context.auth.isAuthenticated) {
      throw redirect({
        to: '/login',
        search: { redirect: location.href },
      })
    }
  },

  component: () => <Outlet />,
})

Endi _authenticated/ papkasi ichidagi har qanday yangi sahifa avtomatik ravishda 100% himoyalangan bo‘ladi!


4. Himoyalangan navigatsiya oqimi (Mermaid Diagram)

sequenceDiagram
    autonumber
    actor User as Foydalanuvchi
    participant Router as TanStack Router
    participant Guard as beforeLoad (Auth Guard)
    participant Login as /login Sahifasi
    participant Admin as /admin Sahifasi

    User->>Router: /admin manziliga o'tish
    Router->>Guard: beforeLoad({ context, location }) tekshiruvi
    
    alt context.auth.isAuthenticated === false
        Guard-->>Router: throw redirect({ to: '/login', search: { redirect: '/admin' } })
        Router-->>Login: Foydalanuvchi login sahifasiga tushadi
        User->>Login: Login va parol kiritadi
        Login->>Router: navigate({ to: search.redirect })
    end

    Router->>Guard: Qayta tekshiruv (isAuthenticated === true)
    Guard-->>Router: Ruxsat berildi!
    Router->>Admin: Loader ishlaydi va /admin komponenti render bo'ladi
    Admin-->>User: Maxfiy sahifa xavfsiz namoyish etiladi

5. React Router va TanStack Router taqqosi

Xususiyat React Router (<ProtectedRoute />) TanStack Router (beforeLoad)
Himoya qatlami UI / Komponent darajasida Routing yadrosi darajasida (beforeLoad)
Miltillash (Content Flash) Tez-tez uchraydi (komponent yuklanib keyin otadi) Mutlaqo 0% miltillash (Sahifa yuklanmasdanoq to‘xtaydi)
Maxfiy kod yuklanishi Ruxsatsiz odamga ham JS chunk yuklanadi Faqat ruxsat berilgandagina JS yuklanadi
Redirect Back useLocation() va state orqali murakkab Zod va URL search orqali sodda va qat'iy tiplangan
Guruhli himoya Pathless Route yoki Context orqali _authenticated.tsx orqali toza meros (Inheritance)

Xulosa

  • Protected Routes — tizimga kirmagan yoki huquqi yetarli bo‘lmagan foydalanuvchilarning maxfiy sahifalarga kirishini to‘suvchi mexanizm.
  • TanStack Router'da himoya beforeLoad va throw redirect() orqali komponent mount bo‘lishidan oldinroq amalga oshiriladi.
  • Bu yondashuv sahifa kodi va ma'lumotlarining miltillashini (Flash of Protected Content) butunlay yo‘q qiladi.
  • search: { redirect: location.href } orqali foydalanuvchini login qilgach avvalgi manziliga silliq qaytarish mumkin.
  • Guruhli himoya uchun Pathless Layout (_authenticated.tsx) eng maqbul arxitekturaviy yechimdir.