Seriya: TanStack Router Dars 10

Router DevTools — Route tree va navigation jarayonlarini debugging qilish

TanStack Router DevTools: o'rnatish, __root.tsx'da ulash, Route Tree, URL parametrlari, search params va loader holatlarini real vaqtda debugging qilish.

10-dars

Router DevTools — Route tree va navigation jarayonlarini debugging qilish

Tasavvur qiling, siz zamonaviy poyga avtomobilini (Formula 1) boshqaryapsiz. Oddiy haydovchi faqat oldindagi yo‘l va rulni ko‘radi. Poygachi va uning texnik jamoasi esa maxsus telemetriya ekraniga ega: unda har bir g‘ildirak bosimi, dvigatel harorati, tormoz kuchi va qaysi burilishda qancha tezlikda harakatlanayotgani soniya sayin grafiklarda ko‘rsatib turiladi.

Veb-ilovalarda navigatsiya jarayonlari ko‘pincha qorong‘u qutiga o‘xshaydi: URL o‘zgardi, lekin qaysi parametr keldi? Qaysi loader ishga tushdi? Qaysi marshrut faol?

TanStack Router DevTools — bu sizning ilovangiz uchun o‘sha mukammal telemetriya ekranidir. U brauzer ekranining burchagida joylashib, barcha marshrutlar, parametrlar va navigatsiya oqimlarini real vaqt rejimida vizual tarzda ko‘rsatib turadi.


1. DevTools qanday o'rnatiladi va ulanadi?

Oldingi darslarda biz kerakli dev-paketni o‘rnatgan edik:

npm install -D @tanstack/router-devtools
# yoki
pnpm add -D @tanstack/router-devtools

Uni loyihaga ulash nihoyatda oson — uni eng yuqori asosiy ildiz route (src/routes/__root.tsx) ichiga joylashtirasiz:

// src/routes/__root.tsx
import { createRootRoute, Outlet } from '@tanstack/react-router'
import { TanStackRouterDevtools } from '@tanstack/router-devtools' // 1. Import qilish

export const Route = createRootRoute({
  component: RootComponent,
})

function RootComponent() {
  return (
    <>
      {/* Joriy sahifa komponentlari shu yerda chiziladi */}
      <Outlet />

      {/* 2. DevTools panelini ilovaning pastki burchagiga qo'shamiz */}
      <TanStackRouterDevtools position="bottom-right" initialIsOpen={false} />
    </>
  )
}

[!NOTE] position="bottom-right" orqali belgichaning ekranning qaysi burchagida turishini belgilaysiz (top-left, top-right, bottom-left, bottom-right).


2. Production muhiti uchun xavfsiz ulash (Code Splitting)

TanStackRouterDevtools odatda faqat development rejimida ko‘rinishi kerak. Production versiyada foydalanuvchilar brauzeriga ortiqcha og‘irlik tushmasligi uchun uni lazy-loading (dinamik import) orqali ulash tavsiya etiladi:

// src/routes/__root.tsx
import React from 'react'
import { createRootRoute, Outlet } from '@tanstack/react-router'

// Faqat development rejimida DevTools'ni dinamik yuklaymiz
const TanStackRouterDevtools =
  process.env.NODE_ENV === 'production'
    ? () => null // Production'da umuman bo'sh qoladi
    : React.lazy(() =>
        import('@tanstack/router-devtools').then((res) => ({
          default: res.TanStackRouterDevtools,
        }))
      )

export const Route = createRootRoute({
  component: () => (
    <>
      <Outlet />
      <React.Suspense fallback={null}>
        <TanStackRouterDevtools position="bottom-right" />
      </React.Suspense>
    </>
  ),
})

[!TIP] Bunday uslubda yozilganda, production build vaqtida Vite yoki boshqa bundler devtools kodini asosiy foydalanuvchi bundle fayliga kiritmaydi, natijada yuklanish tezligi maksimal bo‘ladi.


3. DevTools panelining 4 ta asosiy imkoniyati

