Framework
Version
Guides & Concepts

usePrefetchQuery

tsx
usePrefetchQuery(options)
usePrefetchQuery(options)

Options

You can pass everything to usePrefetchQuery that you can pass to queryClient.prefetchQuery. Remember that some of them are required as below:

  • queryKey: QueryKey

    • Required
    • The query key to prefetch during render
  • queryFn: (context: QueryFunctionContext) => Promise<TData>

    • Required, but only if no default query function has been defined See Default Query Function for more information.

Returns

The usePrefetchQuery does not return anything, it should be used just to fire a prefetch during render, before a suspense boundary that wraps a component that uses useSuspenseQuery.

Want to Skip the Docs?
Query.gg - The Official React Query Course
“This course is the best way to learn how to use React Query in real-world applications.”—Tanner Linsley
Get the course