QueryObserverLoadingErrorResult

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

定义于：packages/query-core/src/types.ts:1187

当首次拉取失败、因此尚无任何数据时，查询结果所处的 error 状态。

继承自

QueryObserverBaseResult<TData, TError>

类型参数

TData

TData = unknown

TError

TError = DefaultError

属性

属性	类型	描述	重写自
`data`	`undefined`	`undefined`，因为首次拉取在任何数据被缓存前即已失败。	`QueryObserverBaseResult`.`data`
`dataUpdatedAt`	`number`	查询最近一次以 `status` 状态返回 `"success"` 的时间戳。	-
`error`	`TError`	首次拉取所失败的具体错误。	`QueryObserverBaseResult`.`error`
`errorUpdateCount`	`number`	所有错误的累计次数。	-
`errorUpdatedAt`	`number`	查询最近一次以 `status` 状态返回 `"error"` 的时间戳。	-
`failureCount`	`number`	查询失败次数。- 每次查询失败时递增。- 查询成功时重置为 `0`。	-
`failureReason`	`TError` \| `null`	查询重试的失败原因。- 查询成功时重置为 `null`。	-
`fetchStatus`	`"fetching"` \| `"paused"` \| `"idle"`	查询的拉取状态。- `fetching`：只要 queryFn 正在执行，即为 `true`，这包括初始 `pending` 及后台重新拉取。- `paused`：查询本应拉取，但已被 `paused`。- `idle`：查询未处于拉取中。- 更多信息请参阅 Network Mode。	-
`isEnabled`	`boolean`	若该观察者已启用，则为 `true`；否则为 `false`。	-
`isError`	`true`	`true`，因为查询当前处于 `error` 状态。	`QueryObserverBaseResult`.`isError`
`isFetched`	`boolean`	若查询已完成拉取，则为 `true`。	-
`isFetchedAfterMount`	`boolean`	若查询在组件挂载后已完成拉取，则为 `true`。- 该属性可用于避免显示任何先前缓存的数据。	-
`isFetching`	`boolean`	基于 `fetchStatus` 变量派生的布尔值，仅为使用便利。- 只要 `queryFn` 正在执行，即为 `true`，这包括初始 `pending` 及后台重新拉取。	-
~~`isInitialLoading`~~	`boolean`	已弃用 `isInitialLoading` 已被 `isLoading` 取代，将在下一个主版本中移除。	-
`isLoading`	`false`	`false`，因为首次拉取并未处于进行中。	`QueryObserverBaseResult`.`isLoading`
`isLoadingError`	`true`	`true`，因为查询在首次拉取过程中失败。	`QueryObserverBaseResult`.`isLoadingError`
`isPaused`	`boolean`	基于 `fetchStatus` 变量派生的布尔值，仅为使用便利。- 查询本应拉取，但已被 `paused`。	-
`isPending`	`false`	`false`，因为查询已有数据或某次查询尝试已结束。	`QueryObserverBaseResult`.`isPending`
`isPlaceholderData`	`false`	`false`，因为当前显示的数据并非 `placeholderData`。	`QueryObserverBaseResult`.`isPlaceholderData`
`isRefetchError`	`false`	`false`，因为查询在重新拉取过程中未失败。	`QueryObserverBaseResult`.`isRefetchError`
`isRefetching`	`boolean`	只要后台重新拉取正在进行中，即为 `true`（不包含初始 `pending`）。- 其值与 `isFetching && !isPending` 相同。	-
`isStale`	`boolean`	若缓存中的数据已被使失效，或数据已超过给定 `staleTime`，则为 `true`。	-
`isSuccess`	`false`	`false`，因为查询未处于 `success` 状态。	`QueryObserverBaseResult`.`isSuccess`
`refetch`	(`options?`: `RefetchOptions`) => `Promise`<`QueryObserverResult`<`TData`, `TError`>>	手动重新拉取查询的函数。	-
`status`	`"error"`	`'error'`，因为查询尝试最终导致了错误。	`QueryObserverBaseResult`.`status`