snapshot of https://github.com/TanStack/query.git (main, 2026-09-16; blobs > 131072B omitted)

docs/framework/angular/guides/query-invalidation.md

@@ -0,0 +1,112 @@
+---
+id: query-invalidation
+title: Query Invalidation
+ref: docs/framework/react/guides/query-invalidation.md
+replace: { 'useQuery': 'injectQuery', 'hooks': 'functions' }
+---
+
+[//]: # 'Example2'
+
+```ts
+import { injectQuery, QueryClient } from '@tanstack/angular-query-experimental'
+
+class QueryInvalidationExample {
+  readonly queryClient = inject(QueryClient)
+
+  invalidateQueries() {
+    this.queryClient.invalidateQueries({ queryKey: ['todos'] })
+  }
+
+  // Both queries below will be invalidated
+  todoListQuery = injectQuery(() => ({
+    queryKey: ['todos'],
+    queryFn: fetchTodoList,
+  }))
+  todoListQuery = injectQuery(() => ({
+    queryKey: ['todos', { page: 1 }],
+    queryFn: fetchTodoList,
+  }))
+}
+```
+
+[//]: # 'Example2'
+
+You can even invalidate queries with specific variables by passing a more specific query key to the `invalidateQueries` method:
+
+[//]: # 'Example3'
+
+```ts
+queryClient.invalidateQueries({
+  queryKey: ['todos', { type: 'done' }],
+})
+
+// The query below will be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos', { type: 'done' }],
+  queryFn: fetchTodoList,
+}))
+
+// However, the following query below will NOT be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos'],
+  queryFn: fetchTodoList,
+}))
+```
+
+[//]: # 'Example3'
+
+The `invalidateQueries` API is very flexible, so even if you want to **only** invalidate `todos` queries that don't have any more variables or subkeys, you can pass an `exact: true` option to the `invalidateQueries` method:
+
+[//]: # 'Example4'
+
+```ts
+queryClient.invalidateQueries({
+  queryKey: ['todos'],
+  exact: true,
+})
+
+// The query below will be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos'],
+  queryFn: fetchTodoList,
+}))
+
+// However, the following query below will NOT be invalidated
+const todoListQuery = injectQuery(() => ({
+  queryKey: ['todos', { type: 'done' }],
+  queryFn: fetchTodoList,
+}))
+```
+
+[//]: # 'Example4'
+
+If you find yourself wanting **even more** granularity, you can pass a predicate function to the `invalidateQueries` method. This function will receive each `Query` instance from the query cache and allow you to return `true` or `false` for whether you want to invalidate that query:
+
+[//]: # 'Example5'
+
+```ts
+queryClient.invalidateQueries({
+  predicate: (query) =>
+    query.queryKey[0] === 'todos' && query.queryKey[1]?.version >= 10,
+})
+
+// The query below will be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos', { version: 20 }],
+  queryFn: fetchTodoList,
+}))
+
+// The query below will be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos', { version: 10 }],
+  queryFn: fetchTodoList,
+}))
+
+// However, the following query below will NOT be invalidated
+todoListQuery = injectQuery(() => ({
+  queryKey: ['todos', { version: 5 }],
+  queryFn: fetchTodoList,
+}))
+```
+
+[//]: # 'Example5'