useQuery query fails (the query function throws an error), React Query will automatically retry the query if that query's request has not reached the max number of consecutive retries (defaults to
3) or a function is provided to determine if a retry is allowed.
You can configure retries both on a global level and an individual query level.
retry = falsewill disable retries.
retry = 6will retry failing requests 6 times before showing the final error thrown by the function.
retry = truewill infinitely retry failing requests.
retry = (failureCount, error) => ...allows for custom logic based on why the request failed.
By default, retries in React Query do not happen immediately after a request fails. As is standard, a back-off delay is gradually applied to each retry attempt.
retryDelay is set to double (starting at
1000ms) with each attempt, but not exceed 30 seconds:
Though it is not recommended, you can obviously override the
retryDelay function/integer in both the Provider and individual query options. If set to an integer instead of a function the delay will always be the same amount of time: