docs(reference/QueryCache): correct the 'find' and 'findAll' options to match their filter types by sukvvon · Pull Request #10884 · TanStack/query · GitHub
Skip to content

docs(reference/QueryCache): correct the 'find' and 'findAll' options to match their filter types - #10884

Merged
sukvvon merged 1 commit into
mainfrom
docs/query-cache-find-findall-options
Jun 4, 2026
Merged

sukvvon merged 1 commit into
mainfrom
docs/query-cache-find-findall-options

Conversation

@sukvvon

@sukvvon sukvvon commented Jun 4, 2026 •

Copy link
Copy Markdown
Member

🎯 Changes

Corrects the options listed for find and findAll in the QueryCache reference to match their actual filter types:

  • find(filters: WithRequired<QueryFilters, 'queryKey'>) — both filters and its queryKey are required, so filters is no longer marked optional and queryKey is documented as a required nested option.
  • findAll(filters: QueryFilters = {}) — filters is optional; queryKey is just one of its properties (covered by the linked Query Filters), so the misplaced top-level queryKey entry is removed.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

  • Documentation
    • Updated API documentation for queryCache.find method: filters parameter is now required.
    • Updated queryCache.findAll method's options section structure and parameter documentation for clarity.

@coderabbitai

coderabbitai Bot commented Jun 4, 2026 •

Copy link
Copy Markdown
Contributor

@nx-cloud

nx-cloud Bot commented Jun 4, 2026 •

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit d4e651d

Command Status Duration Result
nx run-many --target=build --exclude=examples/*... ✅ Succeeded <1s View ↗
nx affected --targets=test:sherif,test:knip,tes... ✅ Succeeded 26s View ↗

☁️ Nx Cloud last updated this comment at 2026-06-04 11:29:10 UTC

@sukvvon sukvvon self-assigned this Jun 4, 2026
@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@pkg-pr-new

pkg-pr-new Bot commented Jun 4, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@10884

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@10884

@tanstack/lit-query

npm i https://pkg.pr.new/@tanstack/lit-query@10884

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@10884

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@10884

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@10884

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@10884

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@10884

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@10884

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@10884

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@10884

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@10884

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@10884

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@10884

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@10884

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@10884

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@10884

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@10884

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@10884

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@10884

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@10884

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@10884

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@10884

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@10884

commit: d4e651d

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size
react full 12.11 KB (0%)
react minimal 9.08 KB (0%)

@sukvvon
sukvvon merged commit 3270e09 into main Jun 4, 2026
9 checks passed
@sukvvon
sukvvon deleted the docs/query-cache-find-findall-options branch June 4, 2026 11:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant