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

keepPreviousData

更新于 2026-11-02 Preact 查看英文原文 ↗
TypeScript
1function keepPreviousData<T>(previousData: T | undefined): T | undefined;

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

该函数旨在作为查询的 placeholderData 选项传入,例如 placeholderData: keepPreviousData。当使用新的查询键拉取数据时,它不会将查询的数据重置为 undefined,而是继续显示上一次拉取到的数据,直至新数据到达。

类型参数

T

T

参数

previousData

T | undefined

观察者传入的上一个查询键的数据。

返回值

T | undefined

未经修改的上一个数据。

示例

TypeScript
1new QueryObserver(queryClient, {2  queryKey: ['posts', page],3  queryFn: () => fetchPosts(page),4  placeholderData: keepPreviousData,5})

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

译自上游 59d11de