Seriya: TanStack Router Dars 20

useRouter — Router instance va uning API'lari

TanStack Router'da useRouter hook'i: router instansiyasiga to'g'ridan-to'g'ri kirish, router.invalidate(), router.preloadRoute(), router.state va React Router bilan taqqos.

20-dars

useRouter — Router instance va uning API'lari

Tasavvur qiling, siz poyezdda ketayotgan oddiy yo‘lovchi emassiz, balki temir yo‘l boshqaruv markazining bosh dispetcherisiz. Sizning oldingizda barcha poyezdlar harakati, stansiyalar holati va relslar yo‘nalishini boshqaruvchi bosh kompyuter pulti turibdi. Siz istalgan poyezd yo‘nalishini oldindan tayyorlab qo‘yishingiz (preload), favqulodda harakatlar jadvalini yangilashingiz (invalidate) yoki tizim holatini soniya sayin kuzatishingiz (state) mumkin.

TanStack Router’dagi useRouter hook'i — bu sizga butun ilovangiz routing mexanizmining o‘sha markaziy boshqaruv pultiga bevosita kirish imkonini beruvchi qudratli vositadir.


1. useRouter nima va u qanday chaqiriladi?

Agar useNavigate faqat sahifalararo harakatlanish uchun mo‘ljallangan bo‘lsa, useRouter butun createRouter orqali yaratilgan router instansiyasining to‘liq API’larini ochib beradi:

import { useRouter } from '@tanstack/react-router'

export function AdminControlPanel() {
  // Router instansiyasiga to'liq kirish huquqini olamiz
  const router = useRouter()

  const handleManualRefresh = () => {
    // Joriy sahifaning barcha loader ma'lumotlarini majburiy qaytadan yangilaymiz
    router.invalidate()
  }

  return (
    <div style={{ padding: '1rem', background: '#f8fafc', borderRadius: '8px' }}>
      <h3>Boshqaruv paneli</h3>
      <button onClick={handleManualRefresh}>
        Ma'lumotlarni yangilash (Refetch)
      </button>
    </div>
  )
}

2. Real loyihalarda eng ko'p ishlatiladigan 3 ta super kuch

useRouter obyekti ichida o‘nlab yordamchi vositalar bor, ammo quyidagi uchta imkoniyat dasturchilar hayotini eng ko‘p yengillashtiradi:

