docs(react-query): add caveat for typing getQueriesData

camjackson · camjackson · commit 084dcb7d2277 · 2025-09-24T22:09:22.000+10:00
diff --git a/docs/framework/react/typescript.md b/docs/framework/react/typescript.md
@@ -237,6 +237,13 @@ Without `queryOptions`, the type of `data` would be `unknown`, unless we'd pass
 const data = queryClient.getQueryData<Group[]>(['groups'])
 ```
 
+Note that type inference via `queryOptions` does _not_ work for `queryClient.getQueriesData`, as this function can return data of varying types and is therefore `unknown`. If you are sure of the types that your query will return, you can specify it explicitly:
+
+```ts
+const data = queryClient.getQueriesData<Group>(groupOptions().queryKey)
+//     ^? const data: Group[] | undefined
+```
+
 ## Typing Mutation Options
 
 Similarly to `queryOptions`, you can use `mutationOptions` to extract mutation options into a separate function:
