译零 TransZero · TanStack Query 中文文档
主站

QueryState

更新于 2026-11-02 React 查看英文原文 ↗

定义于:packages/query-core/src/query.ts:52

存储在 Query 实例上的原始状态。观察者结果(例如 QueryObserverResult)即由此底层状态派生而来。

类型参数

TData

TData = unknown

TError

TError = DefaultError

属性

属性 类型 描述
data TData | undefined 查询最后一次成功解析的数据。
dataUpdateCount number 查询成功解析的次数。
dataUpdatedAt number 查询最近一次返回 status 状态为 "success" 的时间戳。
error TError | null 查询的错误对象(如果上一次尝试以错误结束)。- 默认值为 null。
errorUpdateCount number 所有错误的总和;每次查询解析出错时递增。
errorUpdatedAt number 查询最近一次返回 status 状态为 "error" 的时间戳。
fetchFailureCount number 当前拉取操作的失败次数。- 每次拉取失败时递增。- 拉取成功时重置为 0。
fetchFailureReason TError | null 当前拉取失败的原因(由重试器报告)。- 拉取成功时重置为 null。
fetchMeta FetchMeta | null 传递给当前正在进行(或最近一次)拉取操作的元数据,例如无限查询中的 fetchMore 方向。
fetchStatus "fetching" | "paused" | "idle" 查询的拉取状态。- fetching: queryFn 正在执行中。- paused:拉取操作本应运行但已被暂停(参见网络模式)。- idle:查询未处于拉取状态。
isInvalidated boolean 查询是否已通过 invalidate() 被标记为失效。- 每次查询成功解析后重置为 false。
status "error" | "pending" | "success" 查询的状态。- pending:无缓存数据且尚无任何尝试完成。- error:上一次尝试以错误结束。- success:查询已有数据。

本页为 TanStack Query 文档(React 版)的非官方中文翻译,原文由上游团队维护,遵循 MIT 许可。 译文如有偏差,以英文原文为准。

译自上游 59d11de