Skip to content
Source
Sign inSign up
TanStack/query
Open History to see the last commit

useSuspenseQueries.md

440 lines21.7 KB

1---
2id: useSuspenseQueries
3title: useSuspenseQueries
4redirect_from:
5 - framework/react/reference/useSuspenseQueries
6---
7​
8<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
9​
10## Overview
11​
12```ts
13function useSuspenseQueries<T extends any[], TCombinedResult = T extends [] ? [] : T extends [Head] ? [GetUseSuspenseQueryResult<Head>] : T extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...(...)[]] extends [] ? [] : ... extends ... ? ... : ... : [...{ [K in (...)]: (...) }[]] : [...{ [K in string | number | symbol]: GetUseSuspenseQueryResult<Tails[K]> }[]] : { [K in string | number | symbol]: GetUseSuspenseQueryResult<T[K]> }>(options: object, queryClient?: QueryClient): TCombinedResult;
14function useSuspenseQueries<T extends any[], TCombinedResult = T extends [] ? [] : T extends [Head] ? [GetUseSuspenseQueryResult<Head>] : T extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...(...)[]] extends [] ? [] : ... extends ... ? ... : ... : [...{ [K in (...)]: (...) }[]] : [...{ [K in string | number | symbol]: GetUseSuspenseQueryResult<Tails[K]> }[]] : { [K in string | number | symbol]: GetUseSuspenseQueryResult<T[K]> }>(options: object, queryClient?: QueryClient): TCombinedResult;
15```
16​
17- [`{ queries, combine }` → `TCombinedResult`](#call-signature-1): The options for `useSuspenseQueries` are the same as for `useQueries`, except that the top-level `subscribed` option isn't supported, and each `query` can't have `throwOnError`, `enabled`, or `placeholderData`.
18- [`{ queries, combine }` → `TCombinedResult`](#call-signature-2): The options for `useSuspenseQueries` are the same as for `useQueries`, except that the top-level `subscribed` option isn't supported, and each `query` can't have `throwOnError`, `enabled`, or `placeholderData`.
19​
20See also: [Parameters](#parameters-summary) · [Returns](#returns-summary)
21​
22<a id="call-signature-1"></a>
23​
24## Call Signature
25​
26```ts
27function useSuspenseQueries<T extends any[], TCombinedResult = T extends [] ? [] : T extends [Head] ? [GetUseSuspenseQueryResult<Head>] : T extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...(...)[]] extends [] ? [] : ... extends ... ? ... : ... : [...{ [K in (...)]: (...) }[]] : [...{ [K in string | number | symbol]: GetUseSuspenseQueryResult<Tails[K]> }[]] : { [K in string | number | symbol]: GetUseSuspenseQueryResult<T[K]> }>(options: object, queryClient?: QueryClient): TCombinedResult;
28```
29​
30Defined in: [packages/react-query/src/useSuspenseQueries.ts:347](https://github.com/TanStack/query/blob/main/packages/react-query/src/useSuspenseQueries.ts#L347)
31​
32The options for `useSuspenseQueries` are the same as for `useQueries`, except that the top-level `subscribed`
33option isn't supported, and each `query` can't have `throwOnError`, `enabled`, or `placeholderData`.
34​
35### Type Parameters
36​
37#### T
38​
39`T` *extends* `any`[]
40​
41#### TCombinedResult
42​
43`TCombinedResult` = `T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : \[`...{ [K in (...)]: (...) }[]`\] : \[...\{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<Tails\[K\]\> \}\[\]\] : \{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<T\[K\]\> \}
44​
45### Parameters
46​
47#### options
48​
49The `queries` array to run in Suspense, and an optional `combine` function.
50​
51##### combine?
52​
53(`result`: `T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : \[`...{ [K in (...)]: (...) }[]`\] : \{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<T\[K\]\> \}) => `TCombinedResult`
54​
55Use this to combine the results of the queries into a single value. The result will be structurally
56shared to be as referentially stable as possible.
57​
58##### queries
59​
60 \| readonly \[`T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>, `GetUseSuspenseQueryOptions`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : ...[] *extends* \[`...(...)[]`\] ? \[`...(...)[]`\] : ... *extends* ... ? ... : ... : `unknown`[] *extends* `T` ? `T` : `T` *extends* [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] ? [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] : [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`unknown`, `Error`, `unknown`, readonly ...[]\>[]\]
61 \| readonly \[\{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryOptions\<T\[K\]\> \}\]
62​
63An array with query option objects identical to `useSuspenseQuery`.
64​
65#### queryClient?
66​
67[`QueryClient`](../classes/QueryClient.md)
68​
69Use this to provide a custom `QueryClient`. Otherwise, the one from the nearest context
70will be used.
71​
72### Returns
73​
74`TCombinedResult`
75​
76The same structure as `useQueries`, except that for each `query`, `data` is guaranteed to be
77defined, `isPlaceholderData` is missing, and `status` is either `success` or `error` (with the derived
78flags set accordingly).
79​
80Caveat: the component will only re-mount after all queries have finished loading. Hence, if a query has gone
81stale in the time it took for all the queries to complete, it will be fetched again at re-mount. To avoid
82this, make sure to set a high enough `staleTime`. Cancellation does not work.
83​
84### Examples
85​
86The query error is thrown if a fetch fails and no cached data exists yet, so an error boundary is
87required around `<Suspense>`. A failed background refetch instead continues to render the cached data.
88Use [QueryErrorResetBoundary](QueryErrorResetBoundary.md) to let the user retry after such an error:
89```tsx
90import { Suspense } from 'react'
91import { ErrorBoundary } from 'react-error-boundary'
92import {
93 QueryErrorResetBoundary,
94 useSuspenseQueries,
95} from '@tanstack/react-query'
96​
97function Posts({ ids }: { ids: Array<number> }) {
98 // Every result is guaranteed to be defined — no per-query `isPending` check needed.
99 const postQueries = useSuspenseQueries({
100 queries: ids.map((id) => ({
101 queryKey: ['post', id],
102 queryFn: () => fetchPost(id),
103 })),
104 })
105​
106 return (
107 <ul>
108 {postQueries.map((query) => (
109 <li key={query.data.id}>{query.data.title}</li>
110 ))}
111 </ul>
112 )
114​
115function App() {
116 return (
117 <QueryErrorResetBoundary>
118 {({ reset }) => (
119 <ErrorBoundary
120 onReset={reset}
121 fallbackRender={({ resetErrorBoundary }) => (
122 <div>
123 There was an error!
124 <button onClick={() => resetErrorBoundary()}>Try again</button>
125 </div>
126 )}
127 >
128 <Suspense fallback={<h1>Loading posts...</h1>}>
129 <Posts ids={[1, 2, 3]} />
130 </Suspense>
131 </ErrorBoundary>
132 )}
133 </QueryErrorResetBoundary>
134 )
136```
137​
138Several different queries — use `useSuspenseQueries` instead of multiple `useSuspenseQuery` calls, so
139they fetch in parallel rather than suspending one after another:
140```tsx
141import { Suspense } from 'react'
142import { ErrorBoundary } from 'react-error-boundary'
143import {
144 QueryErrorResetBoundary,
145 useSuspenseQueries,
146} from '@tanstack/react-query'
147​
148function Dashboard() {
149 const [usersQuery, teamsQuery, projectsQuery] = useSuspenseQueries({
150 queries: [
151 { queryKey: ['users'], queryFn: fetchUsers },
152 { queryKey: ['teams'], queryFn: fetchTeams },
153 { queryKey: ['projects'], queryFn: fetchProjects },
154 ],
155 })
156​
157 return (
158 <div>
159 <UserList users={usersQuery.data} />
160 <TeamList teams={teamsQuery.data} />
161 <ProjectList projects={projectsQuery.data} />
162 </div>
163 )
165​
166function App() {
167 return (
168 <QueryErrorResetBoundary>
169 {({ reset }) => (
170 <ErrorBoundary
171 onReset={reset}
172 fallbackRender={({ resetErrorBoundary }) => (
173 <div>
174 There was an error!
175 <button onClick={() => resetErrorBoundary()}>Try again</button>
176 </div>
177 )}
178 >
179 <Suspense fallback={<h1>Loading dashboard...</h1>}>
180 <Dashboard />
181 </Suspense>
182 </ErrorBoundary>
183 )}
184 </QueryErrorResetBoundary>
185 )
187```
188​
189`combine`s the results into a single boolean, so `Refresh` only re-renders when that boolean changes,
190not on every individual query update. This overload is the only one that accepts `combine`:
191```tsx
192import { Suspense } from 'react'
193import { ErrorBoundary } from 'react-error-boundary'
194import {
195 QueryErrorResetBoundary,
196 useSuspenseQueries,
197} from '@tanstack/react-query'
198​
199function Refresh() {
200 const anyFetching = useSuspenseQueries({
201 queries: [
202 { queryKey: ['users'], queryFn: fetchUsers },
203 { queryKey: ['teams'], queryFn: fetchTeams },
204 ],
205 combine: (results) => results.some((result) => result.isFetching),
206 })
207​
208 return anyFetching ? <span>Refreshing…</span> : null
210​
211function App() {
212 return (
213 <QueryErrorResetBoundary>
214 {({ reset }) => (
215 <ErrorBoundary
216 onReset={reset}
217 fallbackRender={({ resetErrorBoundary }) => (
218 <div>
219 There was an error!
220 <button onClick={() => resetErrorBoundary()}>Try again</button>
221 </div>
222 )}
223 >
224 <Suspense fallback={<h1>Loading dashboard...</h1>}>
225 <Refresh />
226 </Suspense>
227 </ErrorBoundary>
228 )}
229 </QueryErrorResetBoundary>
230 )
232```
233​
234<a id="call-signature-2"></a>
235​
236## Call Signature
237​
238```ts
239function useSuspenseQueries<T extends any[], TCombinedResult = T extends [] ? [] : T extends [Head] ? [GetUseSuspenseQueryResult<Head>] : T extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...Tails[]] extends [] ? [] : [...Tails[]] extends [Head] ? [GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>, GetUseSuspenseQueryResult<Head>] : [...Tails[]] extends [Head, ...Tails[]] ? [...(...)[]] extends [] ? [] : ... extends ... ? ... : ... : [...{ [K in (...)]: (...) }[]] : [...{ [K in string | number | symbol]: GetUseSuspenseQueryResult<Tails[K]> }[]] : { [K in string | number | symbol]: GetUseSuspenseQueryResult<T[K]> }>(options: object, queryClient?: QueryClient): TCombinedResult;
240```
241​
242Defined in: [packages/react-query/src/useSuspenseQueries.ts:484](https://github.com/TanStack/query/blob/main/packages/react-query/src/useSuspenseQueries.ts#L484)
243​
244The options for `useSuspenseQueries` are the same as for `useQueries`, except that the top-level `subscribed`
245option isn't supported, and each `query` can't have `throwOnError`, `enabled`, or `placeholderData`.
246​
247### Type Parameters
248​
249#### T
250​
251`T` *extends* `any`[]
252​
253#### TCombinedResult
254​
255`TCombinedResult` = `T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : \[`...{ [K in (...)]: (...) }[]`\] : \[...\{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<Tails\[K\]\> \}\[\]\] : \{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<T\[K\]\> \}
256​
257### Parameters
258​
259#### options
260​
261The `queries` array to run in Suspense, and an optional `combine` function.
262​
263##### combine?
264​
265(`result`: `T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : \[`...{ [K in (...)]: (...) }[]`\] : \{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<T\[K\]\> \}) => `TCombinedResult`
266​
267Use this to combine the results of the queries into a single value. The result will be structurally
268shared to be as referentially stable as possible.
269​
270##### queries
271​
272readonly \[`T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>, `GetUseSuspenseQueryOptions`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...(...)[]`\] *extends* \[...\] ? \[..., ..., ...\] : ... *extends* ... ? ... : ... : `unknown`[] *extends* \[`...Tails[]`\] ? \[`...Tails[]`\] : \[`...(...)[]`\] *extends* ...[] ? ...[] : ...[] : `unknown`[] *extends* `T` ? `T` : `T` *extends* [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] ? [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] : [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`unknown`, `Error`, `unknown`, readonly `unknown`[]\>[]\]
273​
274An array with query option objects identical to `useSuspenseQuery`.
275​
276#### queryClient?
277​
278[`QueryClient`](../classes/QueryClient.md)
279​
280Use this to provide a custom `QueryClient`. Otherwise, the one from the nearest context
281will be used.
282​
283### Returns
284​
285`TCombinedResult`
286​
287The same structure as `useQueries`, except that for each `query`, `data` is guaranteed to be
288defined, `isPlaceholderData` is missing, and `status` is either `success` or `error` (with the derived
289flags set accordingly).
290​
291Caveat: the component will only re-mount after all queries have finished loading. Hence, if a query has gone
292stale in the time it took for all the queries to complete, it will be fetched again at re-mount. To avoid
293this, make sure to set a high enough `staleTime`. Cancellation does not work.
294​
295### Examples
296​
297The query error is thrown if a fetch fails and no cached data exists yet, so an error boundary is
298required around `<Suspense>`. A failed background refetch instead continues to render the cached data.
299Use [QueryErrorResetBoundary](QueryErrorResetBoundary.md) to let the user retry after such an error:
300```tsx
301import { Suspense } from 'react'
302import { ErrorBoundary } from 'react-error-boundary'
303import {
304 QueryErrorResetBoundary,
305 useSuspenseQueries,
306} from '@tanstack/react-query'
307​
308function Posts({ ids }: { ids: Array<number> }) {
309 // Every result is guaranteed to be defined — no per-query `isPending` check needed.
310 const postQueries = useSuspenseQueries({
311 queries: ids.map((id) => ({
312 queryKey: ['post', id],
313 queryFn: () => fetchPost(id),
314 })),
315 })
316​
317 return (
318 <ul>
319 {postQueries.map((query) => (
320 <li key={query.data.id}>{query.data.title}</li>
321 ))}
322 </ul>
323 )
325​
326function App() {
327 return (
328 <QueryErrorResetBoundary>
329 {({ reset }) => (
330 <ErrorBoundary
331 onReset={reset}
332 fallbackRender={({ resetErrorBoundary }) => (
333 <div>
334 There was an error!
335 <button onClick={() => resetErrorBoundary()}>Try again</button>
336 </div>
337 )}
338 >
339 <Suspense fallback={<h1>Loading posts...</h1>}>
340 <Posts ids={[1, 2, 3]} />
341 </Suspense>
342 </ErrorBoundary>
343 )}
344 </QueryErrorResetBoundary>
345 )
347```
348​
349Several different queries — use `useSuspenseQueries` instead of multiple `useSuspenseQuery` calls, so
350they fetch in parallel rather than suspending one after another:
351```tsx
352import { Suspense } from 'react'
353import { ErrorBoundary } from 'react-error-boundary'
354import {
355 QueryErrorResetBoundary,
356 useSuspenseQueries,
357} from '@tanstack/react-query'
358​
359function Dashboard() {
360 const [usersQuery, teamsQuery, projectsQuery] = useSuspenseQueries({
361 queries: [
362 { queryKey: ['users'], queryFn: fetchUsers },
363 { queryKey: ['teams'], queryFn: fetchTeams },
364 { queryKey: ['projects'], queryFn: fetchProjects },
365 ],
366 })
367​
368 return (
369 <div>
370 <UserList users={usersQuery.data} />
371 <TeamList teams={teamsQuery.data} />
372 <ProjectList projects={projectsQuery.data} />
373 </div>
374 )
376​
377function App() {
378 return (
379 <QueryErrorResetBoundary>
380 {({ reset }) => (
381 <ErrorBoundary
382 onReset={reset}
383 fallbackRender={({ resetErrorBoundary }) => (
384 <div>
385 There was an error!
386 <button onClick={() => resetErrorBoundary()}>Try again</button>
387 </div>
388 )}
389 >
390 <Suspense fallback={<h1>Loading dashboard...</h1>}>
391 <Dashboard />
392 </Suspense>
393 </ErrorBoundary>
394 )}
395 </QueryErrorResetBoundary>
396 )
398```
399​
400<a id="parameters-summary"></a>
401​
402## Parameters
403​
404### options
405​
406The `queries` array to run in Suspense, and an optional `combine` function.
407​
408#### combine?
409​
410(`result`: `T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryResult`\<`Head`\>, `GetUseSuspenseQueryResult`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...(...)[]`\] *extends* \[\] ? \[\] : ... *extends* ... ? ... : ... : \[`...{ [K in (...)]: (...) }[]`\] : \{ \[K in string \| number \| symbol\]: GetUseSuspenseQueryResult\<T\[K\]\> \}) => `TCombinedResult`
411​
412Use this to combine the results of the queries into a single value. The result will be structurally
413shared to be as referentially stable as possible.
414​
415#### queries
416​
417readonly \[`T` *extends* \[\] ? \[\] : `T` *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>\] : `T` *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...Tails[]`\] *extends* \[`Head`\] ? \[`GetUseSuspenseQueryOptions`\<`Head`\>, `GetUseSuspenseQueryOptions`\<`Head`\>\] : \[`...Tails[]`\] *extends* \[`Head`, `...Tails[]`\] ? \[`...Tails[]`\] *extends* \[\] ? \[\] : \[`...(...)[]`\] *extends* \[...\] ? \[..., ..., ...\] : ... *extends* ... ? ... : ... : `unknown`[] *extends* \[`...Tails[]`\] ? \[`...Tails[]`\] : \[`...(...)[]`\] *extends* ...[] ? ...[] : ...[] : `unknown`[] *extends* `T` ? `T` : `T` *extends* [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] ? [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>[] : [`UseSuspenseQueryOptions`](../interfaces/UseSuspenseQueryOptions.md)\<`unknown`, `Error`, `unknown`, readonly `unknown`[]\>[]\]
418​
419An array with query option objects identical to `useSuspenseQuery`.
420​
421### queryClient?
422​
423[`QueryClient`](../classes/QueryClient.md)
424​
425Use this to provide a custom `QueryClient`. Otherwise, the one from the nearest context
426will be used.
427​
428<a id="returns-summary"></a>
429​
430## Returns
431​
432`TCombinedResult`
433​
434The same structure as `useQueries`, except that for each `query`, `data` is guaranteed to be
435defined, `isPlaceholderData` is missing, and `status` is either `success` or `error` (with the derived
436flags set accordingly).
437​
438Caveat: the component will only re-mount after all queries have finished loading. Hence, if a query has gone
439stale in the time it took for all the queries to complete, it will be fetched again at re-mount. To avoid
440this, make sure to set a high enough `staleTime`. Cancellation does not work.