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,loaderishga 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
beforeLoadvathrow 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.