Open History to see the last commit
1---
2id: provideTanStackQuery
3title: provideTanStackQuery
4---
5β
6<!-- DO NOT EDIT: this page is autogenerated from the type comments -->
7β
8```ts
9function provideTanStackQuery(queryClientFactory: () => QueryClient, ...features: readonly QueryFeature[]): EnvironmentProviders;
10```
11β
12Defined in: [packages/angular-query/src/providers.ts:126](https://github.com/TanStack/query/blob/main/packages/angular-query/src/providers.ts#L126)
13β
14Sets up providers necessary to enable TanStack Query functionality for Angular applications. Provides a
15`QueryClient` and optional TanStack Query features. The factory runs once per injector in Angular's
16injection context, so it can call `inject()` and each SSR request can receive an independent cache.
17β
18## Parameters
19β
20### queryClientFactory
21β
22() => [`QueryClient`](../classes/QueryClient.md)
23β
24Creates or resolves a `QueryClient` in the injection context.
25β
26### features
27β
28...readonly [`QueryFeature`](../interfaces/QueryFeature.md)[]
29β
30Optional features to configure additional Query functionality.
31β
32## Returns
33β
34`EnvironmentProviders`
35β
36A single EnvironmentProviders value (do not spread into `providers`).
37β
38## See
39β
40 - https://tanstack.com/query/v5/docs/framework/angular/quick-start
41 - https://tanstack.com/query/v5/docs/framework/angular/devtools
42 - https://tanstack.com/query/latest/docs/framework/angular/guides/ssr
43β
44## Examples
45β
46```ts
47import {
48 provideTanStackQuery,
49 QueryClient,
50} from '@tanstack/angular-query'
51β
52bootstrapApplication(AppComponent, {
53 providers: [provideTanStackQuery(() => new QueryClient())],
54})
55```
56β
57The same, in an `NgModule`-based application:
58```ts
59import { provideTanStackQuery, QueryClient } from '@tanstack/angular-query'
60β
61@NgModule({
62 declarations: [AppComponent],
63 imports: [BrowserModule],
64 providers: [provideTanStackQuery(() => new QueryClient())],
65 bootstrap: [AppComponent],
66})
67export class AppModule {}
68```
69β
70Enabling optional developer tools by adding `withDevtools` β by default, the tools are then loaded when
71your app is in development mode:
72```ts
73import { provideTanStackQuery, QueryClient } from '@tanstack/angular-query'
74import { withDevtools } from '@tanstack/angular-query-devtools'
75β
76bootstrapApplication(AppComponent, {
77 providers: [
78 provideTanStackQuery(() => new QueryClient(), withDevtools()),
79 ],
80})
81```
82β
83Resolving the `QueryClient` from an `InjectionToken` β an advanced optimization that lets TanStack Query
84be absent from the main application bundle, useful for including it on lazy-loaded routes only while
85still sharing a `QueryClient`. This is a small optimization; for most applications it's preferable to
86provide the `QueryClient` in the main application config, as in the examples above:
87```ts
88export const MY_QUERY_CLIENT = new InjectionToken('', {
89 factory: () => new QueryClient(),
90})
91β
92// In a lazy loaded route's providers array:
93providers: [provideTanStackQuery(() => inject(MY_QUERY_CLIENT))]
94```