SWR

Adds cache tag revalidation support, letting cached data be revalidated by tag. Remaining changes are CI config and a docs link fix.

Fixed suspense cacheData not revalidating on remount, plus hydration of cacheData for hooks without a fetcher and cleanup of completed subscription state.

Preload data in React Server Components and pass it to client hooks through the experimental cacheData option on SWRConfig, avoiding a duplicate initial browser request. The new unload() API clears the entire SWR cache and discards in-flight requests and mutations.

Adds the unload() API for clearing cached data.

SWR now supports React Server Component fetches and can prefill the SWR cache. Fixed the _internal react-server export to point at an existing file.

Fixed a double-unsubscribe bug that could remove the wrong subscriber from the cache, and prevented resolved promises from suspending due to a missing status.

Removed the deprecated downlevelIteration option and fixed a revalidation bug reported in issue #4221.

What's Changed

• chore: Migrate suspense related tests to e2e by @promer94 in https://github.com/vercel/swr/pull/4204
• CI: add missing flag for canary test by @promer94 in https://github.com/vercel/swr/pull/4206
• fix: Ensure useSWRImmutable overrides global…

What's Changed

• deps: upgrade dev deps for build by @promer94 in https://github.com/vercel/swr/pull/4188
• update use-sync-external-store to latest by @huozhi in https://github.com/vercel/swr/pull/4189
• fix: cve-2025-55182 critical rce vulnerability by @PierreCrb in…

What's Changed

• deps: upgrade ci node version to 22 by @promer94 in https://github.com/vercel/swr/pull/4184
• deps: upgrade pnpm version by @promer94 in https://github.com/vercel/swr/pull/4185
• deps: upgrade playwright version by @promer94 in…

Patches

• fix: do not error when not enabled during suspense by @huozhi in https://github.com/vercel/swr/pull/4156

Full Changelog: https://github.com/vercel/swr/compare/v2.3.5...v2.3.6

Patches

• perf: optimize useSWRConfig with useMemo to maintain stable reference by @samuel871211 in https://github.com/vercel/swr/pull/4110 https://github.com/vercel/swr/pull/4076
• fix: react.use should not depend on data condition by @huozhi in…

Patches

• perf: optimize useSWRConfig with useMemo to maintain stable reference by @samuel871211 in https://github.com/vercel/swr/pull/4110
• doc: Sync PublicConfiguration.onDiscarded tsdoc with SWR official website by @samuel871211 in…

What's Changed

• Fix markdown typo by @Nusab19 in https://github.com/vercel/swr/pull/4106
• fix: check "if (!error)" skip error if value is cast to false by @vtgrachev in https://github.com/vercel/swr/pull/4118
• feat: Improve global suspense-enabled data type by @oosawy…

Patches

• enhance: use empty prototype object by @huozhi in https://github.com/vercel/swr/pull/4099
• Initialise nextFocusRevalidatedAt on mount by @mgoodfellow in https://github.com/vercel/swr/pull/2857

Misc

• Update Twitter references to X by @ManuLpz4 in…

Patches

• (fix) keepPreviousData: return fallback instead of undefined value by @dvoytenko in https://github.com/vercel/swr/pull/4087

Full Changelog: https://github.com/vercel/swr/compare/v2.3.1...v2.3.2

Fixes

• fix: missing throwOnError in SWRMutationHook options by @Ram4GB in https://github.com/vercel/swr/pull/3054
• fix: sever env detection for deno by @elrrrrrrr in https://github.com/vercel/swr/pull/4064
• keepPreviousData: return fallback instead of undefined value…

Feature

• Support promises as fallback data by @shuding in https://github.com/vercel/swr/pull/2891
• Allow to use with React 19 by @vladshcherbin and @devjiwonchoi in https://github.com/vercel/swr/pull/3047, https://github.com/vercel/swr/pull/2963

Patches

• fix…

What's Changed

• fix: Improve comparison performance by @shuding in https://github.com/vercel/swr/pull/2973

Full Changelog: https://github.com/vercel/swr/compare/v2.2.6-beta.3...v2.2.6-beta.4

What's Changed

• ci: fix ci error and upgrade action version by @promer94 in https://github.com/vercel/swr/pull/2952
• Add SWRInfiniteMutatorOptions type to export by @ludwigbacklund in https://github.com/vercel/swr/pull/2954
• test: update the revalidate function test for…