MCPcopy Create free account
hub / github.com/TanStack/query / useMutation

Function useMutation

packages/preact-query/src/useMutation.ts:187–240  ·  view source on GitHub ↗
(
  options: UseMutationOptions<TData, TError, TVariables, TOnMutateResult>,
  queryClient?: QueryClient,
)

Source from the content-addressed store, hash-verified

185 * ```
186 */
187export function useMutation<
188 TData = unknown,
189 TError = DefaultError,
190 TVariables = void,
191 TOnMutateResult = unknown,
192>(
193 options: UseMutationOptions<TData, TError, TVariables, TOnMutateResult>,
194 queryClient?: QueryClient,
195): UseMutationResult<TData, TError, TVariables, TOnMutateResult> {
196 const client = useQueryClient(queryClient)
197
198 const [observer] = useState(
199 () =>
200 new MutationObserver<TData, TError, TVariables, TOnMutateResult>(
201 client,
202 options,
203 ),
204 )
205
206 useEffect(() => {
207 observer.setOptions(options)
208 }, [observer, options])
209
210 const result = useSyncExternalStore(
211 useCallback(
212 (onStoreChange) =>
213 observer.subscribe(notifyManager.batchCalls(onStoreChange)),
214 [observer],
215 ),
216 () => observer.getCurrentResult(),
217 )
218
219 const mutate = useCallback<
220 UseMutateFunction<TData, TError, TVariables, TOnMutateResult>
221 >(
222 (
223 ...args: Parameters<
224 UseMutateFunction<TData, TError, TVariables, TOnMutateResult>
225 >
226 ) => {
227 observer.mutate(args[0] as TVariables, args[1]).catch(noop)
228 },
229 [observer],
230 )
231
232 if (
233 result.error &&
234 shouldThrowError(observer.options.throwOnError, [result.error])
235 ) {
236 throw result.error
237 }
238
239 return { ...result, mutate, mutateAsync: result.mutate }
240}

Callers 15

TodoListUIFunction · 0.90
TodoListCacheFunction · 0.90
AppFunction · 0.90
DetailFunction · 0.90
EditTodoFunction · 0.90
AddTodoFunction · 0.90
MutationsFunction · 0.50
PageFunction · 0.50
DatesFunction · 0.50
MutateFunction · 0.50
PageFunction · 0.50

Calls 7

useQueryClientFunction · 0.90
useSyncExternalStoreFunction · 0.90
shouldThrowErrorFunction · 0.90
setOptionsMethod · 0.45
subscribeMethod · 0.45
getCurrentResultMethod · 0.45
mutateMethod · 0.45

Tested by 8

MutationsFunction · 0.40
PageFunction · 0.40
DatesFunction · 0.40
MutateFunction · 0.40
PageFunction · 0.40
MutatesFunction · 0.40
ComponentFunction · 0.40
MutationFunction · 0.40