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

InvalidateQueryFilters

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

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

queryClient.invalidateQueries 的过滤器:用于选择要使失效的查询的 QueryFilters,外加 refetchType 以决定其中哪些查询将被重新拉取。

继承自

类型参数

TQueryKey

TQueryKey extends QueryKey = QueryKey

属性

属性 类型 默认值 描述
exact? boolean undefined 精确匹配查询键
fetchStatus? "fetching" | "paused" | "idle" undefined 包含匹配其 fetchStatus 的查询
predicate? (query: Query) => boolean undefined 包含匹配此谓词函数的查询
queryKey? TQueryKey | TuplePrefixes<TQueryKey> undefined 包含匹配此查询键的查询
refetchType? QueryTypeFilter | "none" 'active' 控制哪些已匹配(现已被标记为失效)的查询将在后台重新拉取。- 'active':仅重新拉取至少有一个活跃观察者(active observer)的查询。- 'inactive':仅重新拉取没有活跃观察者的查询。- 'all':所有已匹配的查询均被重新拉取,无论是否活跃。- 'none':不重新拉取任何查询;仅将已匹配的查询标记为失效。
stale? boolean undefined 包含或排除过期(stale)查询
type? QueryTypeFilter 'all' 过滤活跃查询、非活跃查询或全部查询

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

译自上游 59d11de