用途:在 TanStack Query 中以查询方式读取和观察服务器状态,覆盖 useQuery、useQueries、createQuery、injectQuery、QueryObserver、QueryClient.fetchQuery、ensureQueryData 等接口,适用于 React 等框架的数据获取场景。
主要能力:可用 useQuery 声明式读取数据并按 isPending、isError、data 渲染;可用 QueryClient.fetchQuery 命令式拉取;用 ensureQueryData 为 loader 预取并确保缓存;通过 QueryObserver 观察查询;区分 status(数据状态)与 fetchStatus(暂停、获取中或空闲)。
用法示例:import { useQuery } from '@tanstack/react-query';queryKey 与 queryFn 为必要配置。命令式示例:queryClient.fetchQuery({ queryKey, queryFn });预取示例:queryClient.ensureQueryData({ queryKey, queryFn })。查询函数必须返回数据。
常见错误:查询函数无 return 会缓存 undefined;离线时只检查 isPending 会漏掉 paused,应检查 fetchStatus === 'paused';写入操作不应使用查询,应改用 useMutation 以处理生命周期、失效、回滚与状态。
限制:资料未提供安装命令、版本要求、收费与平台信息;其余细节暂未提供。