[TanStack Query v5] useMutation callback と mutate callback の挙動の違い

こんにちは、株式会社カナリーでソフトウェアエンジニアをやっている matsu です。 先日 TanStack Query の mutation 処理で思わぬ落とし穴に遭遇したのですが、ドキュメントや解説記事が見当たらなかったので、本記事にて知見を共有します 🐈‍⬛ はじめに TanStack Query の mutation 処理では、onSuccess / onError / onSettled オプションにより、mutation 処理後に実行される callback 関数を登録できます。 これらの callback 関数は、React の場合、useMutation と mutate (mutateAsync) の両方で指定可能です (Vue や Svelte 等の他の FW でも関数名は異なれど同様です)。 例えば以下のようなイメージ。 import { useMutation }