Open History to see the last commit
1---
2id: mutationOptions
3title: mutationOptions
4---
5β
6## Overview
7β
8```ts
9function mutationOptions<TData, TError, TVariables, TOnMutateResult>(options: WithRequired<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">): WithRequired<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">;
10function mutationOptions<TData, TError, TVariables, TOnMutateResult>(options: Omit<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">): Omit<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">;
11```
12β
13- [`WithRequired<CreateMutationOptions>` β `WithRequired<CreateMutationOptions>`](#call-signature-1): You can generally pass everything to `mutationOptions` that you can also pass to `injectMutation`. A `mutationKey` is required on this overload so the mutation can be looked up later, e.g. with `injectMutationState`.
14- [`Omit<CreateMutationOptions>` β `Omit<CreateMutationOptions>`](#call-signature-2): You can generally pass everything to `mutationOptions` that you can also pass to `injectMutation`. No `mutationKey` is required on this overload β use this when you don't need to target the mutation via a `mutationKey` filter later (e.g. with `injectMutationState`); it can still be observed through other filters, such as `status`.
15β
16See also: [Parameters](#parameters-summary) Β· [Returns](#returns-summary)
17β
18<a id="call-signature-1"></a>
19β
20## Call Signature
21β
22```ts
23function mutationOptions<TData, TError, TVariables, TOnMutateResult>(options: WithRequired<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">): WithRequired<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">;
24```
25β
26Defined in: [packages/angular-query-experimental/src/mutation-options.ts:38](https://github.com/TanStack/query/blob/main/packages/angular-query-experimental/src/mutation-options.ts#L38)
27β
28You can generally pass everything to `mutationOptions` that you can also pass to `injectMutation`. A
29`mutationKey` is required on this overload so the mutation can be looked up later, e.g. with
30`injectMutationState`.
31β
32### Type Parameters
33β
34#### TData
35β
36`TData` = `unknown`
37β
38#### TError
39β
40`TError` = `Error`
41β
42#### TVariables
43β
44`TVariables` = `void`
45β
46#### TOnMutateResult
47β
48`TOnMutateResult` = `unknown`
49β
50### Parameters
51β
52#### options
53β
54[`WithRequired`](../type-aliases/WithRequired.md)\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
55β
56The mutation options to use, identical to what you'd pass to `injectMutation`, with a
57required `mutationKey`.
58β
59### Returns
60β
61[`WithRequired`](../type-aliases/WithRequired.md)\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
62β
63The same options object, unchanged.
64β
65### See
66β
67[injectMutation](injectMutation.md) to run the mutation these options describe.
68β
69### Example
70β
71Looking the mutation up elsewhere via its `mutationKey`, e.g. for a global "savingβ¦" indicator:
72```angular-ts
73import { mutationOptions, injectMutationState } from '@tanstack/angular-query-experimental'
74β
75const createPostOptions = mutationOptions({
76 mutationKey: ['posts', 'create'],
77 mutationFn: createPost,
78})
79β
80@Component({
81 selector: 'saving-indicator',
82 template: `
83 @if (isCreatingPost()) {
84 <span>Savingβ¦</span>
85 }
86 `,
87})
88export class SavingIndicator {
89 readonly #pendingCreates = injectMutationState(() => ({
90 filters: { mutationKey: createPostOptions.mutationKey, status: 'pending' },
91 }))
92 readonly isCreatingPost = computed(() => this.#pendingCreates().length > 0)
93}
94```
95β
96<a id="call-signature-2"></a>
97β
98## Call Signature
99β
100```ts
101function mutationOptions<TData, TError, TVariables, TOnMutateResult>(options: Omit<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">): Omit<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationKey">;
102```
103β
104Defined in: [packages/angular-query-experimental/src/mutation-options.ts:94](https://github.com/TanStack/query/blob/main/packages/angular-query-experimental/src/mutation-options.ts#L94)
105β
106You can generally pass everything to `mutationOptions` that you can also pass to `injectMutation`. No
107`mutationKey` is required on this overload β use this when you don't need to target the mutation via a
108`mutationKey` filter later (e.g. with `injectMutationState`); it can still be observed through other
109filters, such as `status`.
110β
111### Type Parameters
112β
113#### TData
114β
115`TData` = `unknown`
116β
117#### TError
118β
119`TError` = `Error`
120β
121#### TVariables
122β
123`TVariables` = `void`
124β
125#### TOnMutateResult
126β
127`TOnMutateResult` = `unknown`
128β
129### Parameters
130β
131#### options
132β
133`Omit`\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
134β
135The mutation options to use, identical to what you'd pass to `injectMutation`, without a
136`mutationKey`.
137β
138### Returns
139β
140`Omit`\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
141β
142The same options object, unchanged.
143β
144### Remarks
145β
146See the other overload's example for looking a mutation up via `injectMutationState`.
147β
148### See
149β
150[injectMutation](injectMutation.md) to run the mutation these options describe.
151β
152### Example
153β
154Sharing options across services, so `QueriesService` stays the single place a mutation is defined:
155```angular-ts
156import { mutationOptions, injectMutation } from '@tanstack/angular-query-experimental'
157β
158@Injectable({ providedIn: 'root' })
159export class QueriesService {
160 readonly #queryClient = inject(QueryClient)
161β
162 updatePost(id: number) {
163 return mutationOptions({
164 mutationFn: (post: Partial<Post>) => putPost(id, post),
165 onSuccess: (newPost) => this.#queryClient.setQueryData(['posts', id], newPost),
166 })
167 }
168}
169β
170@Component({
171 selector: 'post',
172 template: `<button (click)="save()">Save</button>`,
173})
174export class Post {
175 readonly queries = inject(QueriesService)
176 readonly id = signal(0)
177 readonly updatePostMutation = injectMutation(() => this.queries.updatePost(this.id()))
178β
179 save() {
180 this.updatePostMutation.mutate({ title: 'New Title' })
181 }
182}
183```
184β
185<a id="parameters-summary"></a>
186β
187## Parameters
188β
189### options
190β
191`Omit`\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
192β
193The mutation options to use, identical to what you'd pass to `injectMutation`, without a
194`mutationKey`.
195β
196<a id="options-properties"></a>
197β
198#### `options` properties
199β
200Built from [`CreateMutationOptions`](../interfaces/CreateMutationOptions.md#properties). See the type above for what it changes.
201β
202<a id="returns-summary"></a>
203β
204## Returns
205β
206`Omit`\<[`CreateMutationOptions`](../interfaces/CreateMutationOptions.md)\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>, `"mutationKey"`\>
207β
208The same options object, unchanged.
209β
210<a id="result-properties"></a>
211β
212### Result properties
213β
214Built from [`CreateMutationOptions`](../interfaces/CreateMutationOptions.md#properties). See the type above for what it changes.