snapshot of https://github.com/TanStack/query.git (main, 2026-09-16; blobs > 131072B omitted)

docs/framework/preact/reference/functions/useIsMutating.md

@@ -0,0 +1,47 @@
+---
+id: useIsMutating
+title: useIsMutating
+---
+
+```ts
+function useIsMutating(filters?, queryClient?): number;
+```
+
+Defined in: [packages/preact-query/src/useMutationState.ts:35](https://github.com/TanStack/query/blob/main/packages/preact-query/src/useMutationState.ts#L35)
+
+The `useIsMutating` hook returns the `number` of mutations that your application currently has `pending`
+(useful for app-wide loading indicators).
+
+## Parameters
+
+### filters?
+
+[`MutationFilters`](../interfaces/MutationFilters.md)\<`unknown`, `Error`, `unknown`, `unknown`\>
+
+The [MutationFilters](../interfaces/MutationFilters.md) to narrow down the matched mutations.
+
+### queryClient?
+
+[`QueryClient`](../classes/QueryClient.md)
+
+Use this to use a custom `QueryClient`. Otherwise, the one from the nearest context will
+be used.
+
+## Returns
+
+`number`
+
+Will be the `number` of the mutations that your application currently has `pending`.
+
+## Example
+
+```tsx
+import { useIsMutating } from '@tanstack/preact-query'
+
+function PostsMutatingIndicator() {
+  // How many mutations matching the posts prefix are in progress?
+  const isMutatingPosts = useIsMutating({ mutationKey: ['posts'] })
+
+  return isMutatingPosts ? <span>Saving posts...</span> : null
+}
+```