# Prefetching

If you're lucky enough, you may know enough about what your users will do to be able to prefetch the data they need before it's needed. If this is the case, use `queryClient.query` or `queryClient.infiniteQuery` to warm the cache ahead of time:

[//]: # 'ExamplePrefetching'

```tsx
import { noop } from '@tanstack/vue-query'

const prefetchTodos = async () => {
  // The results of this query will be cached like a normal query
  await queryClient
    .query({
      queryKey: ['todos'],
      queryFn: fetchTodos,
    })
    .catch(noop)
}
```

[//]: # 'ExamplePrefetching'

- If **fresh** data for this query is already in the cache, the data will not be fetched
- If a `staleTime` is passed e.g. `queryClient.query({ queryKey: ['todos'], queryFn: fn, staleTime: 5 * 1000 })` and the data is older than the specified `staleTime`, the query will be fetched
- As `useQuery` will retry fetches and handle errors, you can use `void` to ignore the promise from `query` and `.catch(noop)` to ignore errors.
- If you want to always return cached data when it exists, use `staleTime: 'static'`
- If no instances of `useQuery` appear for a prefetched query, it will be deleted and garbage collected after the time specified in `gcTime`.

## Prefetching Infinite Queries

Pass `getNextPageParam` when you prefetch an infinite query. On an empty cache, the client fetches the first page by default. Use `pages` to request more pages. If the cache already contains stale pages and you omit `pages`, the client refetches up to the number of cached pages.

[//]: # 'ExampleInfiniteQuery'

```tsx
import { noop } from '@tanstack/vue-query'

const prefetchProjects = async () => {
  // The results of this query will be cached like a normal query
  await queryClient
    .infiniteQuery({
      queryKey: ['projects'],
      queryFn: fetchProjects,
      initialPageParam: 0,
      getNextPageParam: (lastPage, pages) => lastPage.nextCursor,
      pages: 3, // prefetch the first 3 pages
    })
    .catch(noop)
}
```

[//]: # 'ExampleInfiniteQuery'

The above code will try to prefetch 3 pages in order, and `getNextPageParam` will be executed for each page to determine the next page to prefetch. If `getNextPageParam` returns `undefined`, the prefetching will stop.
