chore: prefer `React.use` instead of throwing promises [WIP] by juliusmarminge · Pull Request #10012 · TanStack/query

juliusmarminge · 2026-01-02T18:01:29Z

🎯 Changes

Migrate to use React.use when available instead of throwing promises. This adds support for the suspended by state in the React Devtools:

Before

After

<add screenshot>

Ref: https://discord.com/channels/719702312431386674/1446346759776370772

✅ 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).

changeset-bot · 2026-01-02T18:01:33Z

⚠️ No Changeset found

Latest commit: 2507184

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

coderabbitai · 2026-01-02T18:01:34Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

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 and usage tips.}

nx-cloud · 2026-01-02T18:01:58Z

🤖 Nx Cloud AI Fix Eligible

An automatically generated fix could have helped fix failing tasks for this run, but Self-healing CI is disabled for this workspace. Visit workspace settings to enable it and get automatic fixes in future runs.

_{To disable these notifications, a workspace admin can disable them in workspace settings.}

View your CI Pipeline Execution ↗ for commit 2507184

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

☁️ Nx Cloud last updated this comment at 2026-01-02 20:48:00 UTC

pkg-pr-new · 2026-01-02T18:04:36Z

More templates

@tanstack/angular-query-experimental

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

@tanstack/eslint-plugin-query

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: 2507184

github-actions · 2026-01-02T18:04:46Z

size-limit report 📦

Path	Size
react full	11.9 KB (+0.44% 🔺)
react minimal	8.98 KB (+0.63% 🔺)

TkDodo · 2026-01-02T18:40:47Z

packages/react-query/src/useBaseQuery.ts

+      observer,
+      errorResetBoundary,
+    )
+    suspend(promise.finally(() => observer.updateResult()))


why isn’t this just suspend(promise) ? also, do we need to return after that ? I think throw usually stops execution of the rest?

prefer React.use instead of throwing promises

c456efa

juliusmarminge changed the title ~~chore: prefer React.use instead of throwing promises~~ chore: prefer React.use instead of throwing promises [WIP] Jan 2, 2026

github-actions bot added the package: react-query label Jan 2, 2026

ci: apply automated fixes

9cbb833

fianlly

c0781f5

TkDodo reviewed Jan 2, 2026

View reviewed changes

add simple start example

a54628b

github-actions bot added package: vue-query package: vue-query-devtools labels Jan 2, 2026

try manual wrap, no difference

cc7a99f

juliusmarminge force-pushed the react-use branch from 4289738 to cc7a99f Compare January 2, 2026 20:43

ci: apply automated fixes

2507184

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

chore: prefer `React.use` instead of throwing promises [WIP]#10012

chore: prefer `React.use` instead of throwing promises [WIP]#10012
juliusmarminge wants to merge 6 commits intomainfrom
react-use

juliusmarminge commented Jan 2, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Jan 2, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Jan 2, 2026

Review skipped

Uh oh!

nx-cloud bot commented Jan 2, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 2, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 2, 2026 •

edited

Loading

Uh oh!

TkDodo Jan 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

juliusmarminge commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

Before

After

✅ Checklist

🚀 Release Impact

Uh oh!

changeset-bot bot commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

coderabbitai bot commented Jan 2, 2026

Review skipped

Uh oh!

nx-cloud bot commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 Nx Cloud AI Fix Eligible

Uh oh!

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

Uh oh!

Uh oh!

github-actions bot commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

TkDodo Jan 2, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

juliusmarminge commented Jan 2, 2026 •

edited

Loading

changeset-bot bot commented Jan 2, 2026 •

edited

Loading

nx-cloud bot commented Jan 2, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 2, 2026 •

edited

Loading

github-actions bot commented Jan 2, 2026 •

edited

Loading