Seriya: TanStack Router Dars 62

TanStack Query integration — Router va server-state cache'ni birlashtirish

TanStack Router va TanStack Query integratsiyasi: queryOptions, ensureQueryData bilan loader'ni bog'lash, context orqali inyeksiya, preloading va React Router bilan taqqos.

62-dars

TanStack Query integration — Router va server-state cache'ni birlashtirish

Veb-ilovalarda ma'lumotlar bilan ishlashda ikkita katta vazifa bor:

  1. Routing va Navigatsiya: Foydalanuvchi qaysi sahifaga o‘tishi, URL holatlari, himoyalangan eshiklar (TanStack Router).
  2. Server Holati va Keshlash: Serverdan ma'lumot olish, fon yangilanishlari (background refetch), keshni boshqarish va mutatsiyalar (TanStack Query).

Ikkala kutubxona ham bir xil mualliflar jamoasi (TanStack) tomonidan yaratilgani sababli, ular kalit va qulf kabi bir-biriga mukammal mos tushadi.


1. Hayotiy o‘xshatish: Tezyurar poyezd va Vagon-restoran

Tasavvur qiling, siz tezyurar qulay poyezdda sayohat qilyapsiz:

  • TanStack Router: Bu poyezdning o‘zi va relslar tizimi. U sizni qaysi stansiyaga (Route) xavfsiz va tez olib borishga mas'ul.
  • TanStack Query: Bu poyezd ichidagi professional vagon-restoran va muzlatgichli oziq-ovqat ombori (Server State Cache).

Poyezd yangi bekatga yetib kelishidan oldinroq (Preloading / Loader), vagon-restoran sizning sevimli taomingizni stolga tayyorlab qo‘yadi (ensureQueryData). Siz kupengizga kirganingizda, ovqat pishishini kutib o‘tirmaysiz — darhol issiq taomga ega bo‘lasiz!


2. Integratsiyaning "Oltin Qoidasi" (queryOptions + ensureQueryData)

TanStack Router va Query'ni birlashtirishning eng professional standarti — bu queryOptions() yordamida yagona konfiguratsiya yaratish va uni loader ichida context.queryClient.ensureQueryData() orqali chaqirishdir.

1-qadam: Root Context'ga queryClientni kiritish

// src/routes/__root.tsx
import { createRootRouteWithContext, Outlet } from '@tanstack/react-router'
import type { QueryClient } from '@tanstack/react-query'

export interface RouterContext {
  queryClient: QueryClient
}

export const Route = createRootRouteWithContext<RouterContext>()({
  component: () => <Outlet />,
})
// src/router.tsx
import { createRouter } from '@tanstack/react-router'
import { QueryClient } from '@tanstack/react-query'
import { routeTree } from './routeTree.gen'

export const queryClient = new QueryClient()

export const router = createRouter({
  routeTree,
  context: {
    queryClient,
  },
})

2-qadam: Qayta ishlatiluvchi queryOptions va Loader

Har bir ma'lumot manbai uchun queryOptions e'lon qilamiz. Bu obyekt ham route loader'ida, ham komponent ichida bir xil ishlatiladi:

// src/routes/posts/index.tsx
import { createFileRoute } from '@tanstack/react-router'
import { queryOptions, useSuspenseQuery } from '@tanstack/react-query'

// A. Qayta ishlatiluvchi so'rov qoidasi
export const postsQueryOptions = queryOptions({
  queryKey: ['posts'],
  queryFn: async () => {
    const res = await fetch('https://api.example.com/posts')
    if (!res.ok) throw new Error('Postlarni yuklab bo‘lmadi')
    return res.json()
  },
  staleTime: 1000 * 60 * 5, // 5 daqiqa davomida kesh fresh turadi
})

export const Route = createFileRoute('/posts/')({
  // B. Loader ichida Query keshini tekshiramiz/to'ldiramiz
  loader: ({ context }) => {
    return context.queryClient.ensureQueryData(postsQueryOptions)
  },

  component: PostsListPage,
})

