Open History to see the last commit
1---
2id: injectQuery
3title: injectQuery
4---
5β
6<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
7β
8## Overview
9β
10```ts
11function injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): DefinedCreateQueryResult<TData, TError>;
12function injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): CreateQueryResult<TData, TError>;
13function injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => CreateQueryOptions<TQueryFnData, TError, TData, TQueryKey>): CreateQueryResult<TData, TError>;
14```
15β
16- [`() => DefinedInitialDataOptions` β `DefinedCreateQueryResult`](#call-signature-1): This overload is selected when `initialData` is set on the options returned by `optionsFn`, so the resulting `data` signal is never `undefined` (unless a `select` changes `TData` to include `undefined`).
17- [`() => UndefinedInitialDataOptions` β `CreateQueryResult`](#call-signature-2): Injects a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
18- [`() => CreateQueryOptions` β `CreateQueryResult`](#call-signature-3): This overload accepts the general [CreateQueryOptions](../type-aliases/CreateQueryOptions.md) shape rather than the `initialData`-aware overloads above, so whether `data` is defined can't be inferred from the call site β useful when wrapping `injectQuery` in your own helper function that forwards caller-provided options.
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 injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): DefinedCreateQueryResult<TData, TError>;
28```
29β
30Defined in: [packages/angular-query/src/inject-query.ts:59](https://github.com/TanStack/query/blob/main/packages/angular-query/src/inject-query.ts#L59)
31β
32This overload is selected when `initialData` is set on the options returned by `optionsFn`, so the
33resulting `data` signal is never `undefined` (unless a `select` changes `TData` to include `undefined`).
34β
35### Type Parameters
36β
37#### TQueryFnData
38β
39`TQueryFnData` = `unknown`
40β
41#### TError
42β
43`TError` = `Error`
44β
45#### TData
46β
47`TData` = `TQueryFnData`
48β
49#### TQueryKey
50β
51`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
52β
53### Parameters
54β
55#### optionsFn
56β
57() => [`DefinedInitialDataOptions`](../type-aliases/DefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
58β
59A function returning the [DefinedInitialDataOptions](../type-aliases/DefinedInitialDataOptions.md) to use β everything you
60can pass to `injectQuery`, with `initialData` set. Similar to `computed` from Angular, this function runs
61in the reactive context, so signals read inside it (in `queryKey`, `enabled`, etc.) drive the query.
62β
63### Returns
64β
65[`DefinedCreateQueryResult`](../type-aliases/DefinedCreateQueryResult.md)\<`TData`, `TError`\>
66β
67The query result, typed so that `data` is never `undefined` (unless a `select` changes `TData` to
68include `undefined`).
69β
70### See
71β
72 - https://tanstack.com/query/latest/docs/framework/angular/guides/queries
73 - [queryOptions](queryOptions.md) to share these options between `injectQuery` and imperative APIs like
74`queryClient.query`.
75β
76### Example
77β
78```angular-ts
79@Component({
80 selector: 'posts',
81 template: `
82 <!-- `postsQuery.data()` is `Post[]`, never `undefined`, thanks to `initialData` β even if a
83 refetch fails, so the list stays visible alongside the error. -->
84 @if (postsQuery.isError()) {
85 <span>Error: {{ postsQuery.error()?.message }}</span>
86 }
87 <ul>
88 @for (post of postsQuery.data(); track post.id) {
89 <li>{{ post.title }}</li>
90 }
91 </ul>
92 `,
93})
94export class Posts {
95 readonly postsQuery = injectQuery(() => ({
96 queryKey: ['posts'],
97 queryFn: fetchPosts,
98 initialData: [],
99 }))
100}
101```
102β
103<a id="call-signature-2"></a>
104β
105## Call Signature
106β
107```ts
108function injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>): CreateQueryResult<TData, TError>;
109```
110β
111Defined in: [packages/angular-query/src/inject-query.ts:142](https://github.com/TanStack/query/blob/main/packages/angular-query/src/inject-query.ts#L142)
112β
113Injects a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
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#### optionsFn
136β
137() => [`UndefinedInitialDataOptions`](../type-aliases/UndefinedInitialDataOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
138β
139A function returning the [UndefinedInitialDataOptions](../type-aliases/UndefinedInitialDataOptions.md) to use β everything
140you can pass to `injectQuery`. Similar to `computed` from Angular, this function runs in the reactive
141context, so signals read inside it (in `queryKey`, `enabled`, etc.) drive the query.
142β
143### Returns
144β
145[`CreateQueryResult`](../type-aliases/CreateQueryResult.md)\<`TData`, `TError`\>
146β
147The query result. `status()` is `'pending'` if there is no cached data to display, `'error'` if
148the last fetch attempt failed, or `'success'` if the query has data to display. `isPending`/`isSuccess`/
149`isError` are type-guard methods for convenience.
150β
151### See
152β
153 - https://tanstack.com/query/latest/docs/framework/angular/guides/queries
154 - [queryOptions](queryOptions.md) to share these options between `injectQuery` and imperative APIs like
155`queryClient.query`.
156β
157### Examples
158β
159```angular-ts
160@Component({
161 selector: 'posts',
162 template: `
163 @if (postsQuery.isPending()) {
164 Loading...
165 } @else if (postsQuery.isError()) {
166 <span>Error: {{ postsQuery.error()?.message }}</span>
167 } @else {
168 <ul>
169 @for (post of postsQuery.data(); track post.id) {
170 <li>{{ post.title }}</li>
171 }
172 </ul>
173 }
174 `,
175})
176export class Posts {
177 readonly postsQuery = injectQuery(() => ({
178 queryKey: ['posts'],
179 queryFn: fetchPosts,
180 }))
181}
182```
183β
184Similar to `computed` from Angular, the function passed to `injectQuery` runs in the reactive context. In
185the example below, the query is automatically enabled and executed when the filter signal changes to a
186truthy value. When the filter signal changes back to a falsy value, the query is disabled.
187```angular-ts
188@Component({
189 selector: 'posts',
190 template: `
191 <input [ngModel]="filter()" (ngModelChange)="filter.set($event)" />
192 @if (postsQuery.isPending()) {
193 Loading...
194 } @else if (postsQuery.isError()) {
195 <span>Error: {{ postsQuery.error()?.message }}</span>
196 } @else {
197 <ul>
198 @for (post of postsQuery.data(); track post.id) {
199 <li>{{ post.title }}</li>
200 }
201 </ul>
202 }
203 `,
204})
205export class Posts {
206 readonly filter = signal('')
207β
208 readonly postsQuery = injectQuery(() => ({
209 queryKey: ['posts', this.filter()],
210 queryFn: () => fetchPosts(this.filter()),
211 enabled: !!this.filter(),
212 }))
213}
214```
215β
216<a id="call-signature-3"></a>
217β
218## Call Signature
219β
220```ts
221function injectQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends readonly unknown[] = readonly unknown[]>(optionsFn: () => CreateQueryOptions<TQueryFnData, TError, TData, TQueryKey>): CreateQueryResult<TData, TError>;
222```
223β
224Defined in: [packages/angular-query/src/inject-query.ts:165](https://github.com/TanStack/query/blob/main/packages/angular-query/src/inject-query.ts#L165)
225β
226This overload accepts the general [CreateQueryOptions](../type-aliases/CreateQueryOptions.md) shape rather than the `initialData`-aware
227overloads above, so whether `data` is defined can't be inferred from the call site β useful when wrapping
228`injectQuery` in your own helper function that forwards caller-provided options.
229β
230### Type Parameters
231β
232#### TQueryFnData
233β
234`TQueryFnData` = `unknown`
235β
236#### TError
237β
238`TError` = `Error`
239β
240#### TData
241β
242`TData` = `TQueryFnData`
243β
244#### TQueryKey
245β
246`TQueryKey` *extends* readonly `unknown`[] = readonly `unknown`[]
247β
248### Parameters
249β
250#### optionsFn
251β
252() => [`CreateQueryOptions`](../type-aliases/CreateQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
253β
254A function that returns query options. Similar to `computed` from Angular, this
255function runs in the reactive context, so signals read inside it drive the query.
256β
257### Returns
258β
259[`CreateQueryResult`](../type-aliases/CreateQueryResult.md)\<`TData`, `TError`\>
260β
261The query result.
262β
263### See
264β
265https://tanstack.com/query/latest/docs/framework/angular/guides/queries
266β
267<a id="parameters-summary"></a>
268β
269## Parameters
270β
271### optionsFn
272β
273() => [`CreateQueryOptions`](../type-aliases/CreateQueryOptions.md)\<`TQueryFnData`, `TError`, `TData`, `TQueryKey`\>
274β
275A function that returns query options. Similar to `computed` from Angular, this
276function runs in the reactive context, so signals read inside it drive the query.
277β
278<a id="optionsFn-properties"></a>
279β
280#### `optionsFn` properties
281β
282Built from [`QueryObserverOptions`](../interfaces/QueryObserverOptions.md#properties). See the type above for what it changes.
283β
284<a id="returns-summary"></a>
285β
286## Returns
287β
288[`CreateQueryResult`](../type-aliases/CreateQueryResult.md)\<`TData`, `TError`\>
289β
290The query result.