Open History to see the last commit
1---
2id: queryOptions
3title: queryOptions
4---
5β
6<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
7β
8## Overview
9β
10```ts
11function queryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(options: DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey> & QueryKeyWithDataTag<TQueryKey, TQueryFnData, TError>;
12function queryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(options: UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey> & QueryKeyWithDataTag<TQueryKey, TQueryFnData, TError>;
13```
14β
15- [`DefinedInitialDataOptions` β `DefinedInitialDataOptions & QueryKeyWithDataTag`](#call-signature-1): You can generally pass everything to `queryOptions` that you can also pass to `createQuery`. These options can be shared across `createQuery` calls and imperative APIs such as `queryClient.query`. `options.queryKey` is required and is the query key to generate options for.
16- [`UndefinedInitialDataOptions` β `UndefinedInitialDataOptions & QueryKeyWithDataTag`](#call-signature-2): You can generally pass everything to `queryOptions` that you can also pass to `createQuery`. These options can be shared across `createQuery` calls and imperative APIs such as `queryClient.query`. `options.queryKey` is required and is the query key to generate options for.
17β
18See also: [Parameters](#parameters-summary) Β· [Returns](#returns-summary)
19β
20<a id="call-signature-1"></a>
21β
22## Call Signature
23β
24```ts
25function queryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(options: DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey> & QueryKeyWithDataTag<TQueryKey, TQueryFnData, TError>;
26```
27β
28Defined in: [packages/svelte-query/src/queryOptions.ts:79](https://github.com/TanStack/query/blob/main/packages/svelte-query/src/queryOptions.ts#L79)
29β
30You can generally pass everything to `queryOptions` that you can also pass to `createQuery`. These options
31can be shared across `createQuery` calls and imperative APIs such as `queryClient.query`. `options.queryKey`
32is required and is the query key to generate options for.
33β
34This overload is selected when `initialData` is known to be defined, so the resulting `data` is never
35`undefined` (unless a `select` changes `TData` to include `undefined`).
36β
37### Type Parameters
38β
39#### TQueryFnData
40β
41`TQueryFnData` = `unknown`
42β
43#### TError
44β
45`TError` = `Error`
46β
47#### TData
48β
49`TData` = `TQueryFnData`
50β
51#### TQueryKey
52β
53`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
54β
55### Parameters
56β
57#### options
58β
59[`DefinedInitialDataOptions`](../type-aliases/DefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
60β
61The [DefinedInitialDataOptions](../type-aliases/DefinedInitialDataOptions.md) to use β everything you can pass to `createQuery`,
62with `initialData` known to be defined.
63β
64### Returns
65β
66[`DefinedInitialDataOptions`](../type-aliases/DefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, `TQueryFnData`, `TError`\>
67β
68The same options object, typed so that `queryKey` carries the inferred data type.
69β
70### See
71β
72[createQuery](createQuery.md) to run a query with these options.
73β
74### Example
75β
76```svelte
77<script lang="ts">
78 import { queryOptions, createQuery } from '@tanstack/svelte-query'
79β
80 const postsOptions = queryOptions({
81 queryKey: ['posts'],
82 queryFn: fetchPosts,
83 initialData: [],
84 })
85β
86 // `data` is `Post[]`, never `undefined`, thanks to `initialData` β even if a refetch fails,
87 // so the list stays visible alongside the error.
88 const query = createQuery(() => postsOptions)
89</script>
90β
91{#if query.isError}
92 <span>Error: {query.error.message}</span>
93{/if}
94<ul>
95 {#each query.data as post (post.id)}
96 <li>{post.title}</li>
97 {/each}
98</ul>
99```
100β
101<a id="call-signature-2"></a>
102β
103## Call Signature
104β
105```ts
106function queryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(options: UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey> & QueryKeyWithDataTag<TQueryKey, TQueryFnData, TError>;
107```
108β
109Defined in: [packages/svelte-query/src/queryOptions.ts:122](https://github.com/TanStack/query/blob/main/packages/svelte-query/src/queryOptions.ts#L122)
110β
111You can generally pass everything to `queryOptions` that you can also pass to `createQuery`. These options
112can be shared across `createQuery` calls and imperative APIs such as `queryClient.query`. `options.queryKey`
113is required and is the query key to generate options for.
114β
115### Type Parameters
116β
117#### TQueryFnData
118β
119`TQueryFnData` = `unknown`
120β
121#### TError
122β
123`TError` = `Error`
124β
125#### TData
126β
127`TData` = `TQueryFnData`
128β
129#### TQueryKey
130β
131`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
132β
133### Parameters
134β
135#### options
136β
137[`UndefinedInitialDataOptions`](../type-aliases/UndefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
138β
139The [UndefinedInitialDataOptions](../type-aliases/UndefinedInitialDataOptions.md) to use β everything you can pass to `createQuery`.
140β
141### Returns
142β
143[`UndefinedInitialDataOptions`](../type-aliases/UndefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, `TQueryFnData`, `TError`\>
144β
145The same options object, typed so that `queryKey` carries the inferred data type.
146β
147### See
148β
149[createQuery](createQuery.md) to run a query with these options.
150β
151### Example
152β
153A parameterized factory, so the same options object can be reused per `id`:
154```svelte
155<script lang="ts">
156 import { queryOptions, createQuery } from '@tanstack/svelte-query'
157β
158 let { id }: { id: string } = $props()
159β
160 const postOptions = (id: string) =>
161 queryOptions({
162 queryKey: ['post', id],
163 queryFn: () => fetchPost(id),
164 })
165β
166 const query = createQuery(() => postOptions(id))
167</script>
168β
169{#if query.isPending}
170 Loading...
171{:else if query.isError}
172 <span>Error: {query.error.message}</span>
173{:else}
174 <h1>{query.data.title}</h1>
175{/if}
176```
177β
178<a id="parameters-summary"></a>
179β
180## Parameters
181β
182### options
183β
184[`UndefinedInitialDataOptions`](../type-aliases/UndefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
185β
186The [UndefinedInitialDataOptions](../type-aliases/UndefinedInitialDataOptions.md) to use β everything you can pass to `createQuery`.
187β
188<a id="options-properties"></a>
189β
190#### `options` properties
191β
192Built from [`QueryObserverOptions`](../interfaces/QueryObserverOptions.md#properties). See the type above for what it changes.
193β
194<a id="returns-summary"></a>
195β
196## Returns
197β
198[`UndefinedInitialDataOptions`](../type-aliases/UndefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\> & [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md)\<`TQueryKey`, `TQueryFnData`, `TError`\>
199β
200The same options object, typed so that `queryKey` carries the inferred data type.
201β
202<a id="result-properties"></a>
203β
204### Result properties
205β
206Built from [`QueryObserverOptions`](../interfaces/QueryObserverOptions.md#properties), [`QueryKeyWithDataTag`](../type-aliases/QueryKeyWithDataTag.md#properties). See the type above for what it changes.