function PostsListPage() {
  // C. Komponent ichida useSuspenseQuery orqali keshdan ma'lumotni o'qiymiz
  // Loader ma'lumotni oldindan keshga solib qo'ygani uchun SPINNER BO'LMAYDI!
  const { data: posts } = useSuspenseQuery(postsQueryOptions)

  return (
    <div className="posts-container">
      <h1>Barcha Maqolalar</h1>
      <ul>
        {posts.map((post: any) => (
          <li key={post.id}>{post.title}</li>
        ))}
      </ul>
    </div>
  )
}

[!NOTE] ensureQueryData() metodi juda aqlli: agar ma'lumot allaqachon keshda mavjud va fresh bo‘lsa, u serverga qayta so‘rov yubormaydi (Deduplication). Agar keshda bo‘lmasa, serverdan yuklab, keshga saqlab qo‘yadi.


3. Preload (preload="intent") bilan mo‘jizaviy tezlik

Foydalanuvchi kursorini havola ustiga olib borganida (hover), TanStack Router uning loaderini fonda ishga tushiradi:

<Link to="/posts" preload="intent">
  Maqolalar
</Link>

Loader ichidagi ensureQueryData() TanStack Query orqali ma'lumotni darhol yuklab, uning keshiga joylaydi. Foydalanuvchi linkni bosgan ondayoq sahifa 0 millisoniya kechikish bilan ochiladi!


4. Arxitektura va Ma'lumot oqimi (Mermaid Diagram)

flowchart TD
    User["Foydalanuvchi link ustiga kursor olib bordi (preload='intent')"] --> Loader["Route loader() ishga tushadi"]

    Loader --> Ensure["queryClient.ensureQueryData(postsQueryOptions)"]

    Ensure --> CacheCheck{"Ma'lumot Query keshida bormi?"}
    
    CacheCheck -- "HA (Fresh)" --> Instant["0 ms da keshdan qaytadi (Tarmoq so'rovisiz!)"]
    CacheCheck -- "YO'Q / Stale" --> FetchAPI["Serverdan yangi ma'lumot yuklanadi va keshga yoziladi"]

    Instant & FetchAPI --> CacheReady["Query Cache to'liq tayyor!"]

    UserClick["Foydalanuvchi linkni bosdi"] --> Mount["PostsListPage komponenti mount bo'ladi"]
    Mount --> Suspense["useSuspenseQuery() keshdagi tayyor ma'lumotni bir zumda o'qiydi"]
    Suspense --> UI["Ekranda 0 miltillash bilan sahifa ochiladi!"]

5. React Router va TanStack Router + Query taqqosi

Xususiyat Oddiy React Router TanStack Router + TanStack Query
Server State keshini boshqarish ❌ O‘rnatilgan emas (har safar yangi fetch) ✅ TanStack Query'ning kuchli In-Memory keshi
Deduplication (Dublikat so‘rovlar) Yo‘q (bir xil so‘rovlar takrorlanaveradi) ✅ Bir xil so‘rovlar avtomatik birlashtiriladi
Preloading sinergiyasi Qiyin va ko‘p kod talab etiladi preload="intent" + ensureQueryData bir qatorda
Type Safety Loader va komponent alohida tiplanadi queryOptions() orqali 100% yagona type manbasi
Mutatsiyadan keyingi yangilanish Sahifani to‘liq qayta yuklash kerak queryClient.invalidateQueries() orqali bir zumda

Xulosa

  • TanStack Router va TanStack Query kombinatsiyasi zamonaviy React ilovalari uchun eng mukammal arxitekturaviy juftlikdir.
  • queryOptions() orqali so‘rov parametrlari, kalitlari va turlari yagona joyda saqlanadi.
  • ensureQueryData() marshrut ochilishidan oldin ma'lumotni keshga tayyorlab qo‘yadi, natijada sahifada aylanuvchi spinnerlar yo‘qoladi.
  • preload="intent" bilan birgalikda sayt foydalanuvchiga mahalliy dasturlardek (native apps) lahzalik tezlik bag‘ishlaydi.