SWR

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…

Patches

• build: bump bundler for perf by @huozhi in https://github.com/vercel/swr/pull/2929
• Fix bundling of client entry chunks by @huozhi in https://github.com/vercel/swr/pull/2932

Full Changelog:…

What's Changed

• build: fix beta release job by @huozhi in https://github.com/vercel/swr/pull/2895
• chore: Improve test coverage by @shuding in https://github.com/vercel/swr/pull/2903
• chore: simplify test coverage strategy by @huozhi in…

Patches

• types: isLoading typed as boolean when using fallbackData (#2866) by @yjrhgvbn in https://github.com/vercel/swr/pull/2875
• fix: allow onErrorRetry on inactive tab without focus/reconnect revalidation by @qkdreyer in https://github.com/vercel/swr/pull/2848 *…