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

experimental_streamedQuery

更新于 2026-11-02 React 查看英文原文 ↗
TypeScript
1function experimental_streamedQuery<TQueryFnData = unknown, TData = TQueryFnData[], TQueryKey extends readonly unknown[] = readonly unknown[]>(options: StreamedQueryParams<TQueryFnData, TData, TQueryKey>): (context: object) => TData | Promise<TData>;

定义于:packages/query-core/src/streamedQuery.ts:70

这是一个辅助函数,用于创建一个从 AsyncIterable 流式传输数据的查询函数。
数据将是一个包含所有已接收数据块的数组。
该查询在接收到首个数据块前处于“等待中(pending)”状态,之后则转为“成功(success)”状态。
该查询的 fetchStatus 将一直保持为“拉取中(fetching)”,直至流结束。

类型参数

TQueryFnData

TQueryFnData = unknown

TData

TData = TQueryFnData[]

TQueryKey

TQueryKey extends readonly unknown[] = readonly unknown[]

参数

options

StreamedQueryParams<TQueryFnData, TData, TQueryKey>

一个 streamFn,它返回一个用于流式传输数据的 AsyncIterable,以及可选的 refetchMode、reducer 和 initialValue 选项。

返回值

一个可作为 queryFn 传入的查询函数。

(context: object) => TData | Promise<TData>

示例

TypeScript
1await queryClient.query({2  queryKey: ['data'],3  queryFn: streamedQuery({4    streamFn: fetchDataInChunks,5  }),6})

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

译自上游 59d11de