A. router.invalidate() (Ma'lumotlarni majburiy yangilash)

Tasavvur qiling, foydalanuvchi modal darcha ichida yangi maqola qo‘shdi yoki profil ma'lumotlarini tahrirlab "Saqlash" tugmasini bosdi. API'ga so‘rov muvaffaqiyatli ketdi, ammo sahifadagi eski ro‘yxat o‘zgarishsiz qolib ketmasligi kerak.

Bunday paytda router.invalidate() chaqiriladi — u ayni damda ekranda ko‘rinib turgan barcha faol loader funksiyalarini avtomatik qaytadan ishga tushiradi:

import { useRouter } from '@tanstack/react-router'

export function EditUserModal({ userId, onClose }: { userId: string; onClose: () => void }) {
  const router = useRouter()

  const handleUpdate = async (newName: string) => {
    // 1. Backend'ga ma'lumotni yuboramiz
    await updateUserApi(userId, { name: newName })

    // 2. Sahifadagi loader'larni qayta ishlatib, yangi ma'lumotlarni tortib kelamiz
    await router.invalidate()

    // 3. Modalni yopamiz
    onClose()
  }

  return (
    <div>
      {/* Forma elementlari */}
    </div>
  )
}

async function updateUserApi(_id: string, _data: any) {
  return Promise.resolve()
}

[!TIP] React Router bilan farqi: React Router’da buning uchun alohida useRevalidator() hook'ini chaqirish kerak edi. TanStack Router’da esa bu to‘g‘ridan-to‘g‘ri router instansiyasining o‘ziga biriktirilgan.


B. router.preloadRoute() (Oldindan yuklab qo'yish / Prefetching)

Foydalanuvchi biror tugmaga sichqonchani olib kelganida (hover), uning o‘sha sahifaga kirish ehtimoli 80% dan oshadi. Nega foydalanuvchi tugmani bosishini kutishimiz kerak?

router.preloadRoute() orqali o‘sha sahifaning JavaScript kodini va uning loader ma'lumotlarini orqa fonda oldindan yuklab qo‘yish mumkin:

import { useRouter } from '@tanstack/react-router'

export function QuickNavigation() {
  const router = useRouter()

  const handleHoverSettings = () => {
    // Foydalanuvchi sichqonchani olib kelishi bilanoq ma'lumotlarni orqa fonda yuklaymiz
    router.preloadRoute({
      to: '/dashboard/settings',
    })
  }

  return (
    <button 
      onMouseEnter={handleHoverSettings}
      onClick={() => router.navigate({ to: '/dashboard/settings' })}
    >
      Sozlamalar (Chaqmoqdek tez ochiladi)
    </button>
  )
}

Natijada foydalanuvchi tugmani bosgan onda sahifa 0 millisekundda, hech qanday kutishlarsiz bir zumda ekranga chiqadi!


C. router.state (Router'ning global holati)

Router ayni damda nima ish qilayotganini (sahifa yuklanyaptimi, xatolik yuz berdimi, navigatsiya jarayoni bormi) to‘liq ko‘rib turadi.

Masalan, butun sayt bo‘ylab har qanday sahifa almashganda tepadagi qizil yuklanish chizig‘ini (Global Progress Bar) chiqarish uchun router.state.isLoading tekshiriladi:

import { useRouterState } from '@tanstack/react-router'

export function GlobalProgressBar() {
  // router.state holatini reaktiv kuzatib boramiz
  const isLoading = useRouterState({
    select: (state) => state.isLoading,
  })

  if (!isLoading) return null

  return (
    <div 
      style={{
        position: 'fixed',
        top: 0,
        left: 0,
        right: 0,
        height: '3px',
        background: '#2563eb',
        zIndex: 9999,
        animation: 'pulse 1s infinite',
      }} 
    />
  )
}

3. useRouter arxitekturasi (Mermaid Diagram)

flowchart TD
    Hook["useRouter()"] --> Router["Yagona Markaziy Router Instansiyasi"]
    
    Router --> Inv["router.invalidate() (Barcha faol loaderlarni yangilash)"]
    Router --> Pre["router.preloadRoute() (Kod va ma'lumotni keshga oldindan yuklash)"]
    Router --> State["router.state (isLoading, location, matches)"]
    Router --> Nav["router.navigate() (Dasturiy navigatsiya)"]

    style Router fill:#eff6ff,stroke:#2563eb,stroke-width:2px

4. React Router va TanStack Router taqqosi

Xususiyat React Router TanStack Router (useRouter)
Boshqaruv arxitekturasi Turli vazifalar uchun har xil hooklar (useRevalidator, useNavigation) Bitta yagona boshqaruvchi: useRouter
Loader ma'lumotlarini yangilash const revalidator = useRevalidator(); revalidator.revalidate() router.invalidate() (Juda qisqa va qulay)
Oldindan yuklash (Prefetch) Qo‘lda maxsus fetcherlar yozish talab etiladi router.preloadRoute({ to: '...' }) tayyor API
Global holatni kuzatish useNavigation().state === 'loading' router.state.isLoading yoki useRouterState
Type-Safety Cheklangan Barcha yo‘llar va parametrlar 100% type-safe

Xulosa

  • useRouter — butun ilovani boshqarib turuvchi markaziy router instansiyasiga bevosita kirish imkonini beradi.
  • router.invalidate() — forma yuborilgandan yoki ma'lumot o‘zgargandan keyin sahifadagi loader'larni qayta ishlatib, yangi ma'lumotlarni tortib keladi.
  • router.preloadRoute() — sahifa kodini va ma'lumotlarini foydalanuvchi bosishidan oldinroq orqa fonda keshlab, chaqmoqdek tez ochilishini ta'minlaydi.
  • router.state — ilovaning joriy yuklanish holati (isLoading) va navigatsiya oqimini global boshqarishga xizmat qiladi.