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:
- Routing va Navigatsiya: Foydalanuvchi qaysi sahifaga o‘tishi, URL holatlari, himoyalangan eshiklar (TanStack Router).
- 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.