译零 TransZero · TanStack Query 中文文档
主站

MutationObserverErrorResult

更新于 2026-11-02 Vue 查看英文原文 ↗

定义于:packages/query-core/src/types.ts:2249

修改失败后、处于 error 状态的修改结果。

继承自

类型参数

TData

TData = unknown

TError

TError = DefaultError

TVariables

TVariables = void

TOnMutateResult

TOnMutateResult = unknown

属性

属性 类型 描述 重写自
context TOnMutateResult | undefined 若已定义 onMutate,则为其返回值;该值将作为修改的上下文传入 onSuccess、onError 和 onSettled。 -
data undefined undefined,因为修改尚未成功。 MutationObserverBaseResult.data
error TError 导致修改失败的错误。 MutationObserverBaseResult.error
failureCount number 当前尝试中,修改函数失败的次数。 -
failureReason TError | null 重试器(retryer)报告的当前尝试失败原因。 -
isError true true,因为修改已失败。 MutationObserverBaseResult.isError
isIdle false false,因为修改已执行。 MutationObserverBaseResult.isIdle
isPaused boolean 修改当前是否已暂停(参见网络模式),或是否正在等待另一个具有相同 scope 的修改完成。 -
isPending false false,因为修改未运行。 MutationObserverBaseResult.isPending
isSuccess false false,因为修改尚未成功。 MutationObserverBaseResult.isSuccess
mutate MutateFunction<TData, TError, TVariables, TOnMutateResult> 你可调用的修改函数,传入变量以触发修改,并可选择性地通过额外回调选项挂载钩子。
参数 variables 传入 mutationFn 的变量对象。
参数 options.onSuccess 修改成功时调用,接收修改结果作为参数。
参数 options.onError 修改出错时调用,接收错误作为参数。
参数 options.onSettled 修改成功或出错后均会调用,接收数据或错误作为参数。
说明
- 若你发起多次请求,onSuccess 仅在你最近一次调用完成后触发。
- 所有回调函数(onSuccess、onError、onSettled)均为 void 函数,其返回值将被忽略。
-
reset () => void 用于清理修改内部状态的函数(即,将修改重置为其初始状态)。 -
status "error" 'error',因为修改已失败。 MutationObserverBaseResult.status
submittedAt number 修改提交的时间戳。 -
variables TVariables 传给 mutate 的本次修改所用变量。 MutationObserverBaseResult.variables

本页为 TanStack Query 文档(Vue 版)的非官方中文翻译,原文由上游团队维护,遵循 MIT 许可。 译文如有偏差,以英文原文为准。

译自上游 59d11de