ref: switch to use() by TkDodo · Pull Request #11237 · TanStack/query

TkDodo · 2026-08-20T10:19:25Z

Summary by CodeRabbit

Bug Fixes
- Improved Suspense behavior across queries, including promise reuse, parallel loading, fallback handling, and error recovery.
- Improved support for transitioned queries, cached or stale data, and skip-token scenarios.
- Enhanced compatibility across React versions when handling Suspense-enabled queries.
- Improved consistency when rendering Suspense content asynchronously.
Tests
- Expanded coverage for Suspense queries, infinite queries, prefetching, retries, and error boundaries.
- Improved validation of asynchronous rendering, loading states, fallback behavior, and cached promise reuse.

nx-cloud · 2026-08-20T10:19:56Z

View your CI Pipeline Execution ↗ for commit 8a8555a

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

☁️ Nx Cloud last updated this comment at 2026-08-22 08:57:22 UTC

coderabbitai · 2026-08-20T10:20:04Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 63ebf11a-07a8-46a6-96db-5027f0ba6fe5

📥 Commits

Reviewing files that changed from the base of the PR and between 106f3c3 and 8a8555a.

📒 Files selected for processing (1)

packages/react-query/src/__tests__/transition.test.tsx

Included review availability: Your plan provides up to 10 included reviews per hour; 6 remain after this review.

📝 Walkthrough

Walkthrough

React Query now caches suspense promises, consumes them through React’s use, and starts multiple suspense queries before suspension. Tests use an asynchronous suspense renderer and asynchronous act for retries and query updates.

Changes

Suspense integration

Layer / File(s)	Summary
Suspense promise handling and query hook flow `packages/react-query/src/suspense.ts`, `packages/react-query/src/useBaseQuery.ts`, `packages/react-query/src/useQueries.ts`	Added React-compatible thenable handling and per-query promise caching. Query hooks now consume suspense promises with `use()`, and `useQueries` starts all suspense fetches before suspension.
Suspense test renderer and query suites `packages/react-query/src/__tests__/utils.tsx`, `packages/react-query/src/__tests__/suspense.test.tsx`, `packages/react-query/src/__tests__/useSuspenseQuery.test.tsx`, `packages/react-query/src/__tests__/useSuspenseQueries.test.tsx`, `packages/react-query/src/__tests__/useSuspenseInfiniteQuery.test.tsx`	Renamed and expanded the suspense renderer. Tests now use configurable fallbacks, await suspense rendering, and wrap asynchronous interactions in `act`.
Prefetch and error-boundary test updates `packages/react-query/src/__tests__/QueryResetErrorBoundary.test.tsx`, `packages/react-query/src/__tests__/usePrefetchQuery.test.tsx`, `packages/react-query/src/__tests__/usePrefetchInfiniteQuery.test.tsx`	Updated suspense rendering helpers and asynchronous retry interactions while preserving existing assertions.
Release metadata `.changeset/tasty-ears-study.md`	Added a patch Changeset for the suspense implementation change.

Estimated code review effort: 4 (Complex) | ~45 minutes

Merge Risk: ⚪ Minimal · up to 8a855

This change is merge-ready after normal checks and review; no actionable merge-blocking risk remains.

Sequence Diagram(s)

sequenceDiagram
  participant QueryHook
  participant SuspenseUtilities
  participant React
  QueryHook->>SuspenseUtilities: request suspense promise
  SuspenseUtilities-->>QueryHook: return cached or new promise
  QueryHook->>React: call use with thenable
  React-->>QueryHook: suspend until settlement
  React-->>QueryHook: render data or throw error

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The pull request has no description, so it does not provide the required changes, checklist, or release impact information.	Add the required Changes, Checklist, and Release Impact sections, and complete the applicable checklist items.
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 6 files.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: switching React suspense handling to use().
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch tkdodo/ref/use-over-throw

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-08-20T10:20:37Z

🚀 Changeset Version Preview

11 package(s) bumped directly, 14 bumped as dependents.

🟨 Minor bumps

