译零 TransZero · TanStack Query 中文文档

主站

QueryState

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

定义于：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`：查询已有数据。