Open History to see the last commit
1---
2id: usePrefetchQuery
3title: usePrefetchQuery
4redirect_from:
5 - framework/vue/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: MaybeRefOrGetter<MaybeRefDeep<UsePrefetchQueryOptions<TQueryFnData, TError, TData, TQueryData, TQueryKey>>>, queryClient?: QueryClient): void;
12```
13β
14Defined in: [packages/vue-query/src/usePrefetchQuery.ts:92](https://github.com/TanStack/query/blob/main/packages/vue-query/src/usePrefetchQuery.ts#L92)
15β
16`usePrefetchQuery` does not return anything β it fires a prefetch as a reactive side effect, useful for
17kicking off a fetch ahead of the component that will actually render the data with `useQuery`. You can pass
18everything to `usePrefetchQuery` that you can pass to `queryClient.query`, though `queryKey` is always
19required, and `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 it won't refetch data that's already there or already in flight. It
23re-runs whenever a reactive dependency in `options` (built with `queryOptions`, for example) changes.
24β
25Fire this during render, before a suspense boundary that wraps a component using `useQuery`'s `suspense()`
26β see the [Suspense guide](https://tanstack.com/query/latest/docs/framework/vue/guides/suspense).
27β
28## Type Parameters
29β
30### TQueryFnData
31β
32`TQueryFnData` = `unknown`
33β
34### TError
35β
36`TError` = `Error`
37β
38### TData
39β
40`TData` = `TQueryFnData`
41β
42### TQueryData
43β
44`TQueryData` = `TQueryFnData`
45β
46### TQueryKey
47β
48`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
49β
50## Parameters
51β
52### options
53β
54`MaybeRefOrGetter`\<`MaybeRefDeep`\<[`UsePrefetchQueryOptions`](../type-aliases/UsePrefetchQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryData`, `TQueryKey`\>\>\>
55β
56A `ref`, plain value, or reactive getter resolving to the [UsePrefetchQueryOptions](../type-aliases/UsePrefetchQueryOptions.md) to
57use β everything you can pass to `queryClient.query`.
58β
59<a id="options-properties"></a>
60β
61#### `options` properties
62β
63Built from [`QueryExecuteOptions`](../interfaces/QueryExecuteOptions.md#properties). See the type above for what it changes.
64β
65### queryClient?
66β
67[`QueryClient`](../classes/QueryClient.md)
68β
69Use this to use a custom `QueryClient`. Otherwise, the one provided by `VueQueryPlugin`
70will be used.
71β
72## Returns
73β
74`void`
75β
76## Example
77β
78```vue
79<script setup lang="ts">
80import { usePrefetchQuery } from '@tanstack/vue-query'
81import Posts from './Posts.vue'
82β
83// Fire the prefetch as soon as this component runs, before `Posts` mounts and calls `useQuery`.
84usePrefetchQuery({
85 queryKey: ['posts'],
86 queryFn: fetchPosts,
87})
88</script>
89β
90<template>
91 <Posts />
92</template>
93```