mirror of
https://github.com/TanStack/query.git
synced 2026-11-16 22:50:20 +00:00
* docs(query-core/types): describe 'status', 'isPending', 'isSuccess' and 'isError' of the query result by its current data and error
* docs(query-core/types): describe 'isLoadingError', 'isRefetchError' and the error result types by the current data and error, including 'select' failures
* docs(query-core/types): note that 'isRefetchError' is 'false' after a failed page fetch in infinite queries
* docs({query-core,react,preact,vue,solid,svelte,angular}-query): describe 'success' and 'pending' by cached data and 'placeholderData' since 'select' can return 'undefined'
* docs({query-core,react,preact,vue,solid,svelte,angular}-query): describe 'success' by cached data or data from 'placeholderData', and limit the 'select' returning 'undefined' case to cached data
* docs(docs/framework): revert generated reference pages to leave them to the post-merge workflow
* docs(docs/framework): regenerate reference pages with 'generate-docs'
6 KiB
6 KiB
| id | title |
|---|---|
| QueryObserverLoadingResult | QueryObserverLoadingResult |
Defined in: packages/query-core/src/types.ts:1138
A query result in the pending state while the first fetch is in flight, so isLoading is
true.
Extends
QueryObserverBaseResult<TData,TError>
Type Parameters
TData
TData = unknown
TError
TError = DefaultError
Properties
| Property | Type | Description | Overrides |
|---|---|---|---|
data |
undefined |
undefined, since the query has no data yet. |
QueryObserverBaseResult.data |
dataUpdatedAt |
number |
The timestamp for when the query most recently returned the status as "success". |
- |
error |
null |
null, since the query isn't in the error state. |
QueryObserverBaseResult.error |
errorUpdateCount |
number |
The sum of all errors. | - |
errorUpdatedAt |
number |
The timestamp for when the query most recently returned the status as "error". |
- |
failureCount |
number |
The failure count for the query. - Incremented every time the query fails. - Reset to 0 when the query succeeds. |
- |
failureReason |
TError | null |
The failure reason for the query retry. - Reset to null when the query succeeds. |
- |
fetchStatus |
"fetching" | "paused" | "idle" |
The fetch status of the query. - fetching: Is true whenever the queryFn is executing, which includes initial pending as well as background refetch. - paused: The query wanted to fetch, but has been paused. - idle: The query is not fetching. - See Network Mode for more information. |
- |
isEnabled |
boolean |
true if this observer is enabled, false otherwise. |
- |
isError |
false |
false, since the query isn't in the error state. |
QueryObserverBaseResult.isError |
isFetched |
boolean |
Will be true if the query has been fetched. |
- |
isFetchedAfterMount |
boolean |
Will be true if the query has been fetched after the component mounted. - This property can be used to not show any previously cached data. |
- |
isFetching |
boolean |
A derived boolean from the fetchStatus variable, provided for convenience. - true whenever the queryFn is executing, which includes initial pending as well as background refetch. |
- |
isInitialLoading |
boolean |
Deprecated isInitialLoading is being deprecated in favor of isLoading and will be removed in the next major version. |
- |
isLoading |
true |
true, since the first fetch is in flight. |
QueryObserverBaseResult.isLoading |
isLoadingError |
false |
false, since the query didn't fail while fetching for the first time. |
QueryObserverBaseResult.isLoadingError |
isPaused |
boolean |
A derived boolean from the fetchStatus variable, provided for convenience. - The query wanted to fetch, but has been paused. |
- |
isPending |
true |
true, since the query has no cached data, no data from placeholderData and no error. |
QueryObserverBaseResult.isPending |
isPlaceholderData |
false |
false, since the data shown isn't the placeholderData. |
QueryObserverBaseResult.isPlaceholderData |
isRefetchError |
false |
false, since the query didn't fail while refetching. |
QueryObserverBaseResult.isRefetchError |
isRefetching |
boolean |
Is true whenever a background refetch is in-flight, which does not include initial pending. - Is the same as isFetching && !isPending. |
- |
isStale |
boolean |
Will be true if the data in the cache is invalidated or if the data is older than the given staleTime. |
- |
isSuccess |
false |
false, since the query isn't in the success state. |
QueryObserverBaseResult.isSuccess |
refetch |
(options?: RefetchOptions) => Promise<QueryObserverResult<TData, TError>> |
A function to manually refetch the query. | - |
status |
"pending" |
'pending', since the query has no cached data, no data from placeholderData and no error. |
QueryObserverBaseResult.status |