test(react-query/ssr): add 'useQueries' test for SSR by sukvvon · Pull Request #9996 · TanStack/query

sukvvon · 2025-12-28T07:17:53Z

🎯 Changes

Add useQueries test for SSR in ssr.test.tsx.

✅ 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

New Features
- The useQueries hook is now part of the public API for managing multiple queries at once.
- Server-side rendering now supports prefetching and rendering of multiple queries.
Tests
- Added SSR test coverage validating prefetching, cache retrieval, and successful rendering of multiple queries.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

changeset-bot · 2025-12-28T07:17:57Z

⚠️ No Changeset found

Latest commit: c93e7c8

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 · 2025-12-28T07:18:03Z

📝 Walkthrough

Walkthrough

Added an SSR test that exercises useQueries with two queries, prefetches them, and verifies SSR output shows success statuses and cached data. Also exported useQueries from the react-query public API module.

Changes

Cohort / File(s)	Summary
Test Coverage `packages/react-query/src/__tests__/ssr.test.tsx`	New SSR test using `useQueries` to prefetch two queries, render SSR markup, and assert both queries are `success` and their data appear in the rendered output.
Public API Export `packages/react-query/src/index.ts`	Re-exported/exported `useQueries` from the public react-query module so it can be imported from the package root.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

fix(query-core, react-query): infinite re-renders in useQueries #9639 — Related changes and tests for useQueries behavior and queries observer adjustments.

Suggested reviewers

TkDodo
manudeli

Poem

"I hopped through tests with queries two,
SSR fields and caches too,
Prefetched crumbs led data near,
Success in markup, tidy and clear —
A rabbit cheers: export's here! 🐇✨"

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run `@coderabbitai generate docstrings` to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title accurately describes the main change: adding a useQueries test for SSR functionality in ssr.test.tsx.
Description check	✅ Passed	The PR description follows the required template with all sections completed, including Changes, Checklist, and Release Impact, with appropriate boxes checked.

✨ Finishing touches

📝 Generate docstrings

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment

📜 Recent review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 73e67fc and 2d4ae0f.

📒 Files selected for processing (1)

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

🚧 Files skipped from review as they are similar to previous changes (1)

packages/react-query/src/tests/ssr.test.tsx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

GitHub Check: Preview
GitHub Check: Test

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

nx-cloud · 2025-12-28T07:18:17Z

View your CI Pipeline Execution ↗ for commit c93e7c8

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

☁️ Nx Cloud last updated this comment at 2025-12-31 13:35:13 UTC

pkg-pr-new · 2025-12-28T07:19:44Z

More templates

@tanstack/angular-query-experimental

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

@tanstack/eslint-plugin-query

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: c93e7c8

codecov · 2025-12-28T07:23:24Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.39%. Comparing base (f616474) to head (c93e7c8).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff             @@
##             main    #9996       +/-   ##
===========================================
+ Coverage   45.82%   84.39%   +38.56%     
===========================================
  Files         200       26      -174     
  Lines        8525      378     -8147     
  Branches     1977      111     -1866     
===========================================
- Hits         3907      319     -3588     
+ Misses       4158       50     -4108     
+ Partials      460        9      -451

Components	Coverage Δ
@tanstack/angular-query-experimental	`∅ <ø> (∅)`
@tanstack/eslint-plugin-query	`∅ <ø> (∅)`
@tanstack/query-async-storage-persister	`∅ <ø> (∅)`
@tanstack/query-broadcast-client-experimental	`∅ <ø> (∅)`
@tanstack/query-codemods	`∅ <ø> (∅)`
@tanstack/query-core	`∅ <ø> (∅)`
@tanstack/query-devtools	`∅ <ø> (∅)`
@tanstack/query-persist-client-core	`∅ <ø> (∅)`
@tanstack/query-sync-storage-persister	`∅ <ø> (∅)`
@tanstack/query-test-utils	`∅ <ø> (∅)`
@tanstack/react-query	`96.73% <ø> (+0.32%)`	⬆️
@tanstack/react-query-devtools	`9.25% <ø> (ø)`
@tanstack/react-query-next-experimental	`∅ <ø> (∅)`
@tanstack/react-query-persist-client	`100.00% <ø> (ø)`
@tanstack/solid-query	`∅ <ø> (∅)`
@tanstack/solid-query-devtools	`∅ <ø> (∅)`
@tanstack/solid-query-persist-client	`∅ <ø> (∅)`
@tanstack/svelte-query	`∅ <ø> (∅)`
@tanstack/svelte-query-devtools	`∅ <ø> (∅)`
@tanstack/svelte-query-persist-client	`∅ <ø> (∅)`
@tanstack/vue-query	`∅ <ø> (∅)`
@tanstack/vue-query-devtools	`∅ <ø> (∅)`

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

test(react-query/ssr): add 'useQueries' test for SSR

73e67fc

github-actions bot added the package: react-query label Dec 28, 2025

sukvvon added 5 commits December 28, 2025 22:18

Merge branch 'main' into test/react-query-ssr-use-queries

2d4ae0f

Merge branch 'main' into test/react-query-ssr-use-queries

6056ff0

Merge branch 'main' into test/react-query-ssr-use-queries

1e86c8f

Merge branch 'main' into test/react-query-ssr-use-queries

40ed387

Merge branch 'main' into test/react-query-ssr-use-queries

c93e7c8

manudeli approved these changes Jan 11, 2026

View reviewed changes

manudeli merged commit 44c3cb9 into TanStack:main Jan 11, 2026
9 checks passed

This was referenced Jan 18, 2026

fix(react-query): improve useQueries select inference #10051

Open

fix(react-query/HydrationBoundary): prevent unnecessary refetch during hydration #9968

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

test(react-query/ssr): add 'useQueries' test for SSR#9996

test(react-query/ssr): add 'useQueries' test for SSR#9996
manudeli merged 6 commits intoTanStack:mainfrom
sukvvon:test/react-query-ssr-use-queries

sukvvon commented Dec 28, 2025 •

edited by coderabbitai bot

Loading

Uh oh!

changeset-bot bot commented Dec 28, 2025 •

edited

Loading

Uh oh!

coderabbitai bot commented Dec 28, 2025 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

Uh oh!

nx-cloud bot commented Dec 28, 2025 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Dec 28, 2025 •

edited

Loading

Uh oh!

codecov bot commented Dec 28, 2025 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

sukvvon commented Dec 28, 2025 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Dec 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

coderabbitai bot commented Dec 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Suggested reviewers

Poem

Pre-merge checks and finishing touches

Uh oh!

nx-cloud bot commented Dec 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

codecov bot commented Dec 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

sukvvon commented Dec 28, 2025 •

edited by coderabbitai bot

Loading

changeset-bot bot commented Dec 28, 2025 •

edited

Loading

coderabbitai bot commented Dec 28, 2025 •

edited

Loading

nx-cloud bot commented Dec 28, 2025 •

edited

Loading

pkg-pr-new bot commented Dec 28, 2025 •

edited

Loading

codecov bot commented Dec 28, 2025 •

edited

Loading