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

QueryCacheConfig

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

定义位置:packages/query-core/src/queryCache.ts:25

针对由 QueryCache 处理的每个查询所触发的全局回调函数,无论该查询是由哪个组件或观察者(observer)触发。与 QueryClient 的 defaultOptions 不同(查询可覆盖该选项),这些回调函数总会被调用。与 MutationCacheConfig 的回调函数不同,这些回调函数属于“即发即弃”(fire-and-forget)类型:其返回值不会在查询完成前被 await。

属性

属性 类型 描述
onError? (error: Error, query: Query<unknown, unknown, unknown>) => void 当缓存中的任意查询发生错误时调用。
onSettled? (data: unknown, error: Error | null, query: Query<unknown, unknown, unknown>) => void 当缓存中的任意查询完成时调用(无论成功或失败)。
onSuccess? (data: unknown, query: Query<unknown, unknown, unknown>) => void 当缓存中的任意查询成功时调用。

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

译自上游 59d11de