React Router vs TanStack Router — Arxitektura, API va TypeScript yondashuvlari farqi
React Router va TanStack Router taqqosi: arxitektura, Route Tree, to'liq end-to-end type safety, search params validatsiyasi (Zod) va avto-to'ldirish.
2-dars
React Router vs TanStack Router — Arxitektura, API va TypeScript yondashuvlari farqi
React ekotizimida ko‘p yillar davomida marshrutlash (routing) bo‘yicha mutlaq yetakchi React Router bo‘lib kelgan. Ammo zamonaviy TypeScript talablari, qat'iy turlar xavfsizligi va murakkab URL holatlarini (Search Params) boshqarish ehtiyoji yangi avlod vositasi — TanStack Routerning dunyoga kelishiga sabab bo‘ldi.
Ikkala kutubxona ham bir qarashda bir xil vazifani — sahifalar orasida navigatsiyani ta'minlasa-da, ularning arxitekturaviy falsafasi, TypeScript bilan ishlashi va API yondashuvi bir-biridan tubdan farq qiladi.
Falsafiy farq: Tashqi qo'shimcha vs Noldan Type-Safe
flowchart TD
subgraph RR["React Router Yondashuvi"]
A["Dastlab Komponentlarga asoslangan (Component-driven)"] --> B["Keyinchalik Data API (v6.4) qo'shildi"]
B --> C["TypeScript qo'lda kasting (as Type) orqali ishlaydi"]
end
subgraph TR["TanStack Router Yondashuvi"]
D["Boshidanoq 100% TypeScript uchun loyihalashtirilgan"] --> E["Avtomatik Route Tree generatsiyasi"]
E --> F["End-to-End Type Safety: URL, Params, Search Params, Loader"]
end
- React Router: Dastlab oddiy JavaScript va JSX komponentlari (
<Routes>,<Route>) uchun yaratilgan. Keyinchalik ungaloader,actionva TypeScript turlari qo‘shildi. - TanStack Router: Tanner Linsley (TanStack Query muallifi) tomonidan noldan boshlab "TypeScript birinchi o‘rinda" (Type-First) tamoyili asosida yaratilgan.
1. Arxitektura va Marshrutlarni e'lon qilish
React Router: Obyektlar massivi
React Router'da yo‘llar oddiy JavaScript obyektlari massivi ko‘rinishida e'lon qilinadi. Barcha yo‘llar oddiy satrlar (strings) bo‘lib, dasturchi ularni o‘zi mustaqil nazorat qiladi:
// React Router: createBrowserRouter
import { createBrowserRouter } from "react-router-dom";
export const router = createBrowserRouter([
{
path: "/users/:userId",
element: <UserProfile />,
loader: userLoader,
},
]);
TanStack Router: Qat'iy Route Tree (Marshrutlar daraxti)
TanStack Router marshrutlarni alohida izolyatsiyalangan tugunlar (Nodes) sifatida yaratadi va ularni yagona ierarxik daraxtga bog‘laydi. Eng muhimi, file-based routing ishlatilganda kutubxona orqa fonda routeTree.gen.ts faylini avtomatik hosil qiladi:
// TanStack Router: createRoute & routeTree
import { createRootRoute, createRoute, createRouter } from "@tanstack/react-router";
const rootRoute = createRootRoute();
const userRoute = createRoute({
getParentRoute: () => rootRoute,
path: "/users/$userId",
component: UserProfile,
loader: userLoader,
});
const routeTree = rootRoute.addChildren([userRoute]);
export const router = createRouter({ routeTree });
2. Navigatsiya va Havolalar (Type-Safe Navigation)
Bu ikki kutubxona o‘rtasidagi eng yaqqol seziladigan farq aynan havolalarni yozishda ko‘rinadi.
React Router: "Stringly-Typed" xavf
React Router'da <Link to="..."> yoki navigate("...") ga oddiy matn uzatiladi:
// ❌ Agar harfiy xato qilsangiz, TypeScript hech narsa demaydi!
<Link to="/usrs/123">Foydalanuvchi</Link>
// ❌ Parametrni unutib qoldirsangiz, /users/undefined bo'lib ketadi
navigate(`/users/${userId}`);
TanStack Router: 100% Avto-to'ldirish va Kompilyatsiya tekshiruvi
TanStack Router butun loyihadagi barcha yo‘llarni va parametrlarni biladi. Kod muharririda to="..." yozishingiz bilan mavjud marshrutlar ro‘yxati (Autocomplete) chiqib keladi:
// ✅ TanStack Router: Harfiy xato qilishning imkoni yo'q!
<Link
to="/users/$userId"
params={{ userId: "123" }} // Agar userId berilmasa, TypeScript xato beradi!
>
Foydalanuvchi
</Link>
// Dasturiy navigatsiya:
navigate({
to: "/users/$userId",
params: { userId: "123" }
});
[!TIP] Agar loyihangizda
/users/$userIdyo‘lini/profile/$userIddeb o‘zgartirsangiz, TanStack Router butun loyihadagi barcha eski<Link>vanavigatechaqiruvlarini qizil chiziq bilan belgilab beradi. Bitta ham eskirgan link qolib ketmaydi!
3. Search Params (Query parametrlar) boshqaruvi
URL'dagi query parametrlari (?page=2&filter=active&sort=desc) bilan ishlashda TanStack Router mutlaqo yangi darajani taqdim etadi.
React Router: Faqat matnli useSearchParams
React Router'da searchParams.get() har doim string | null qaytaradi. Turlarga o‘tkazish va xatoliklarni tekshirishni qo‘lda yozasiz:
// React Router:
const [searchParams] = useSearchParams();
// Har safar qo'lda Number() ga o'girish va tekshirish shart:
const page = Number(searchParams.get("page")) || 1;
const filter = searchParams.get("filter") || "all";
TanStack Router: Zod / Valibot bilan qat'iy sxemalar
TanStack Router'da Search parametrlar birinchi toifali fuqaro (First-Class Citizen) hisoblanadi. Marshrut darajasida validateSearch orqali Zod sxemasini biriktirasiz:
// TanStack Router:
import { z } from "zod";
const usersSearchSchema = z.object({
page: z.number().catch(1),
filter: z.enum(["active", "inactive"]).catch("active"),
});
export const usersRoute = createRoute({
getParentRoute: () => rootRoute,
path: "/users",
validateSearch: (search) => usersSearchSchema.parse(search),
});
// Komponent ichida:
function UsersPage() {
// page avtomatik NUMBER, filter esa qat'iy "active" | "inactive"!
const { page, filter } = usersRoute.useSearch();
return <div>Sahifa: {page}</div>; // Qo'lda parse qilish shart emas!
}
4. Kesh va Ma'lumotlarni boshqarish (Data Caching)
- React Router: O‘zida kesh (Caching) saqlamaydi. Har safar sahifaga kirilganda
loaderqaytadan ishga tushadi. Agar kesh kerak bo‘lsa, o‘zingiz alohida kesh mexanizmi yoki tashqi kutubxona qo‘shishingiz lozim. - TanStack Router: O‘zining ichida o‘rnatilgan SWR (Stale-While-Revalidate) kesh boshqaruviga ega (
staleTime,gcTime). Foydalanuvchi oldin kirgan sahifasiga qaytsa, ma'lumot keshdan zudlik bilan olinadi va orqa fonda yangilanadi. TanStack Query (React Query) bilan esa mukammal birlashadi.
To'liq taqqoslash jadvali
| Xususiyat | React Router (v6.4+ / v7) | TanStack Router |
|---|---|---|
| Boshlang‘ich falsafasi | Komponentlarga yo‘naltirilgan (Component-first) | TypeScript va ma'lumotlar oqimiga yo‘naltirilgan (Type-first) |
| Type Safety | Qo‘lda kasting (as Type) talab etiladi |
100% End-to-End Type Safety (Avtomatik) |
| Navigatsiya xavfsizligi | Matnli ("/users/123"), typo xavfi yuqori |
Aniq yo‘l va params obyektlari, IDE Autocomplete |
| Search Params (Query) | URLSearchParams (faqat string, qo‘lda parsing) |
Zod / Valibot validatsiyasi, avtomatik turlar |
| Kesh mexanizmi | O‘rnatilgan kesh yo‘q (Revalidation asosiy) | O‘rnatilgan kesh (SWR), staleTime, gcTime |
| Fayl-asosli marshrutlash | Framework rejimida (v7) mavjud | Vite/CLI plagini orqali routeTree.gen.ts |
| O‘rganish osonligi | Juda ommabop, o‘rganish oson, katta jamoa | O‘rganish birmuncha murakkab, TypeScript bilimi shart |
Qaysi birini tanlash kerak?
flowchart TD
Start["Yangi loyiha boshlayapsiz"] --> Q1{"Loyiha to'liq TypeScript'da yoziladimi va Type-Safety muhimmi?"}
Q1 -- "Yo'q / Oddiy JS" --> RR["React Router tanlang<br/>(Soddalik, katta hamjamiyat, erkinlik)"]
Q1 -- "Ha, juda muhim" --> Q2{"URL Search Params (filtrlash, saralash, pagination) ko'p ishlatiladimi?"}
Q2 -- "Ha, juda ko'p" --> TR["TanStack Router tanlang<br/>(Mukammal Zod search params, 0 runtime xatolar)"]
Q2 -- "Oddiy marshrutlar" --> Q3{"TanStack Query (React Query) ishlatyapsizmi?"}
Q3 -- "Ha" --> TR
Q3 -- "Yo'q" --> RR
-
React Router'ni tanlang, agar:
- Sizga ko‘p yillik sinalgan, barqaror va internetda istalgan savolga javob topish oson bo‘lgan standart kerak bo‘lsa.
- Loyihangizda JavaScript yoki oddiy TypeScript ishlatilsa.
- React Router v7 Framework Mode (SSR) imkoniyatlaridan foydalanmoqchi bo‘lsangiz.
-
TanStack Router'ni tanlang, agar:
- Katta korporativ TypeScript loyihasi qurayotgan bo‘lsangiz va
404 Not Foundhamda typo xatolarini nolgacha tushirmoqchi bo‘lsangiz. - Boshqaruv panellari (Admin dashboard, jadvallar) qurayotgan bo‘lsangiz va URL query parametrlari orqali murakkab filter/sort qilishingiz kerak bo‘lsa.
- TanStack Query (React Query) ekotizimining ashaddiy muxlisi bo‘lsangiz.
- Katta korporativ TypeScript loyihasi qurayotgan bo‘lsangiz va
Xulosa
- React Router — bu qulaylik, keng tarqalganlik va ekotizim kattaligi bo‘yicha gigant bo‘lib qolmoqda.
- TanStack Router esa zamonaviy veb-ishlanmalarda TypeScript imkoniyatlarini maksimal darajaga olib chiqqan, havolalar va query-parametrlarni xatosiz boshqarishda tengsiz yangi avlod vositasidir.