Brauzer burchagidagi kichik TanStack piktogrammasini bosganingizda, to‘liq interaktiv boshqaruv paneli ochiladi:

flowchart TD
    Icon["TanStack Router DevTools Paneli"] --> Tree["1. Route Tree (Ierarxiya & Faol Route)"]
    Icon --> Matched["2. Matched Routes & Params (URL va Search)"]
    Icon --> Loaders["3. Loaders & Data (Yuklanish holati)"]
    Icon --> History["4. Navigation Timeline (Tarix va Harakatlar)"]

1. Vizual Route Tree (Marshrutlar daraxti)

Loyihangizdagi barcha marshrutlar ierarxiyasini (ota-bola munosabatlari, layoutlar va sahifalar) ko‘rsatadi. Ayni damda foydalanuvchi turgan sahifa (Active Route) yashil nishon bilan aniq ajratib ko‘rsatiladi.

2. Matched Routes va Type-safe Params

Joriy URL manzilga qaysi marshrutlar mos kelganini (matched chain) ko‘rasiz:

  • Path Params: Masalan, /users/:id manzilidagi { id: "105" } qiymatini.
  • Search Params (Query): Masalan, ?filter=active&page=2 kabi type-safe qidiruv parametrlarini. Agar parametrlar noto‘g‘ri pars qilingan bo‘lsa, qizil ogohlantirish beriladi.

3. Loaders va Data Inspection

Route'da ma'lumot yuklash (loader) funksiyasi bo‘lsa, uning hayot siklini ko‘rishingiz mumkin:

  • Ma'lumot ayni damda yuklanyaptimi (pending)?
  • Keshda tayyormi (fresh) yoki eskirganmi (stale)?
  • Serverdan qanday JSON ma'lumot keldi? Barchasini panel ichida qulay ko‘rish mumkin.

4. Navigation History va Action Logs

Foydalanuvchi qaysi sahifadan qayerga o‘tdi, push yoki replace orqali navigatsiya qilindimi — butun navigatsiya tarixi ketma-ketlikda qayd etiladi.


4. Nima uchun DevTools debugging jarayonini osonlashtiradi?

Muammo DevTools'siz (Eski usul) Router DevTools bilan
URL parametrlarini tekshirish Har bir komponent ichiga console.log(params) yozish Paneldagi Params bo‘limida real vaqtda ko‘rinadi
Search query validatsiyasi Xato qayerda bo‘lganini bilish qiyin Zod/Valibot xatolari panelda qizil rangda aniq ko‘rsatiladi
Qaysi layout ishlayotgani JSX kodini qidirib o‘rganish Route Tree'da ota-bola bog‘liqligi vizual ko‘rinadi
Loader ma'lumotlarini kuzatish Network tabida HTTP so‘rovlarni qidirish Loaders yorlig‘ida tayyor pars qilingan ma'lumot ko‘rinadi

5. DevTools'ning asosiy sozlamalari (Props)

<TanStackRouterDevtools /> komponenti bir qator foydali xususiyatlarga ega:

Prop Turi Tavsif
position 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' Ekranning qaysi burchagida turishi (Standart: 'bottom-right')
initialIsOpen boolean Sahifa yangilanganda panel ochiq holda turishi yoki yopiq bo‘lishi
panelProps React.HTMLAttributes<HTMLDivElement> Devtools paneliga maxsus CSS uslublar yoki sinflar berish
toggleButtonProps React.ButtonHTMLAttributes<HTMLButtonElement> Ochib-yopuvchi piktogramma tugmasining sozlamalari

Xulosa

  • @tanstack/router-devtools — navigatsiya oqimlarini vizual tahlil qiluvchi rasmiy debugging vositasidir.
  • U odatda __root.tsx faylida <Outlet /> yoniga ulanadi.
  • Production build'da ortiqcha hajm bo‘lmasligi uchun uni React.lazy orqali faqat development muhitida yuklash maqsadga muvofiqdir.
  • DevTools yordamida Route Tree, dinamik URL Params, Search Params va Loader ma'lumotlarini ortiqcha console.log()larsiz bir zumda tekshirish mumkin.