useQueries
useQueries hook 可用于获取可变数量的查询。
tsx
const ids = [1, 2, 3]
const results = useQueries({
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
staleTime: Infinity,
})),
})
const ids = [1, 2, 3]
const results = useQueries({
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
staleTime: Infinity,
})),
})
选项
useQueries hook 接受一个包含 queries 键的对象，其值是一个与 useQuery hook （不包括 queryClient 选项，因为 QueryClient 可以在顶层传递）的查询选项对象相同的对象数组。
- queryClient?: QueryClient
- 使用此选项提供自定义 QueryClient。否则，将使用最近的上下文中的 QueryClient。
- combine?: (result: UseQueriesResults) => TCombinedResult
- 使用此选项将查询结果合并为单个值。
在查询对象数组中多次出现相同的查询键可能会导致某些数据在查询之间共享。为避免这种情况，请考虑对查询进行去重，并将结果映射回所需的结构。
placeholderData
useQueries 也存在 placeholderData 选项，但它不像 useQuery 那样从先前渲染的 Queries 获取信息，因为 useQueries 的输入在每次渲染时可能都是不同数量的 Queries。
Returns (返回)
useQueries hook 返回一个包含所有查询结果的数组。返回的顺序与输入顺序相同。
组合
如果您想将结果中的 data（或其他 Query 信息）合并为单个值，可以使用 combine 选项。结果将在结构上共享，以尽可能保持引用稳定。
tsx
const ids = [1, 2, 3]
const combinedQueries = useQueries({
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
})),
combine: (results) => {
return {
data: results.map((result) => result.data),
pending: results.some((result) => result.isPending),
}
},
})
const ids = [1, 2, 3]
const combinedQueries = useQueries({
queries: ids.map((id) => ({
queryKey: ['post', id],
queryFn: () => fetchPost(id),
})),
combine: (results) => {
return {
data: results.map((result) => result.data),
pending: results.some((result) => result.isPending),
}
},
})
在上面的示例中，combinedQueries 将是一个包含 data 和 pending 属性的对象。请注意，Query 结果的所有其他属性都将丢失。
记忆化
combine 函数仅在以下情况重新运行时：
- combine 函数本身在引用上已更改
- 任何查询结果已更改
这意味着，如上所示的内联 combine 函数将在每次渲染时运行。为避免这种情况，可以将 combine 函数包装在 useCallback 中，或者如果它没有任何依赖项，则将其提取到稳定的函数引用中。
