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

matchMutation

更新于 2026-11-02 Preact 查看英文原文 ↗
TypeScript
1function matchMutation(filters: MutationFilters, mutation: Mutation<any, any>): boolean;

定义于:packages/query-core/src/utils.ts:269

检查一个修改是否匹配给定的 MutationFilters。
所有指定的过滤器都必须匹配;未指定的过滤器会被忽略。
如果提供了 mutationKey 过滤器,但该修改自身没有 mutationKey,则不匹配。

参数

filters

MutationFilters

用于检查修改的过滤器。

filters 属性

属性 类型 描述
exact? boolean 精确匹配修改键
mutationKey? readonly unknown[] 包含匹配此修改键的修改
predicate? (mutation: Mutation<TData, TError, TVariables, TOnMutateResult>) => boolean 包含匹配此谓词函数的修改
status? "error" | "pending" | "success" | "idle" 按修改状态过滤

mutation

Mutation<any, any>

待检查的修改。

返回值

boolean

如果该修改匹配所有已指定的过滤器,则返回 true。

示例

TypeScript
1const mutationCache = queryClient.getMutationCache()2 3const matchingMutations = mutationCache4  .getAll()5  .filter((mutation) => matchMutation({ mutationKey: ['addPost'] }, mutation))

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

译自上游 59d11de