SuperAPI AI 工具集

tanstack-query-advanced

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:整理 TanStack Query v5 的服务端状态管理进阶用法,适合在 React 应用中实现数据获取、缓存与同步。

主要能力:基于游标的无限查询与分页(useInfiniteQuery、getNextPageParam);乐观更新与回滚(onMutate 中 cancelQueries、快照旧值、setQueryData,onError 回滚,onSettled 失效重取);预取(hover 预取、React Router loader 中 ensureQueryData);缓存失效(invalidateQueries 精确/前缀/predicate、refetchQueries、removeQueries);依赖查询(enabled 控制)与并行查询(useQueries 配合 combine);Suspense 集成(useSuspenseQuery);变更状态跟踪(useMutationState);QueryClient 默认配置(staleTime、gcTime、refetchOnWindowFocus、retry、retryDelay)。

使用方式:以 queryOptions 定义可复用的查询配置,供 useQuery、prefetchQuery、ensureQueryData 共用;查询键使用数组;v5 中用 isPending 表示首次加载、gcTime 替代 cacheTime。

限制与反模式:不要把服务端状态存入 Zustand/Redux;不要用字符串查询键;不要用已废弃的 cacheTime;不要用 isLoading 判断首次加载;避免 onSuccess 中全量 invalidateQueries;乐观更新必须取消在途查询并返回回滚上下文;不要直接修改缓存数据,应返回新数组;不要在 useEffect 中手动 fetch。

资料未提供该技能的安装命令、收费方式与具体平台支持信息。