| id | InfiniteQueryObserverBaseResult |
|---|---|
| title | InfiniteQueryObserverBaseResult |
Defined in: packages/query-core/src/types.ts:1024
QueryObserverBaseResult<TData,TError>
InfiniteQueryObserverPendingResultInfiniteQueryObserverLoadingResultInfiniteQueryObserverLoadingErrorResultInfiniteQueryObserverRefetchErrorResultInfiniteQueryObserverSuccessResultInfiniteQueryObserverPlaceholderResult
TData = unknown
TError = DefaultError
| Property | Type | Description |
|---|---|---|
data |
TData | undefined |
The last successfully resolved data for the query. |
dataUpdatedAt |
number |
The timestamp for when the query most recently returned the status as "success". |
error |
TError | null |
The error object for the query, if an error was thrown. - Defaults to null. |
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. |
fetchNextPage |
(options?: FetchNextPageOptions) => Promise<InfiniteQueryObserverResult<TData, TError>> |
This function allows you to fetch the next "page" of results. |
fetchPreviousPage |
(options?: FetchPreviousPageOptions) => Promise<InfiniteQueryObserverResult<TData, TError>> |
This function allows you to fetch the previous "page" of results. |
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. |
hasNextPage |
boolean |
Will be true if there is a next page to be fetched (known via the getNextPageParam option). |
hasPreviousPage |
boolean |
Will be true if there is a previous page to be fetched (known via the getPreviousPageParam option). |
isEnabled |
boolean |
true if this observer is enabled, false otherwise. |
isError |
boolean |
A derived boolean from the status variable, provided for convenience. - true if the query attempt resulted in an error. |
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. |
isFetchingNextPage |
boolean |
Will be true while fetching the next page with fetchNextPage. |
isFetchingPreviousPage |
boolean |
Will be true while fetching the previous page with fetchPreviousPage. |
isFetchNextPageError |
boolean |
Will be true if the query failed while fetching the next page. |
isFetchPreviousPageError |
boolean |
Will be true if the query failed while fetching the previous page. |
isInitialLoading |
boolean |
Deprecated isInitialLoading is being deprecated in favor of isLoading and will be removed in the next major version. |
isLoading |
boolean |
Is true whenever the first fetch for a query is in-flight. - Is the same as isFetching && isPending. |
isLoadingError |
boolean |
Will be true if the query failed while fetching for the first time. |
isPaused |
boolean |
A derived boolean from the fetchStatus variable, provided for convenience. - The query wanted to fetch, but has been paused. |
isPending |
boolean |
Will be pending if there's no cached data and no query attempt was finished yet. |
isPlaceholderData |
boolean |
Will be true if the data shown is the placeholder data. |
isRefetchError |
boolean |
Will be true if the query failed while refetching. |
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 |
boolean |
A derived boolean from the status variable, provided for convenience. - true if the query has received a response with no errors and is ready to display its data. |
refetch |
(options?: RefetchOptions) => Promise<QueryObserverResult<TData, TError>> |
A function to manually refetch the query. |
status |
"error" | "pending" | "success" |
The status of the query. - Will be: - pending if there's no cached data and no query attempt was finished yet. - error if the query attempt resulted in an error. - success if the query has received a response with no errors and is ready to display its data. |