Files
upstream-tanstack-query/docs/framework/react/reference/interfaces/QueryCacheConfig.md
upstream-mirror 3a013ccdfe
Some checks failed
autofix.ci / autofix (push) Failing after 4s
Release / Release (push) Has been skipped
GitHub Actions Security Analysis / Run zizmor (push) Failing after 2s
snapshot of https://github.com/TanStack/query.git (main, 2026-09-16; blobs > 131072B omitted)
2026-09-16 01:13:08 +05:00

1.8 KiB

id, title
id title
QueryCacheConfig QueryCacheConfig

Defined in: packages/query-core/src/queryCache.ts:25

Global callbacks that fire for every query handled by a QueryCache, regardless of which component or observer triggered it. Unlike QueryClient's defaultOptions, which a query can override, these callbacks are always called. Unlike MutationCacheConfig's callbacks, these are fire-and-forget: their return value is not awaited before the query settles.

Properties

onError()?

optional onError: (error, query) => void;

Defined in: packages/query-core/src/queryCache.ts:27

Called when any query in the cache encounters an error.

Parameters

error

Error

query

Query<unknown, unknown, unknown>

Returns

void


onSettled()?

optional onSettled: (data, error, query) => void;

Defined in: packages/query-core/src/queryCache.ts:34

Called when any query in the cache is settled, either successfully or with an error.

Parameters

data

unknown

error

Error | null

query

Query<unknown, unknown, unknown>

Returns

void


onSuccess()?

optional onSuccess: (data, query) => void;

Defined in: packages/query-core/src/queryCache.ts:32

Called when any query in the cache is successful.

Parameters

data

unknown

query

Query<unknown, unknown, unknown>

Returns

void