Open History to see the last commit
1---
2id: usePrefetchQuery
3title: usePrefetchQuery
4redirect_from:
5 - framework/react/reference/usePrefetchQuery
6---
7β
8<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
9β
10```ts
11function usePrefetchQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(options: UsePrefetchQueryOptions<TQueryFnData, TError, TData, TQueryData, TQueryKey>, queryClient?: QueryClient): void;
12```
13β
14Defined in: [packages/react-query/src/usePrefetchQuery.tsx:38](https://github.com/TanStack/query/blob/main/packages/react-query/src/usePrefetchQuery.tsx#L38)
15β
16`usePrefetchQuery` does not return anything, it should be used just to fire a prefetch during render, before
17a suspense boundary that wraps a component that uses `useSuspenseQuery`. You can pass everything to
18`usePrefetchQuery` that you can pass to `queryClient.query`, though `queryKey` is always required, and
19`queryFn` is required unless a default query function has been defined.
20β
21The prefetch is skipped if the query already has any cached state β including a `pending`/`error` state left
22over from a previous attempt β so calling this on every render is cheap and won't refetch data that's
23already there or already in flight.
24β
25## Type Parameters
26β
27### TQueryFnData
28β
29`TQueryFnData` = `unknown`
30β
31### TError
32β
33`TError` = `Error`
34β
35### TData
36β
37`TData` = `TQueryFnData`
38β
39### TQueryData
40β
41`TQueryData` = `TQueryFnData`
42β
43### TQueryKey
44β
45`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
46β
47## Parameters
48β
49### options
50β
51[`UsePrefetchQueryOptions`](../type-aliases/UsePrefetchQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryData`, `TQueryKey`\>
52β
53The [UsePrefetchQueryOptions](../type-aliases/UsePrefetchQueryOptions.md) to use β everything you can pass to `queryClient.query`.
54β
55<a id="options-properties"></a>
56β
57#### `options` properties
58β
59Built from [`QueryExecuteOptions`](../interfaces/QueryExecuteOptions.md#properties). See the type above for what it changes.
60β
61### queryClient?
62β
63[`QueryClient`](../classes/QueryClient.md)
64β
65Use this to use a custom `QueryClient`. Otherwise, the one from the nearest context will
66be used.
67β
68## Returns
69β
70`void`
71β
72## Example
73β
74```tsx
75import { Suspense } from 'react'
76import { usePrefetchQuery } from '@tanstack/react-query'
77β
78function App() {
79 // Fire the prefetch during render, before the suspense boundary below.
80 usePrefetchQuery({
81 queryKey: ['posts'],
82 queryFn: fetchPosts,
83 })
84β
85 return (
86 <Suspense fallback={<h1>Loading posts...</h1>}>
87 <Posts />
88 </Suspense>
89 )
90}
91```