SuperAPI AI 工具集

tanstack-query-intent-lifecycle-setup-query-client-and-providers

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:该技能用于在项目接入 TanStack Query 时创建 QueryClient,并通过对应框架的原生 Provider 将其提供给组件树,同时规避客户端重建与 SSR 缓存泄漏等常见问题。

主要能力与适配方式:React 与 Preact 使用 QueryClientProvider;Vue 使用 VueQueryPlugin;Angular 使用 provideTanStackQuery;Svelte 与 Lit 使用各自的 adapter provider/controller API。基础创建方式为 import { QueryClient, QueryClientProvider } from '@tanstack/react-query',并在 React 中用 React.useState(() => new QueryClient()) 保持实例稳定。也可从 @tanstack/query-core 创建客户端并配置 defaultOptions,例如 queries 的 staleTime 或 retry。

使用方式:在 SSR 场景中创建请求级客户端,如通过 createServerQueryClient() 或 createRequestQueryClient() 返回新实例,避免模块级共享;在集成边界可显式传入客户端,例如使用 ensureQueryData 配合 queryKey 与 queryFn 预取数据。Lit 控制器在元素不处于 provider 树内时需显式传入 queryClient。

限制与注意:禁止在每次渲染中新建 QueryClient,否则会丢弃缓存与订阅,应使用状态保存实例;禁止在服务端使用模块级共享客户端,否则可能把一个请求的缓存泄漏给另一个请求。SSR 的服务器缓存交接可参考 lifecycle/ssr-hydration-and-streaming。资料未提供收费、平台或效果相关内容。