Package	Version	Reason
`@tanstack/angular-query-experimental`	5.101.4 → 5.102.0	Changeset
`@tanstack/eslint-plugin-query`	5.101.4 → 5.102.0	Changeset
`@tanstack/preact-query`	5.101.4 → 5.102.0	Changeset
`@tanstack/query-broadcast-client-experimental`	5.101.4 → 5.102.0	Changeset
`@tanstack/query-core`	5.101.4 → 5.102.0	Changeset
`@tanstack/react-query`	5.101.4 → 5.102.0	Changeset
`@tanstack/solid-query`	5.101.4 → 5.102.0	Changeset
`@tanstack/vue-query`	5.101.4 → 5.102.0	Changeset
`@tanstack/angular-query-persist-client`	5.101.4 → 5.102.0	Dependent
`@tanstack/preact-query-devtools`	5.101.4 → 5.102.0	Dependent
`@tanstack/preact-query-persist-client`	5.101.4 → 5.102.0	Dependent
`@tanstack/query-async-storage-persister`	5.101.4 → 5.102.0	Dependent
`@tanstack/query-devtools`	5.101.4 → 5.102.0	Dependent
`@tanstack/query-persist-client-core`	5.101.4 → 5.102.0	Dependent
`@tanstack/query-sync-storage-persister`	5.101.4 → 5.102.0	Dependent
`@tanstack/react-query-devtools`	5.101.4 → 5.102.0	Dependent
`@tanstack/react-query-next-experimental`	5.101.4 → 5.102.0	Dependent
`@tanstack/react-query-persist-client`	5.101.4 → 5.102.0	Dependent
`@tanstack/solid-query-devtools`	5.101.4 → 5.102.0	Dependent
`@tanstack/solid-query-persist-client`	5.101.4 → 5.102.0	Dependent

🟩 Patch bumps

Package	Version	Reason
`@tanstack/lit-query`	0.2.11 → 0.2.12	Changeset
`@tanstack/svelte-query`	6.1.38 → 6.1.39	Changeset
`@tanstack/vue-query-devtools`	6.1.38 → 6.1.39	Changeset
`@tanstack/svelte-query-devtools`	6.1.38 → 6.1.39	Dependent
`@tanstack/svelte-query-persist-client`	6.1.38 → 6.1.39	Dependent

pkg-pr-new · 2026-08-20T10:22:06Z

More templates

@tanstack/angular-query-experimental

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

@tanstack/eslint-plugin-query

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

@tanstack/lit-query

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

@tanstack/preact-query

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

@tanstack/preact-query-devtools

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

@tanstack/preact-query-persist-client

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: 8a8555a

github-actions · 2026-08-20T10:22:31Z

size-limit report 📦

Path	Size
react full	12.17 KB (+1.62% 🔺)
react minimal	9.14 KB (+2.42% 🔺)

ref: switch to use()

05ddd94

TkDodo added 7 commits August 20, 2026 12:30

add changeset

64e861f

reorg test helpers

c0c7462

fix: one stable thenable per query

27bea1c

Merge branch 'main' into tkdodo/ref/use-over-throw

106f3c3

Merge branch 'main' into tkdodo/ref/use-over-throw

4cd2b96

fix: transition tests

38b5cde

Merge branch 'main' into tkdodo/ref/use-over-throw

8a8555a

Navigation Menu

Uh oh!

Uh oh!

ref: switch to use() - #11237

ref: switch to use()#11237
TkDodo wants to merge 8 commits into
mainfrom
tkdodo/ref/use-over-throw

TkDodo commented Aug 20, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

nx-cloud Bot commented Aug 20, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Aug 20, 2026 •

edited

Loading

Reviews paused

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (2 warnings)

Uh oh!

github-actions Bot commented Aug 20, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Aug 20, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 20, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

TkDodo commented Aug 20, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

nx-cloud Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Sequence Diagram(s)

❌ Failed checks (2 warnings)

Uh oh!

github-actions Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Changeset Version Preview

🟨 Minor bumps

🟩 Patch bumps

Uh oh!

pkg-pr-new Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

TkDodo commented Aug 20, 2026 •

edited by coderabbitai Bot

Loading

nx-cloud Bot commented Aug 20, 2026 •

edited

Loading

coderabbitai Bot commented Aug 20, 2026 •

edited

Loading

github-actions Bot commented Aug 20, 2026 •

edited

Loading

pkg-pr-new Bot commented Aug 20, 2026 •

edited

Loading

github-actions Bot commented Aug 20, 2026 •

edited

Loading