Series: TanStack Router Lesson 2

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 unga loader, action va 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/$userId yo‘lini /profile/$userId deb o‘zgartirsangiz, TanStack Router butun loyihadagi barcha eski <Link> va navigate chaqiruvlarini 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 loader qaytadan 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
  1. 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.
  2. TanStack Router'ni tanlang, agar:

    • Katta korporativ TypeScript loyihasi qurayotgan bo‘lsangiz va 404 Not Found hamda 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.

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.