Series: TanStack Router Lesson 6

Router Instance — createRouter va Router konfiguratsiyasi

TanStack Router'da createRouter konfiguratsiyasi: routeTree, defaultPendingMs, defaultPendingComponent, defaultScrollRestoration, xatoliklar boshqaruvi va global context.

6-dars

Router Instance — createRouter va Router konfiguratsiyasi

Tasavvur qiling, siz ulkan okean laynerining boshqaruv kapitan ko‘prigidasiz (Bridge). Laynerda motorlar, favqulodda xavfsizlik tizimlari, yo‘lovchilar ro‘yxati va xarita bor. Markaziy boshqaruv kompyuteri orqali kapitan barcha qoidalarni bir joyda o‘rnatadi: "Agar to‘lqinlar 2 metrdan oshsa xabar ber", "Yo‘lovchilar joylashuvini doim eslab qol", "Kema ekipajiga barcha ma'lumotlarni ochiq yetkaz".

TanStack Router’dagi Router Instance (createRouter) — bu sizning butun veb-ilovangizning markaziy boshqaruv kompyuteridir. U barcha marshrutlar xaritasini (routeTree), yuklanish kechikishlarini (defaultPendingMs), skrolni tiklashni (defaultScrollRestoration) va global ma'lumotlarni (context) yagona joyda boshqaradi.


createRouter qanday imkoniyatlarni beradi?

flowchart TD
    CR["createRouter({ ... })"]
    CR --> RT["routeTree (Marshrutlar daraxti)"]
    CR --> PM["defaultPendingMs (Miltillashning oldini oluvchi kutish)"]
    CR --> SR["defaultScrollRestoration (Skrolni eslab qolish)"]
    CR --> EC["defaultErrorComponent (Favqulodda xatoliklar qalqoni)"]
    CR --> CT["context (Global Auth / QueryClient uzatish)"]

1. Professional Router konfiguratsiyasi

Keling, real ishlab chiqarish (production) darajasidagi createRouter sozlamasini tuzamiz:

// src/router.tsx
import { createRouter } from "@tanstack/react-router";
import { routeTree } from "./routeTree.gen";

// 1. Global Context interfeysi (Auth holati va boshqa ma'lumotlar uchun)
export interface RouterContext {
  auth: {
    isAuthenticated: boolean;
    user: { id: string; name: string } | null;
  };
}

// 2. Router instansiyasini sozlaymiz
export const router = createRouter({
  routeTree,

  // A) Barcha sahifalarda skrolni avtomatik eslab qolish
  defaultScrollRestoration: true,

  // B) UX Miltillashining oldini olish (Flicker prevention)
  defaultPendingMs: 150, // 150ms dan tez yuklansa loader ko'rinmaydi!
  defaultPendingComponent: () => (
    <div style={{ padding: "20px", color: "#6b7280" }}>
      ⏳ Ma'lumotlar yuklanmoqda...
    </div>
  ),

  // C) Xatoliklar uchun umumiy zaxira oynasi
  defaultErrorComponent: ({ error }) => (
    <div style={{ padding: "20px", color: "#ef4444", background: "#fee2e2", borderRadius: "8px" }}>
      <h3>Kutilmagan xatolik yuz berdi!</h3>
      <p>{error.message}</p>
    </div>
  ),

  // D) 404 sahifasi
  defaultNotFoundComponent: () => (
    <div style={{ padding: "40px", textAlign: "center" }}>
      <h2>404 — Sahifa topilmadi 🧭</h2>
    </div>
  ),

  // E) Global Context boshlang'ich qiymati
  context: {
    auth: undefined!, // Ilovaga ulashda haqiqiy qiymat beriladi
  },
});

// 3. TypeScript uchun global ro'yxatdan o'tkazamiz
declare module "@tanstack/react-router" {
  interface Register {
    router: typeof router;
  }
}

2. Muhim parametrlarning chuqur tahlili

A) defaultPendingMs nima va nega u UX uchun zarur?

Ko‘pincha sahifa o‘zgarganda API so‘rovi juda tez — masalan, 50 millisekundda javob berishi mumkin. Agar siz oddiy loading spinner qo‘ysangiz, u ko‘z ochib yumguncha (50ms da) ekranda "lip" etib miltillab yo‘qoladi. Bu inson ko‘zini charchatadi va sayt qotayotgandek taassurot uyg‘otadi.

defaultPendingMs: 150 sozlamasi aytadi:

  • Agar so‘rov 150 millisekunddan tez kelsa — hech qanday loader ko‘rsatma, sahifani darhol silliq och!
  • Agar so‘rov 150 millisekunddan uzoqroq vaqt olsa — ana shundagina defaultPendingComponent ni ko‘rsat!

B) defaultScrollRestoration: true

Foydalanuvchi uzun maqola yoki ro‘yxatda 1500 piksel pastga tushdi va biror havolani bosdi. So‘ngra brauzerdagi "Orqaga" (Back) tugmasini bosganda, sahifa tepadan emas, aynan foydalanuvchi qoldirgan o‘sha 1500-pikseldan ochiladi. React Router'da buning uchun alohida komponentlar qo‘yish kerak bo‘lsa, TanStack Router'da bu bor-yo‘g‘i bitta bayroqcha (true) orqali hal bo‘ladi!

C) Global context va jonli ulanish

Router darajasida berilgan context butun ilovadagi barcha marshrutlarning beforeLoad, loader va komponentlariga hech qanday useContextsiz to‘g‘ridan-to‘g‘ri yetib boradi.

Haqiqiy loyihada kontekstni qanday uzatamiz?

// src/App.tsx
import { RouterProvider } from "@tanstack/react-router";
import { router } from "./router";
import { useAuth } from "./hooks/useAuth";

export function App() {
  const auth = useAuth(); // Haqiqiy login holati

  // RouterProvider'ga jonli kontekstni topshiramiz!
  return <RouterProvider router={router} context={{ auth }} />;
}

Endi istalgan sahifada foydalanuvchi kirmagan bo‘lsa, uni beforeLoad orqali to‘xtatish juda oson:

// src/routes/dashboard.tsx
export const Route = createFileRoute("/dashboard")({
  beforeLoad: ({ context }) => {
    // context.auth avtomatik to'liq tiplashtirilgan!
    if (!context.auth.isAuthenticated) {
      throw redirect({ to: "/login" });
    }
  },
});

React Router va TanStack Router sozlamalari farqi

Xususiyat React Router (createBrowserRouter) TanStack Router (createRouter)
Pending kechikishi (pendingMs) Mavjud emas (har doim darhol chiqadi) O‘rnatilgan (defaultPendingMs: 150)
Scroll Restoration Alohida <ScrollRestoration /> komponenti kerak Bitta parametr: defaultScrollRestoration: true
Global Context Alohida React Context Provider'lar orqali o‘rash kerak To‘g‘ridan-to‘g‘ri context prop orqali uzatiladi
Preloading (Oldindan yuklash) Qo‘lda sozlanadi defaultPreload: 'intent' (Hover qilganda yuklaydi)
Type Registration Kasting orqali declare module orqali 100% avtomatik

Xulosa

  • createRouter TanStack Router ilovasining yuragi bo‘lib, barcha global qoidalarni yagona markazda birlashtiradi.
  • defaultPendingMs sahifalar almashayotganda keraksiz spinner miltillashlarining oldini oladi va foydalanuvchi tajribasini (UX) oshiradi.
  • Global Context orqali autentifikatsiya, til yoki kesh vositalarini (TanStack Query) barcha marshrutlarga xavfsiz va toza tarqatish mumkin.