add reset method to useMutation hook

[phryneas]

This would resolve #1455.

Also, it eliminiates all useRef usages in the useMutation hook, which is probably not a bad thing.

[netlify]

✔️ Deploy Preview for redux-starter-kit-docs ready!

🔨 Explore the source changes: 6d09682

🔍 Inspect the deploy log: https://app.netlify.com/sites/redux-starter-kit-docs/deploys/6144ef096362f000071c68e3

😎 Browse the preview: https://deploy-preview-1476--redux-starter-kit-docs.netlify.app

[github-actions]

size-limit report 📦

Path	Size
1. entry point: @reduxjs/toolkit (cjs.production.min.js)	12.28 KB (0%)
1. entry point: @reduxjs/toolkit (esm.js)	10.27 KB (0%)
1. entry point: @reduxjs/toolkit/query (cjs.production.min.js)	20.42 KB (+0.07% 🔺)
1. entry point: @reduxjs/toolkit/query (esm.js)	17.43 KB (+0.11% 🔺)
1. entry point: @reduxjs/toolkit/query/react (cjs.production.min.js)	22.44 KB (+0.09% 🔺)
1. entry point: @reduxjs/toolkit/query/react (esm.js)	20 KB (+0.05% 🔺)
2. entry point: @reduxjs/toolkit (without dependencies) (cjs.production.min.js)	5.6 KB (0%)
2. entry point: @reduxjs/toolkit (without dependencies) (esm.js)	5.58 KB (0%)
2. entry point: @reduxjs/toolkit/query (without dependencies) (cjs.production.min.js)	9.22 KB (+0.16% 🔺)
2. entry point: @reduxjs/toolkit/query (without dependencies) (esm.js)	9.6 KB (+0.18% 🔺)
2. entry point: @reduxjs/toolkit/query/react (without dependencies) (cjs.production.min.js)	2.52 KB (-0.16% 🔽)
2. entry point: @reduxjs/toolkit/query/react (without dependencies) (esm.js)	2.35 KB (-0.29% 🔽)
3. createSlice (esm.js)	5.16 KB (0%)
3. createEntityAdapter (esm.js)	5.83 KB (0%)
3. configureStore (esm.js)	5.83 KB (0%)
3. createApi (esm.js)	15.74 KB (+0.12% 🔺)
3. createApi (react) (esm.js)	18.25 KB (+0.1% 🔺)
3. fetchBaseQuery (esm.js)	10.98 KB (0%)
3. setupListeners (esm.js)	9.86 KB (0%)
3. ApiProvider (esm.js)	17.16 KB (+0.1% 🔺)

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit 6d09682:

Sandbox	Source
Vanilla	Configuration
Vanilla Typescript	Configuration
rsk-github-issues-example	Configuration
@examples-query-react/basic	Configuration
@examples-query-react/advanced	Configuration

[taejs]

Is there no need to update query results using same tags?

[phryneas]

@taejs after just clearing a mutation result? That does not mean the mutation has run again or anything was sent to the server, it just means the component does not want to display the result anymore

[LhonRafaat]

when is this gonna be available? @phryneas

[phryneas]

@LhonRafaat next minor release. Could still be a month or two, given what else we want in there. In the meantime you can either use the CodeSandbox build linked above or do something like

const lastMutation = useRef(undefined)
const [trigger] = useMyMutation()


// when triggering:
lastMutation.current = trigger(arg);


// to reset
lastMuation.current.unsubscribe()

[Shrugsy]

@phryneas the spelling & wording threads are still open, but besides that, LGTM!