Open History to see the last commit
1---
2id: infiniteQueryOptions
3title: infiniteQueryOptions
4redirect_from:
5 - framework/vue/reference/infiniteQueryOptions
6---
7β
8<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
9β
10## Overview
11β
12```ts
13function infiniteQueryOptions<TQueryFnData, TError = Error, TData = InfiniteData<TQueryFnData, unknown>, TQueryKey extends readonly unknown[] = readonly unknown[], TPageParam = unknown>(options: UndefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>): UndefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> & QueryKeyWithDataTag<TQueryKey, InfiniteData<TQueryFnData>, TError>;
14function infiniteQueryOptions<TQueryFnData, TError = Error, TData = InfiniteData<TQueryFnData, unknown>, TQueryKey extends readonly unknown[] = readonly unknown[], TPageParam = unknown>(options: DefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>): DefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> & QueryKeyWithDataTag<TQueryKey, InfiniteData<TQueryFnData>, TError>;
15```
16β
17- [`UndefinedInitialDataInfiniteOptions` β `UndefinedInitialDataInfiniteOptions & QueryKeyWithDataTag`](#call-signature-1): You can generally pass everything to `infiniteQueryOptions` that you can also pass to `useInfiniteQuery`. These options can be shared across hooks and imperative APIs such as `queryClient.infiniteQuery`. `options.queryKey` is required and is the query key to generate options for.
18- [`DefinedInitialDataInfiniteOptions` β `DefinedInitialDataInfiniteOptions & QueryKeyWithDataTag`](#call-signature-2): You can generally pass everything to `infiniteQueryOptions` that you can also pass to `useInfiniteQuery`. These options can be shared across hooks and imperative APIs such as `queryClient.infiniteQuery`. `options.queryKey` is required and is the query key to generate options for.
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 infiniteQueryOptions<TQueryFnData, TError = Error, TData = InfiniteData<TQueryFnData, unknown>, TQueryKey extends readonly unknown[] = readonly unknown[], TPageParam = unknown>(options: UndefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>): UndefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> & QueryKeyWithDataTag<TQueryKey, InfiniteData<TQueryFnData>, TError>;
28```
29β
30Defined in: [packages/vue-query/src/infiniteQueryOptions.ts:95](https://github.com/TanStack/query/blob/main/packages/vue-query/src/infiniteQueryOptions.ts#L95)
31β
32You can generally pass everything to `infiniteQueryOptions` that you can also pass to `useInfiniteQuery`.
33These options can be shared across hooks and imperative APIs such as `queryClient.infiniteQuery`.
34`options.queryKey` is required and is the query key to generate options for.
35β
36### Type Parameters
37β
38#### TQueryFnData
39β
40`TQueryFnData`
41β
42#### TError
43β
44`TError` = `Error`
45β
46#### TData
47β
48`TData` = [`InfiniteData`](../interfaces/InfiniteData.md)\<`TQueryFnData`, `unknown`\>
49β
50#### TQueryKey
51β
52`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
53β
54#### TPageParam
55β
56`TPageParam` = `unknown`
57β
58### Parameters
59β
60#### options
61β
62[`UndefinedInitialDataInfiniteOptions`](../type-aliases/UndefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\>
63β
64The [UndefinedInitialDataInfiniteOptions](../type-aliases/UndefinedInitialDataInfiniteOptions.md) to use β everything you can pass to
65`useInfiniteQuery`.
66β
67### Returns
68β
69[`UndefinedInitialDataInfiniteOptions`](../type-aliases/UndefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, [`InfiniteData`](../interfaces/InfiniteData.md)\<`TQueryFnData`\>, `TError`\>
70β
71The same options object, typed so that `queryKey` carries the inferred data type.
72β
73### See
74β
75[useInfiniteQuery](useInfiniteQuery.md) to run an infinite query with these options.
76β
77### Example
78β
79```vue
80<script setup lang="ts">
81import { infiniteQueryOptions, useInfiniteQuery } from '@tanstack/vue-query'
82β
83const projectsOptions = infiniteQueryOptions({
84 queryKey: ['projects'],
85 queryFn: ({ pageParam }) => fetchProjects(pageParam),
86 initialPageParam: 0,
87 getNextPageParam: (lastPage) => lastPage.nextId,
88})
89β
90const { data, isError, error, fetchNextPage } = useInfiniteQuery(projectsOptions)
91</script>
92```
93β
94<a id="call-signature-2"></a>
95β
96## Call Signature
97β
98```ts
99function infiniteQueryOptions<TQueryFnData, TError = Error, TData = InfiniteData<TQueryFnData, unknown>, TQueryKey extends readonly unknown[] = readonly unknown[], TPageParam = unknown>(options: DefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>): DefinedInitialDataInfiniteOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam> & QueryKeyWithDataTag<TQueryKey, InfiniteData<TQueryFnData>, TError>;
100```
101β
102Defined in: [packages/vue-query/src/infiniteQueryOptions.ts:148](https://github.com/TanStack/query/blob/main/packages/vue-query/src/infiniteQueryOptions.ts#L148)
103β
104You can generally pass everything to `infiniteQueryOptions` that you can also pass to `useInfiniteQuery`.
105These options can be shared across hooks and imperative APIs such as `queryClient.infiniteQuery`.
106`options.queryKey` is required and is the query key to generate options for.
107β
108This overload is selected when `initialData` is set, so the resulting `data` is never `undefined` (unless
109a `select` changes `TData` to include `undefined`).
110β
111### Type Parameters
112β
113#### TQueryFnData
114β
115`TQueryFnData`
116β
117#### TError
118β
119`TError` = `Error`
120β
121#### TData
122β
123`TData` = [`InfiniteData`](../interfaces/InfiniteData.md)\<`TQueryFnData`, `unknown`\>
124β
125#### TQueryKey
126β
127`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
128β
129#### TPageParam
130β
131`TPageParam` = `unknown`
132β
133### Parameters
134β
135#### options
136β
137[`DefinedInitialDataInfiniteOptions`](../type-aliases/DefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\>
138β
139The [DefinedInitialDataInfiniteOptions](../type-aliases/DefinedInitialDataInfiniteOptions.md) to use β everything you can pass to
140`useInfiniteQuery`, with `initialData` set.
141β
142### Returns
143β
144[`DefinedInitialDataInfiniteOptions`](../type-aliases/DefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, [`InfiniteData`](../interfaces/InfiniteData.md)\<`TQueryFnData`\>, `TError`\>
145β
146The same options object, typed so that `queryKey` carries the inferred data type.
147β
148### See
149β
150[useInfiniteQuery](useInfiniteQuery.md) to run an infinite query with these options.
151β
152### Example
153β
154```vue
155<script setup lang="ts">
156import { infiniteQueryOptions, useInfiniteQuery } from '@tanstack/vue-query'
157β
158const projectsOptions = infiniteQueryOptions({
159 queryKey: ['projects'],
160 queryFn: ({ pageParam }) => fetchProjects(pageParam),
161 initialPageParam: 0,
162 getNextPageParam: (lastPage) => lastPage.nextId,
163 initialData: { pages: [], pageParams: [] },
164})
165β
166// `data` is never `undefined`, thanks to `initialData` β even if a refetch fails, so the
167// list stays visible alongside the error.
168const { data, isError, error } = useInfiniteQuery(projectsOptions)
169</script>
170```
171β
172<a id="parameters-summary"></a>
173β
174## Parameters
175β
176### options
177β
178[`DefinedInitialDataInfiniteOptions`](../type-aliases/DefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\>
179β
180The [DefinedInitialDataInfiniteOptions](../type-aliases/DefinedInitialDataInfiniteOptions.md) to use β everything you can pass to
181`useInfiniteQuery`, with `initialData` set.
182β
183<a id="returns-summary"></a>
184β
185## Returns
186β
187[`DefinedInitialDataInfiniteOptions`](../type-aliases/DefinedInitialDataInfiniteOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`, `TPageParam`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, [`InfiniteData`](../interfaces/InfiniteData.md)\<`TQueryFnData`\>, `TError`\>
188β
189The same options object, typed so that `queryKey` carries the inferred data type.