Files
upstream-tanstack-query/docs/framework/vue/reference/interfaces/MutationCacheConfig.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

3.1 KiB

id, title
id title
MutationCacheConfig MutationCacheConfig

Defined in: packages/query-core/src/mutationCache.ts:26

Global callbacks that fire for every mutation handled by a MutationCache, regardless of which component or observer triggered it. They differ from the defaultOptions provided to a QueryClient in two ways: defaultOptions can be overridden by each mutation, while these callbacks are always called, and onMutate here does not allow returning a result.

If a callback returns a promise, it will be awaited before the mutation continues.

Properties

onError()?

optional onError: (error, variables, onMutateResult, mutation, context) => unknown;

Defined in: packages/query-core/src/mutationCache.ts:28

Called when any mutation in the cache encounters an error.

Parameters

error

Error

variables

unknown

onMutateResult

unknown

mutation

Mutation<unknown, unknown, unknown>

context

MutationFunctionContext

Returns

unknown


onMutate()?

optional onMutate: (variables, mutation, context) => unknown;

Defined in: packages/query-core/src/mutationCache.ts:44

Called before any mutation in the cache executes.

Parameters

variables

unknown

mutation

Mutation<unknown, unknown, unknown>

context

MutationFunctionContext

Returns

unknown


onSettled()?

optional onSettled: (data, error, variables, onMutateResult, mutation, context) => unknown;

Defined in: packages/query-core/src/mutationCache.ts:50

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

Parameters

data

unknown

error

Error | null

variables

unknown

onMutateResult

unknown

mutation

Mutation<unknown, unknown, unknown>

context

MutationFunctionContext

Returns

unknown


onSuccess()?

optional onSuccess: (data, variables, onMutateResult, mutation, context) => unknown;

Defined in: packages/query-core/src/mutationCache.ts:36

Called when any mutation in the cache is successful.

Parameters

data

unknown

variables

unknown

onMutateResult

unknown

mutation

Mutation<unknown, unknown, unknown>

context

MutationFunctionContext

Returns

unknown