From e010720250ea10bbaac5b61e15a4b1359973dd84 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Tue, 30 Sep 2025 13:01:40 -0400 Subject: [PATCH 01/30] wip --- .../diagrams/19_2_batching_after.dark.png | Bin 0 -> 42475 bytes .../docs/diagrams/19_2_batching_after.png | Bin 0 -> 42853 bytes .../diagrams/19_2_batching_before.dark.png | Bin 0 -> 43226 bytes .../docs/diagrams/19_2_batching_before.png | Bin 0 -> 43567 bytes ...labs-view-transitions-activity-and-more.md | 6 +- src/content/blog/2025/09/30/react-19-2.md | 231 ++++++++++++++++++ src/content/blog/index.md | 6 + 7 files changed, 239 insertions(+), 4 deletions(-) create mode 100644 public/images/docs/diagrams/19_2_batching_after.dark.png create mode 100644 public/images/docs/diagrams/19_2_batching_after.png create mode 100644 public/images/docs/diagrams/19_2_batching_before.dark.png create mode 100644 public/images/docs/diagrams/19_2_batching_before.png create mode 100644 src/content/blog/2025/09/30/react-19-2.md diff --git a/public/images/docs/diagrams/19_2_batching_after.dark.png b/public/images/docs/diagrams/19_2_batching_after.dark.png new file mode 100644 index 0000000000000000000000000000000000000000..29ff140939bdbb942a9410ccef49cc719ff00c1b GIT binary patch literal 42475 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

6AocwT`r=UhDSrXa%d2mu>|!Mcz4m|jP?71( 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 K(@tE!_kRE^NL0H3 literal 0 HcmV?d00001 diff --git a/public/images/docs/diagrams/19_2_batching_after.png b/public/images/docs/diagrams/19_2_batching_after.png new file mode 100644 index 0000000000000000000000000000000000000000..0ae652f7928e9f917e71fd4fab83e343b7cc9cf2 GIT binary patch literal 42853 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

5i})pzOGgKW%u%#fVLN9l+@Z^x)1CI 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 literal 0 HcmV?d00001 diff --git a/public/images/docs/diagrams/19_2_batching_before.dark.png b/public/images/docs/diagrams/19_2_batching_before.dark.png new file mode 100644 index 0000000000000000000000000000000000000000..758afceb150c57242ee73862e9e4941f4a01e365 GIT binary patch literal 43226 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 JRqr^G^#`HJ8!G?+ literal 0 HcmV?d00001 diff --git a/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md b/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md index 5d2c59b7615..693bb04ec0f 100644 --- a/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md +++ b/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md @@ -18,11 +18,9 @@ In React Labs posts, we write about projects in active research and development. -React Conf 2025 is scheduled for October 7–8 in Henderson, Nevada! +React Conf 2025 is scheduled for October 7–8 in Henderson, Nevada! -We're looking for speakers to help us create talks about the features covered in this post. If you're interested in speaking at ReactConf, [please apply here](https://forms.reform.app/react-conf/call-for-speakers/) (no talk proposal required). - -For more info on tickets, free streaming, sponsoring, and more, see [the React Conf website](https://conf.react.dev). +Watch the livestream on [the React Conf website](https://conf.react.dev). diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/09/30/react-19-2.md new file mode 100644 index 00000000000..0f173d1b8b0 --- /dev/null +++ b/src/content/blog/2025/09/30/react-19-2.md @@ -0,0 +1,231 @@ +--- +title: "React 19.2" +author: The React Team +date: 2025/09/30 +description: This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience. +--- + +September 30, 2025 by [The React Team](/community/team) + +--- + + + +React 19.2 is now available on npm! + + + + + + +React Conf 2025 is October 7–8 in Henderson, Nevada! + +Watch the livestream on [the React Conf website](https://conf.react.dev). + + + +React 19.2 is our third release in the last year, following React 19 in December and React 19.1 in June. + +This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience. + +In this post, we'll give an overview of the new features in React 19.2, and how you can adopt them. + +--- + +## New Features {/*new-features*/} + +### `` {/*activity*/} + +`` lets you break your app into "activities" that can be controlled and prioritized. + +In React 19.2, Activity supports two modes: `visible` and `hidden`: + +```js + + + +``` + +When an Activity is `visible` it’s rendered as normal on the client, and will defer hydration during SSR. When an Activity is `hidden` it is unmounted (adding `display:none` to the children) and is excluded from the SSR output. While an Activity is hidden, React will keep the hook and DOM state, and continue to render at a lower priority than anything visible on screen. + +You can use Activity to pre-render hidden parts of the app that a user is likely to navigate to next, or to save the state of parts the user navigates away from. This helps make navigations quicker, and allows back navigations to maintain state such as input fields. + +For more information, see the last [React Labs post](/blog/2025/04/23/react-labs-view-transitions-activity-and-more#activity) and the [Activity docs](/reference/react/activity). + +--- + +### React Performance Tracks {/*react-performance-tracks*/} + + +React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app: + +

+ +For more information, see the [React Performance Tracks docs](/learn/react-performance-tracks). + +--- + +### `useEffectEvent` {/*use-effect-event*/} + +When using Effects you may want to read the most recent props or state inside an Effect without causing the Effect to re-run when those values change. + +The typical workaround is to use a ref to store the latest `theme`, and read from that ref inside the Effect. This works, but it’s verbose and requires extra code, so in practice most users just disable the lint rule and leave the dependency out. + +Disabling the lint rule creates a refactor hazard, because the linter cannot help you if you later add a dependency that should be included. Here, `threadId` is added after the initial implementation, but the Effect does not re-run when `threadId` changes because it was not added to the dependency array: + +```js {1,3,12} +function ChatRoom({ roomId, theme, threadId }) { + useEffect(() => { + const connection = createConnection(serverUrl, roomId + threadId); + connection.on('connected', () => { + showNotification('Connected!', theme); + }); + connection.connect(); + return () => { + connection.disconnect() + }; + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [roomId]); // 🚩 threadId is missing! + // ... +``` + +To solve this problem, React 19.2 introduces `useEffectEvent`, which lets you declare Effect Events that can be called inside Effects. Effect Events always access the latest values from props and state when they are invoked, so you can read the latest values without re-running the Effect. + +```js {2,3,4,9} +function ChatRoom({ roomId, theme, threadId }) { + const onConnected = useEffectEvent(() => { + showNotification('Connected!', theme); + }); + + useEffect(() => { + const connection = createConnection(serverUrl, roomId, threadId); + connection.on('connected', () => { + onConnected(); + }); + connection.connect(); + return () => connection.disconnect(); + }, [roomId, threadId]); // ✅ All dependencies declared + // ... +``` + +For more information, see [Separating Events from Effects](/learn/separating-events-from-effects) and the [`useEffectEvent` docs](/reference/react/useEffectEvent). + +--- + +### `cacheSignal` {/*cache-signal*/} + + + +`cacheSignal` is only for use with [React Server Components](/reference/rsc/server-components). + + + +`cacheSignal` allows you to know when the [`cache()`](/reference/react/cache) lifetime is over: + +``` +import {cache, cacheSignal} from 'react'; +const dedupedFetch = cache(fetch); + +async function Component() { + await dedupedFetch(url, { signal: cacheSignal() }); +} +``` + +This allows you to clean up or abort work when the result will no longer be used in the cache, such as: + +- React has successfully completed rendering +- The render was aborted +- The render has failed + +For more info, see the [`cacheSignal` docs](/reference/react/cacheSignal). + +--- + +## Notable Changes {/*notable-changes*/} + +### Batching Suspense Boundaries for SSR {/*batching-suspense-boundaries-for-ssr*/} + +We fixed a long-standing behavior bug where Suspense boundaries would reveal differently depending on if they were rendered on the client or when streaming from server-side rendering. + +Starting in 19.2, React will batch reveals of server-rendered Suspense boundaries for a short time, to allow more content to be revealed together and align with the client-rendered behavior. + + + +Previously, during streaming server-side rendering, suspense content would immediately replace fallbacks. + + + + + +In React 19.2, suspense boundaries are batched for a small amount of time, to allow revealing more content together. + + + +This fix also prepares apps for supporting `` for Suspense during SSR. By revealing more content together, animations can run in larger batches of content, and avoid chaining animations of content that streams in close together. + + + +React uses heuristics to ensure throttling does not impact core web vitals and search ranking. + +For example, if the total page load time is approaching 2.5s (which is the time considered "good" for [LCP](https://web.dev/articles/lcp)), React will stop batching and reveal content immediately so that the throttling is not the reason to miss the metric. + + + +--- + +### SSR: Web Streams support for Node {/*ssr-web-streams-support-for-node*/} + +React 19.2 adds support for Web Streams for streaming SSR in Node.js: +- [`renderToReadableStream`](/reference/react-dom/server/renderToReadableStream) is now available for Node.js +- [`prerender`](/reference/react-dom/static/prerender) is now available for Node.js + + + +We still highly recommend using Node Streams for streaming server-side rendering in Node environments because Node Streams are much faster than Web Streams, and Web Streams do not support compression by default, leading to users accidentally missing the benefits of streaming. + + + +--- + +### Update the default `useId` prefix {/*update-the-default-useid-prefix*/} + +In 19.2, we're updating the default `useId` prefix from `:r:` (19.0.0) or `«r»` (19.1.0) to `_r_`. + +The original intent of using a special character that was not valid for CSS selectors was that it would be unlikely to collide with IDs written by users. However, to support View Transitions, we need to ensure that IDs generated by `useId` are valid for `view-transition-name` and XML 1.0 names. + +--- + +## Changelog {/*changelog*/} + +Other notable changes +- `react-dom`: Allow nonce to be used on hoistable styles [#32461](https://github.com/facebook/react/pull/32461) +- `react-dom`: Warn for using a React owned node as a Container if it also has text content [#32774](https://github.com/facebook/react/pull/32774) + +Notable bug fixes +- `react`: Stringify context as "SomeContext" instead of "SomeContext.Provider" [#33507](https://github.com/facebook/react/pull/33507) +- `react`: Fix infinite useDeferredValue loop in popstate event [#32821](https://github.com/facebook/react/pull/32821) +- `react`: Fix a bug when an initial value was passed to useDeferredValue [#34376](https://github.com/facebook/react/pull/34376) +- `react`: Fix a crash when submitting forms with Client Actions [#33055](https://github.com/facebook/react/pull/33055) +- `react`: Hide/unhide the content of dehydrated suspense boundaries if they resuspend [#32900](https://github.com/facebook/react/pull/32900) +- `react`: Avoid stack overflow on wide trees during Hot Reload [#34145](https://github.com/facebook/react/pull/34145) +- `react`: Improve component stacks in various places [#33629](https://github.com/facebook/react/pull/33629), [#33724](https://github.com/facebook/react/pull/33724), [#32735](https://github.com/facebook/react/pull/32735), [#33723](https://github.com/facebook/react/pull/33723) +- `react`: Fix a bug with React.use inside React.lazy-ed Component (@hi-ogawa [#33941](https://github.com/facebook/react/pull/33941) +- `react-dom`: Stop warning when ARIA 1.3 attributes are used (@Abdul-Omira [#34264](https://github.com/facebook/react/pull/34264) +- `react-dom`: Fix a bug with deeply nested Suspense inside Suspense fallbacks [#33467](https://github.com/facebook/react/pull/33467) +- `react-dom`: Avoid hanging when suspending after aborting while rendering (@gnoff [#34192)]() + +For a full list of changes, please see the [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md). + + +--- + +_Thanks to everyone who helped review this post._ diff --git a/src/content/blog/index.md b/src/content/blog/index.md index a7a89763419..557c5f09123 100644 --- a/src/content/blog/index.md +++ b/src/content/blog/index.md @@ -12,6 +12,12 @@ You can also follow the [@react.dev](https://bsky.app/profile/react.dev) account
+ + +This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience ... + + + In React Labs posts, we write about projects in active research and development. In this post, we're sharing two new experimental features that are ready to try today, and sharing other areas we're working on now ... From 0830263ba6bdf01a752ad61a2fa04cb9f0c55efa Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:12:24 -0400 Subject: [PATCH 02/30] feedback and rm canary stuff --- ...labs-view-transitions-activity-and-more.md | 4 +- src/content/blog/2025/09/30/react-19-2.md | 85 ++++++++++++------- .../learn/removing-effect-dependencies.md | 8 -- .../learn/reusing-logic-with-custom-hooks.md | 8 -- .../learn/separating-events-from-effects.md | 24 ------ src/content/reference/react/Activity.md | 19 ++--- src/content/reference/react/useEffect.md | 10 +-- src/content/reference/react/useEffectEvent.md | 10 --- src/sidebarReference.json | 2 - 9 files changed, 60 insertions(+), 110 deletions(-) diff --git a/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md b/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md index 693bb04ec0f..6d3faa6ce34 100644 --- a/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md +++ b/src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md @@ -11542,7 +11542,7 @@ Try searching for a video, selecting it, and clicking "back": ```js src/App.js -import { unstable_ViewTransition as ViewTransition, unstable_Activity as Activity } from "react"; import Details from "./Details"; import Home from "./Home"; import { useRouter } from "./router"; +import { unstable_ViewTransition as ViewTransition, Activity } from "react"; import Details from "./Details"; import Home from "./Home"; import { useRouter } from "./router"; export default function App() { const { url } = useRouter(); @@ -12879,7 +12879,7 @@ With this update, if the content on the next page has time to pre-render, it wil ```js src/App.js -import { unstable_ViewTransition as ViewTransition, unstable_Activity as Activity, use } from "react"; import Details from "./Details"; import Home from "./Home"; import { useRouter } from "./router"; import {fetchVideos} from './data' +import { unstable_ViewTransition as ViewTransition, Activity, use } from "react"; import Details from "./Details"; import Home from "./Home"; import { useRouter } from "./router"; import {fetchVideos} from './data' export default function App() { const { url } = useRouter(); diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/09/30/react-19-2.md index 0f173d1b8b0..e24742cf78d 100644 --- a/src/content/blog/2025/09/30/react-19-2.md +++ b/src/content/blog/2025/09/30/react-19-2.md @@ -15,20 +15,11 @@ React 19.2 is now available on npm! +This is our third release in the last year, following React 19 in December and React 19.1 in June. In this post, we'll give an overview of the new features in React 19.2, and highlight some notable changes. - - -React Conf 2025 is October 7–8 in Henderson, Nevada! + -Watch the livestream on [the React Conf website](https://conf.react.dev). - - -React 19.2 is our third release in the last year, following React 19 in December and React 19.1 in June. - -This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience. - -In this post, we'll give an overview of the new features in React 19.2, and how you can adopt them. --- @@ -38,19 +29,30 @@ In this post, we'll give an overview of the new features in React 19.2, and how `` lets you break your app into "activities" that can be controlled and prioritized. -In React 19.2, Activity supports two modes: `visible` and `hidden`: +You can use Activity as an alternative to conditionally rendering parts of your app: ```js +// Before +{isVisible && } + +// After ``` -When an Activity is `visible` it’s rendered as normal on the client, and will defer hydration during SSR. When an Activity is `hidden` it is unmounted (adding `display:none` to the children) and is excluded from the SSR output. While an Activity is hidden, React will keep the hook and DOM state, and continue to render at a lower priority than anything visible on screen. - -You can use Activity to pre-render hidden parts of the app that a user is likely to navigate to next, or to save the state of parts the user navigates away from. This helps make navigations quicker, and allows back navigations to maintain state such as input fields. +In React 19.2, Activity supports two modes: `visible` and `hidden`. -For more information, see the last [React Labs post](/blog/2025/04/23/react-labs-view-transitions-activity-and-more#activity) and the [Activity docs](/reference/react/activity). +- `hidden`: hides the children, unmounts effects, and defers all updates until React has nothing left to work on. +- `visible`: shows the children, mounts effects, and allows updates to be processed normally. + +This means you can pre-render and keep rendering hidden parts of the app without impacting the performance of anything visible on screen. + +You can use Activity to render hidden parts of the app that a user is likely to navigate to next, or to save the state of parts the user navigates away from. This helps make navigations quicker by loading data, css, and images in the background, and allows back navigations to maintain state such as input fields. + +In the future, we plan to add more modes to Activity for different use cases. + +For examples on how to use Activity, check out the [Activity docs](/reference/react/activity). --- @@ -76,16 +78,12 @@ For more information, see the [React Performance Tracks docs](/learn/react-perfo ### `useEffectEvent` {/*use-effect-event*/} -When using Effects you may want to read the most recent props or state inside an Effect without causing the Effect to re-run when those values change. +When using Effects you may want to read the most recent props or state inside an Effect without re-running the Effect when those values change. For example, in the following code the `theme` prop is used inside an Effect, but we don’t want the Effect to re-run when `theme` changes: -The typical workaround is to use a ref to store the latest `theme`, and read from that ref inside the Effect. This works, but it’s verbose and requires extra code, so in practice most users just disable the lint rule and leave the dependency out. - -Disabling the lint rule creates a refactor hazard, because the linter cannot help you if you later add a dependency that should be included. Here, `threadId` is added after the initial implementation, but the Effect does not re-run when `threadId` changes because it was not added to the dependency array: - -```js {1,3,12} -function ChatRoom({ roomId, theme, threadId }) { +```js {5,11} +function ChatRoom({ roomId, theme }) { useEffect(() => { - const connection = createConnection(serverUrl, roomId + threadId); + const connection = createConnection(serverUrl, roomId); connection.on('connected', () => { showNotification('Connected!', theme); }); @@ -93,12 +91,15 @@ function ChatRoom({ roomId, theme, threadId }) { return () => { connection.disconnect() }; - // eslint-disable-next-line react-hooks/exhaustive-deps - }, [roomId]); // 🚩 threadId is missing! + }, [roomId, theme]); // ... ``` -To solve this problem, React 19.2 introduces `useEffectEvent`, which lets you declare Effect Events that can be called inside Effects. Effect Events always access the latest values from props and state when they are invoked, so you can read the latest values without re-running the Effect. +To solve this, most users just disable the lint rule and exclude the dependency. But that can lead to bugs since the linter can no longer help you keep the dependencies up to date if you need to update the Effect later. + +React 19.2 introduces `useEffectEvent`, which lets you declare "Effect Events" that can be called inside Effects. Effect Events always access the latest values from props and state when they are invoked, so you can read the latest values without re-running the Effect: + +With `useEffectEvent`, we can define the `onConnected` callback as an "Effect Event". Now, it doesn't re-run when the values change, but it can still “see” the latest values of your props and state: ```js {2,3,4,9} function ChatRoom({ roomId, theme, threadId }) { @@ -117,6 +118,17 @@ function ChatRoom({ roomId, theme, threadId }) { // ... ``` + + +#### Please don't over use `useEffectEvent` {/*please-dont-over-use-useeffectevent*/} + +We introduced `useEffectEvent` as an experimental API several years ago, and you may be curious why it took so long to ship. We've considered multiple alternatives, but all of them have different tradeoffs that can make it too easy to accidentally out of reactivity, especially if it is overused. + +We're shipping `useEffectEvent` because it helps solve a common problem, but we recommend using it sparingly. In the future we may explore other APIs that can solve the same problem better. + + + + For more information, see [Separating Events from Effects](/learn/separating-events-from-effects) and the [`useEffectEvent` docs](/reference/react/useEffectEvent). --- @@ -154,7 +166,7 @@ For more info, see the [`cacheSignal` docs](/reference/react/cacheSignal). ### Batching Suspense Boundaries for SSR {/*batching-suspense-boundaries-for-ssr*/} -We fixed a long-standing behavior bug where Suspense boundaries would reveal differently depending on if they were rendered on the client or when streaming from server-side rendering. +We fixed a behavioral bug where Suspense boundaries would reveal differently depending on if they were rendered on the client or when streaming from server-side rendering. Starting in 19.2, React will batch reveals of server-rendered Suspense boundaries for a short time, to allow more content to be revealed together and align with the client-rendered behavior. @@ -170,7 +182,7 @@ In React 19.2, suspense boundaries are batched for a small amount of time, to al -This fix also prepares apps for supporting `` for Suspense during SSR. By revealing more content together, animations can run in larger batches of content, and avoid chaining animations of content that streams in close together. +This fix also prepares apps for supporting `` for Suspense during SSR. By revealing more content together, animations can run in larger batches of content, and avoid chaining animations of content that stream in close together. @@ -190,7 +202,14 @@ React 19.2 adds support for Web Streams for streaming SSR in Node.js: -We still highly recommend using Node Streams for streaming server-side rendering in Node environments because Node Streams are much faster than Web Streams, and Web Streams do not support compression by default, leading to users accidentally missing the benefits of streaming. +#### Prefer Node Streams for server-side rendering in Node.js {/*prefer-node-streams-for-server-side-rendering-in-nodejs*/} + +In Node.js environments, we still highly recommend using the Node Streams APIs: + +- [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) +- [`prerenderToNodeStream`](/reference/react-dom/static/prerenderToNodeStream) + +This is because Node Streams are much faster than Web Streams in Node, and Web Streams do not support compression by default, leading to users accidentally missing the benefits of streaming. @@ -218,10 +237,10 @@ Notable bug fixes - `react`: Hide/unhide the content of dehydrated suspense boundaries if they resuspend [#32900](https://github.com/facebook/react/pull/32900) - `react`: Avoid stack overflow on wide trees during Hot Reload [#34145](https://github.com/facebook/react/pull/34145) - `react`: Improve component stacks in various places [#33629](https://github.com/facebook/react/pull/33629), [#33724](https://github.com/facebook/react/pull/33724), [#32735](https://github.com/facebook/react/pull/32735), [#33723](https://github.com/facebook/react/pull/33723) -- `react`: Fix a bug with React.use inside React.lazy-ed Component (@hi-ogawa [#33941](https://github.com/facebook/react/pull/33941) -- `react-dom`: Stop warning when ARIA 1.3 attributes are used (@Abdul-Omira [#34264](https://github.com/facebook/react/pull/34264) +- `react`: Fix a bug with React.use inside React.lazy-ed Component [#33941](https://github.com/facebook/react/pull/33941) +- `react-dom`: Stop warning when ARIA 1.3 attributes are used [#34264](https://github.com/facebook/react/pull/34264) - `react-dom`: Fix a bug with deeply nested Suspense inside Suspense fallbacks [#33467](https://github.com/facebook/react/pull/33467) -- `react-dom`: Avoid hanging when suspending after aborting while rendering (@gnoff [#34192)]() +- `react-dom`: Avoid hanging when suspending after aborting while rendering [#34192](https://github.com/facebook/react/pull/34192) For a full list of changes, please see the [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md). diff --git a/src/content/learn/removing-effect-dependencies.md b/src/content/learn/removing-effect-dependencies.md index fb98a0cd148..088d1e00ab4 100644 --- a/src/content/learn/removing-effect-dependencies.md +++ b/src/content/learn/removing-effect-dependencies.md @@ -609,14 +609,6 @@ function ChatRoom({ roomId }) { ### Do you want to read a value without "reacting" to its changes? {/*do-you-want-to-read-a-value-without-reacting-to-its-changes*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - Suppose that you want to play a sound when the user receives a new message unless `isMuted` is `true`: ```js {3,10-12} diff --git a/src/content/learn/reusing-logic-with-custom-hooks.md b/src/content/learn/reusing-logic-with-custom-hooks.md index 2038e59e16c..2b166b473c6 100644 --- a/src/content/learn/reusing-logic-with-custom-hooks.md +++ b/src/content/learn/reusing-logic-with-custom-hooks.md @@ -837,14 +837,6 @@ Every time your `ChatRoom` component re-renders, it passes the latest `roomId` a ### Passing event handlers to custom Hooks {/*passing-event-handlers-to-custom-hooks*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - As you start using `useChatRoom` in more components, you might want to let components customize its behavior. For example, currently, the logic for what to do when a message arrives is hardcoded inside the Hook: ```js {9-11} diff --git a/src/content/learn/separating-events-from-effects.md b/src/content/learn/separating-events-from-effects.md index 2a19e0f13a1..b6347b1866c 100644 --- a/src/content/learn/separating-events-from-effects.md +++ b/src/content/learn/separating-events-from-effects.md @@ -400,14 +400,6 @@ You need a way to separate this non-reactive logic from the reactive Effect arou ### Declaring an Effect Event {/*declaring-an-effect-event*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - Use a special Hook called [`useEffectEvent`](/reference/react/useEffectEvent) to extract this non-reactive logic out of your Effect: ```js {1,4-6} @@ -580,14 +572,6 @@ You can think of Effect Events as being very similar to event handlers. The main ### Reading latest props and state with Effect Events {/*reading-latest-props-and-state-with-effect-events*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - Effect Events let you fix many patterns where you might be tempted to suppress the dependency linter. For example, say you have an Effect to log the page visits: @@ -882,14 +866,6 @@ Read [Removing Effect Dependencies](/learn/removing-effect-dependencies) for oth ### Limitations of Effect Events {/*limitations-of-effect-events*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - Effect Events are very limited in how you can use them: * **Only call them from inside Effects.** diff --git a/src/content/reference/react/Activity.md b/src/content/reference/react/Activity.md index c7d513afc32..dad6587b3eb 100644 --- a/src/content/reference/react/Activity.md +++ b/src/content/reference/react/Activity.md @@ -1,16 +1,7 @@ --- title: -version: canary --- - - -**The `` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `` lets you hide and restore the UI and internal state of its children. @@ -215,7 +206,7 @@ and check out the new behavior: ```js src/App.js active -import { unstable_Activity as Activity, useState } from 'react'; +import { Activity, useState } from 'react'; import Sidebar from './Sidebar.js'; export default function App() { @@ -434,7 +425,7 @@ If we switch to using an Activity boundary to show and hide the active tab, we c ```js src/App.js active -import { useState, unstable_Activity as Activity } from 'react'; +import { useState, Activity } from 'react'; import TabButton from './TabButton.js'; import Home from './Home.js'; import Contact from './Contact.js'; @@ -712,7 +703,7 @@ Try clicking the Posts tab now: ```js src/App.js -import { useState, Suspense, unstable_Activity as Activity } from 'react'; +import { useState, Suspense, Activity } from 'react'; import TabButton from './TabButton.js'; import Home from './Home.js'; import Posts from './Posts.js'; @@ -1136,7 +1127,7 @@ Let's update `App` to hide the inactive tab with a hidden Activity boundary inst ```js src/App.js active -import { useState, unstable_Activity as Activity } from 'react'; +import { useState, Activity } from 'react'; import TabButton from './TabButton.js'; import Home from './Home.js'; import Video from './Video.js'; @@ -1270,7 +1261,7 @@ Let's see the new behavior. Try playing the video, switching to the Home tab, th ```js src/App.js active -import { useState, unstable_Activity as Activity } from 'react'; +import { useState, Activity } from 'react'; import TabButton from './TabButton.js'; import Home from './Home.js'; import Video from './Video.js'; diff --git a/src/content/reference/react/useEffect.md b/src/content/reference/react/useEffect.md index 7ead26dffbd..413e3ebc46e 100644 --- a/src/content/reference/react/useEffect.md +++ b/src/content/reference/react/useEffect.md @@ -1691,14 +1691,6 @@ Now that you define the `createOptions` function inside the Effect, the Effect i ### Reading the latest props and state from an Effect {/*reading-the-latest-props-and-state-from-an-effect*/} - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - By default, when you read a reactive value from an Effect, you have to add it as a dependency. This ensures that your Effect "reacts" to every change of that value. For most dependencies, that's the behavior you want. **However, sometimes you'll want to read the *latest* props and state from an Effect without "reacting" to them.** For example, imagine you want to log the number of the items in the shopping cart for every page visit: @@ -1712,7 +1704,7 @@ function Page({ url, shoppingCart }) { } ``` - **What if you want to log a new page visit after every `url` change, but *not* if only the `shoppingCart` changes?** You can't exclude `shoppingCart` from dependencies without breaking the [reactivity rules.](#specifying-reactive-dependencies) However, you can express that you *don't want* a piece of code to "react" to changes even though it is called from inside an Effect. [Declare an *Effect Event*](/learn/separating-events-from-effects#declaring-an-effect-event) with the [`useEffectEvent`](/reference/react/useEffectEvent) Hook, and move the code reading `shoppingCart` inside of it: +**What if you want to log a new page visit after every `url` change, but *not* if only the `shoppingCart` changes?** You can't exclude `shoppingCart` from dependencies without breaking the [reactivity rules.](#specifying-reactive-dependencies) However, you can express that you *don't want* a piece of code to "react" to changes even though it is called from inside an Effect. [Declare an *Effect Event*](/learn/separating-events-from-effects#declaring-an-effect-event) with the [`useEffectEvent`](/reference/react/useEffectEvent) Hook, and move the code reading `shoppingCart` inside of it: ```js {2-4,7,8} function Page({ url, shoppingCart }) { diff --git a/src/content/reference/react/useEffectEvent.md b/src/content/reference/react/useEffectEvent.md index 8792f7ffb4a..a84ffeed5aa 100644 --- a/src/content/reference/react/useEffectEvent.md +++ b/src/content/reference/react/useEffectEvent.md @@ -1,17 +1,7 @@ --- title: useEffectEvent -version: canary --- - - - -**The `useEffectEvent` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `useEffectEvent` is a React Hook that lets you extract non-reactive logic from your Effects into a reusable function called an [Effect Event](/learn/separating-events-from-effects#declaring-an-effect-event). diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 8ce57f79379..521226a6b65 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -41,7 +41,6 @@ { "title": "useEffectEvent", "path": "/reference/react/useEffectEvent", - "version": "canary" }, { "title": "useId", @@ -112,7 +111,6 @@ { "title": "", "path": "/reference/react/Activity", - "version": "canary" }, { "title": "", From 5d368852c8936754ab014271586a72e2eb71ebfa Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:17:49 -0400 Subject: [PATCH 03/30] tweak --- src/content/blog/2025/09/30/react-19-2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/09/30/react-19-2.md index e24742cf78d..9bc7081f0b8 100644 --- a/src/content/blog/2025/09/30/react-19-2.md +++ b/src/content/blog/2025/09/30/react-19-2.md @@ -122,9 +122,9 @@ function ChatRoom({ roomId, theme, threadId }) { #### Please don't over use `useEffectEvent` {/*please-dont-over-use-useeffectevent*/} -We introduced `useEffectEvent` as an experimental API several years ago, and you may be curious why it took so long to ship. We've considered multiple alternatives, but all of them have different tradeoffs that can make it too easy to accidentally out of reactivity, especially if it is overused. +We introduced `useEffectEvent` as an experimental API several years ago, and you may be curious why it took so long to ship. We've considered multiple alternatives, but all of them have different tradeoffs that can make it too easy to accidentally opt out of reactivity, especially if it is overused. -We're shipping `useEffectEvent` because it helps solve a common problem, but we recommend using it sparingly. In the future we may explore other APIs that can solve the same problem better. +We're shipping `useEffectEvent` because it helps solve a common problem, but we recommend using it sparingly. In the future we'll continue to explore solutions to improve the reactive model more broadly. From d9cd3a127cd0e70aa5ebe1dcee868307b07b07bc Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:19:15 -0400 Subject: [PATCH 04/30] fix json --- src/sidebarReference.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 521226a6b65..22e8dbfbd07 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -40,7 +40,7 @@ }, { "title": "useEffectEvent", - "path": "/reference/react/useEffectEvent", + "path": "/reference/react/useEffectEvent" }, { "title": "useId", @@ -110,7 +110,7 @@ }, { "title": "", - "path": "/reference/react/Activity", + "path": "/reference/react/Activity" }, { "title": "", From 744e0074b7c97a3aabf88f526e479015124bfa4d Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:24:42 -0400 Subject: [PATCH 05/30] more canary stuff --- src/content/blog/2025/09/30/react-19-2.md | 2 +- .../react-performance-tracks.md | 11 +---------- src/sidebarReference.json | 4 ++-- 3 files changed, 4 insertions(+), 13 deletions(-) rename src/content/reference/{developer-tooling => dev-tools}/react-performance-tracks.md (96%) diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/09/30/react-19-2.md index 9bc7081f0b8..0ad158c6fb9 100644 --- a/src/content/blog/2025/09/30/react-19-2.md +++ b/src/content/blog/2025/09/30/react-19-2.md @@ -72,7 +72,7 @@ React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/d
-For more information, see the [React Performance Tracks docs](/learn/react-performance-tracks). +For more information, see the [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks). --- diff --git a/src/content/reference/developer-tooling/react-performance-tracks.md b/src/content/reference/dev-tools/react-performance-tracks.md similarity index 96% rename from src/content/reference/developer-tooling/react-performance-tracks.md rename to src/content/reference/dev-tools/react-performance-tracks.md index e663f1471a5..4f613f802f3 100644 --- a/src/content/reference/developer-tooling/react-performance-tracks.md +++ b/src/content/reference/dev-tools/react-performance-tracks.md @@ -1,16 +1,7 @@ --- title: React Performance tracks -version: canary --- - - -**This feature is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - React Performance tracks are specialized custom entries that appear on the Performance panel's timeline in your browser developer tools. @@ -67,7 +58,7 @@ The Scheduler is an internal React concept used for managing tasks with differen Every render pass consists of multiple phases that you can see on a timeline: - **Update** - this is what caused a new render pass. -- **Render** - React renders the updated subtree by calling render functions of components. You can see the rendered components subtree on [Components track](/reference/developer-tooling/react-performance-tracks#components), which follows the same color scheme. +- **Render** - React renders the updated subtree by calling render functions of components. You can see the rendered components subtree on [Components track](#components), which follows the same color scheme. - **Commit** - After rendering components, React will submit the changes to the DOM and run layout effects, like [`useLayoutEffect`](/reference/react/useLayoutEffect). - **Remaining Effects** - React runs passive effects of a rendered subtree. This usually happens after the paint, and this is when React runs hooks like [`useEffect`](/reference/react/useEffect). One known exception is user interactions, like clicks, or other discrete events. In this scenario, this phase could run before the paint. diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 22e8dbfbd07..0e6ef1d8d85 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -403,11 +403,11 @@ }, { "hasSectionHeader": true, - "sectionHeader": "Developer tooling" + "sectionHeader": "React DevTools" }, { "title": "React Performance tracks", - "path": "/reference/developer-tooling/react-performance-tracks" + "path": "/reference/dev-tools/react-performance-tracks" }, { "hasSectionHeader": true, From 4190232e53653f31049bf4f2ad620e41bf6fb9fe Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:28:55 -0400 Subject: [PATCH 06/30] fix link --- src/content/blog/2025/09/30/react-19-2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/09/30/react-19-2.md index 0ad158c6fb9..98a0c0d70b2 100644 --- a/src/content/blog/2025/09/30/react-19-2.md +++ b/src/content/blog/2025/09/30/react-19-2.md @@ -52,7 +52,7 @@ You can use Activity to render hidden parts of the app that a user is likely to In the future, we plan to add more modes to Activity for different use cases. -For examples on how to use Activity, check out the [Activity docs](/reference/react/activity). +For examples on how to use Activity, check out the [Activity docs](/reference/react/Activity). --- @@ -247,4 +247,4 @@ For a full list of changes, please see the [Changelog](https://github.com/facebo --- -_Thanks to everyone who helped review this post._ +_Thanks to [Ricky Hanlon](https://bsky.app/profile/ricky.fm) for [writing this post](https://www.youtube.com/shorts/T9X3YkgZRG0), [Dan Abramov](https://bsky.app/profile/danabra.mov), [Matt Carroll](https://twitter.com/mattcarrollcode), [Jack Pope](https://jackpope.me), and [Joe Savona](https://x.com/en_JS) for reviewing this post._ From 47df5a6d9700c569954cb13ca88c47b1464c1a75 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:33:25 -0400 Subject: [PATCH 07/30] update dates --- src/content/blog/2025/{09/30 => 10/01}/react-19-2.md | 8 +++----- src/content/blog/index.md | 4 ++-- 2 files changed, 5 insertions(+), 7 deletions(-) rename src/content/blog/2025/{09/30 => 10/01}/react-19-2.md (97%) diff --git a/src/content/blog/2025/09/30/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md similarity index 97% rename from src/content/blog/2025/09/30/react-19-2.md rename to src/content/blog/2025/10/01/react-19-2.md index 98a0c0d70b2..d08745177c5 100644 --- a/src/content/blog/2025/09/30/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -1,11 +1,11 @@ --- title: "React 19.2" author: The React Team -date: 2025/09/30 -description: This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience. +date: 2025/10/01 +description: React 19.2 is our third release in the last year and adds new features like Activity, React Performance Tracks, useEffectEvent, and more. --- -September 30, 2025 by [The React Team](/community/team) +October 1, 2025 by [The React Team](/community/team) --- @@ -19,8 +19,6 @@ This is our third release in the last year, following React 19 in December and R - - --- ## New Features {/*new-features*/} diff --git a/src/content/blog/index.md b/src/content/blog/index.md index 557c5f09123..42eaa4a706b 100644 --- a/src/content/blog/index.md +++ b/src/content/blog/index.md @@ -12,9 +12,9 @@ You can also follow the [@react.dev](https://bsky.app/profile/react.dev) account
- + -This release continues to build on the scheduling capabilities of concurrent rendering with Activity, adds performance tracks to help optimize your code for concurrent rendering, and new APIs to improve the developer experience ... +React 19.2 is our third release in the last year and adds new features like Activity, React Performance Tracks, useEffectEvent, and more. From 4511b55a97c1f9c9e70c6ae11a53410786b119a9 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 10:36:03 -0400 Subject: [PATCH 08/30] update meta description --- src/content/blog/2025/10/01/react-19-2.md | 2 +- src/content/blog/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index d08745177c5..51d9aefb8a5 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -2,7 +2,7 @@ title: "React 19.2" author: The React Team date: 2025/10/01 -description: React 19.2 is our third release in the last year and adds new features like Activity, React Performance Tracks, useEffectEvent, and more. +description: React 19.2 adds new features like Activity, React Performance Tracks, useEffectEvent, and more. --- October 1, 2025 by [The React Team](/community/team) diff --git a/src/content/blog/index.md b/src/content/blog/index.md index 42eaa4a706b..0477bb0ccff 100644 --- a/src/content/blog/index.md +++ b/src/content/blog/index.md @@ -14,7 +14,7 @@ You can also follow the [@react.dev](https://bsky.app/profile/react.dev) account -React 19.2 is our third release in the last year and adds new features like Activity, React Performance Tracks, useEffectEvent, and more. +React 19.2 adds new features like Activity, React Performance Tracks, useEffectEvent, and more. In this post ... From 416bab3834a6fe0d307b7286f77214428bfb47b5 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 11:36:15 -0400 Subject: [PATCH 09/30] Expand performance track section --- src/content/blog/2025/10/01/react-19-2.md | 67 ++++++++++++++++++++++- 1 file changed, 66 insertions(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 51d9aefb8a5..305618674e5 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -56,8 +56,9 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re ### React Performance Tracks {/*react-performance-tracks*/} +React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app. -React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app: +#### Scheduler ⚛ {/*scheduler-*/}
@@ -70,6 +71,70 @@ React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/d
+The Scheduler track shows what React is working on for different priorities: + +- **Blocking** - synchronous updates such as user interactions. +- **Transition** - non-blocking updates such as Actions, or useDeferredValue. +- **Suspense** - non-blocking updates rendering of Suspense content. +- **Idle** - non-blocking updates such as children hidden by Activity. + +Inside each track, you will see the type of work being performed such as: + +- **Event** - the event that triggered an update. +- **Update** - this is what scheduled an update. +- **Render** - rendering components (visible in the [Components track](#components-track)). +- **Commit** - committing the changes to the UI, and running effects during commit such as useLayoutEffect. +- **Remaining Effects** - running effects after commit, such as useEffect. + +You'll also see states of work, such as: +- **Update Blocked** - when an update is waiting for a different priority of work. +- **Waiting for Paint** - when React yields for paint before continuing work such as running effects. + +See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs for a full list. + +#### Components ⚛ {/*components-*/} + +
+ Components track: render durations + Components track: render durations +
+ +The Components track shows the tree of components that React is working on either to render or run effects. + +You'll see labels such as: +- **Mount** - When the children mount or effects are mounted. +- **Unmount** - When the children unmount or effects are unmounted. +- **Reconnect** - Similar to Mount, but for ``. +- **Disconnect** - Similar to Unmount, but for ``. +- **Blocked** - When rendering is blocked due to yielding to work outside React. + +Each entry represents the duration of the corresponding component render and all its descendant children components. For each component, the color of the bar indicates how long the component itself took: +- **0-0.5ms**: light +- **0.5-10ms**: darker +- **10ms-100ms**: darkest +- **> 100ms**: red + +See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for a full list. + +## Finding performance issues {/*finding-performance-issues*/} + +Finally, the performance tracks include information to help identify performance pitfalls. For example, setting state in an Effect creates a "Cascading update", which is a common patterns for performance regressions. + +React flags cascading renders in the performance tracks and marks them with a red Cascading Update label: + +
+ Scheduler track: cascading updates + Scheduler track: cascading updates +
+ + + +In development builds, you can select the "Cascading Update" to view the source of the update in the "Summary" panel below. + + + +These performance tracks are just a start. We will continue to expand on the performance tracks to provide more information and insights about your app. + For more information, see the [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks). --- From 7de6bb0d0ae6e19b295d92f168c8ed0bcc4a79ba Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 11:39:30 -0400 Subject: [PATCH 10/30] adjust linter note --- src/content/learn/separating-events-from-effects.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/learn/separating-events-from-effects.md b/src/content/learn/separating-events-from-effects.md index b6347b1866c..d7110222a38 100644 --- a/src/content/learn/separating-events-from-effects.md +++ b/src/content/learn/separating-events-from-effects.md @@ -713,7 +713,7 @@ function Page({ url }) { } ``` -After `useEffectEvent` becomes a stable part of React, we recommend **never suppressing the linter**. +We recommend **never suppressing the linter**. The first downside of suppressing the rule is that React will no longer warn you when your Effect needs to "react" to a new reactive dependency you've introduced to your code. In the earlier example, you added `url` to the dependencies *because* React reminded you to do it. You will no longer get such reminders for any future edits to that Effect if you disable the linter. This leads to bugs. From 1802bcabb0d707ff441893a43170da03f6fb15c4 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 11:58:18 -0400 Subject: [PATCH 11/30] edit perf tracks down --- src/content/blog/2025/10/01/react-19-2.md | 44 ++++------------------- 1 file changed, 6 insertions(+), 38 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 305618674e5..5b118ad7534 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -54,7 +54,7 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re --- -### React Performance Tracks {/*react-performance-tracks*/} +### Performance Tracks {/*performance-tracks*/} React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app. @@ -71,24 +71,9 @@ React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/d
-The Scheduler track shows what React is working on for different priorities: +The Scheduler track shows what React is working on for different priorities such as "blocking" for user interactions, or "transition" for updates inside startTransition. Inside each track, you will see the type of work being performed such as the event that scheduled an update, and when the render for that update happened. -- **Blocking** - synchronous updates such as user interactions. -- **Transition** - non-blocking updates such as Actions, or useDeferredValue. -- **Suspense** - non-blocking updates rendering of Suspense content. -- **Idle** - non-blocking updates such as children hidden by Activity. - -Inside each track, you will see the type of work being performed such as: - -- **Event** - the event that triggered an update. -- **Update** - this is what scheduled an update. -- **Render** - rendering components (visible in the [Components track](#components-track)). -- **Commit** - committing the changes to the UI, and running effects during commit such as useLayoutEffect. -- **Remaining Effects** - running effects after commit, such as useEffect. - -You'll also see states of work, such as: -- **Update Blocked** - when an update is waiting for a different priority of work. -- **Waiting for Paint** - when React yields for paint before continuing work such as running effects. +We also show information such as when an update is blocked waiting for a different priority, or when React is waiting for paint before continuing. The Scheduler track helps you understand how React splits your code into different priorities, and the order it completed the work. See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs for a full list. @@ -99,24 +84,13 @@ See the [Scheduler track](/reference/dev-tools/react-performance-tracks#schedule Components track: render durations -The Components track shows the tree of components that React is working on either to render or run effects. +The Components track shows the tree of components that React is working on either to render or run effects. Inside you'll see labels such as "Mount" for when children mount or effects are mounted, or "Blocked" for when rendering is blocked due to yielding to work outside React. -You'll see labels such as: -- **Mount** - When the children mount or effects are mounted. -- **Unmount** - When the children unmount or effects are unmounted. -- **Reconnect** - Similar to Mount, but for ``. -- **Disconnect** - Similar to Unmount, but for ``. -- **Blocked** - When rendering is blocked due to yielding to work outside React. - -Each entry represents the duration of the corresponding component render and all its descendant children components. For each component, the color of the bar indicates how long the component itself took: -- **0-0.5ms**: light -- **0.5-10ms**: darker -- **10ms-100ms**: darkest -- **> 100ms**: red +The Component track helps you understand when components are rendered or run effects, and the time it takes to complete that work to help identify performance problems. See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for a full list. -## Finding performance issues {/*finding-performance-issues*/} +#### Finding performance issues {/*finding-performance-issues*/} Finally, the performance tracks include information to help identify performance pitfalls. For example, setting state in an Effect creates a "Cascading update", which is a common patterns for performance regressions. @@ -127,12 +101,6 @@ React flags cascading renders in the performance tracks and marks them with a re Scheduler track: cascading updates - - -In development builds, you can select the "Cascading Update" to view the source of the update in the "Summary" panel below. - - - These performance tracks are just a start. We will continue to expand on the performance tracks to provide more information and insights about your app. For more information, see the [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks). From 4ff7e2d03fc89618eebcd05a57748f66325f8369 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 12:06:29 -0400 Subject: [PATCH 12/30] edit perf tracks down more --- src/content/blog/2025/10/01/react-19-2.md | 32 +++++------------------ 1 file changed, 7 insertions(+), 25 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 5b118ad7534..5d30e77f85f 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -56,9 +56,7 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re ### Performance Tracks {/*performance-tracks*/} -React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app. - -#### Scheduler ⚛ {/*scheduler-*/} +React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app:
@@ -71,39 +69,23 @@ React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/d
+The [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks) explain everything included in the tracks, but here is a high-level overview. + +#### Scheduler ⚛ {/*scheduler-*/} + The Scheduler track shows what React is working on for different priorities such as "blocking" for user interactions, or "transition" for updates inside startTransition. Inside each track, you will see the type of work being performed such as the event that scheduled an update, and when the render for that update happened. We also show information such as when an update is blocked waiting for a different priority, or when React is waiting for paint before continuing. The Scheduler track helps you understand how React splits your code into different priorities, and the order it completed the work. -See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs for a full list. +See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs to see everything included. #### Components ⚛ {/*components-*/} -
- Components track: render durations - Components track: render durations -
- The Components track shows the tree of components that React is working on either to render or run effects. Inside you'll see labels such as "Mount" for when children mount or effects are mounted, or "Blocked" for when rendering is blocked due to yielding to work outside React. The Component track helps you understand when components are rendered or run effects, and the time it takes to complete that work to help identify performance problems. -See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for a full list. - -#### Finding performance issues {/*finding-performance-issues*/} - -Finally, the performance tracks include information to help identify performance pitfalls. For example, setting state in an Effect creates a "Cascading update", which is a common patterns for performance regressions. - -React flags cascading renders in the performance tracks and marks them with a red Cascading Update label: - -
- Scheduler track: cascading updates - Scheduler track: cascading updates -
- -These performance tracks are just a start. We will continue to expand on the performance tracks to provide more information and insights about your app. - -For more information, see the [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks). +See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for see everything included. --- From 48e729e58f9a0a0dce7f4eecc70eb851177f77f6 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 12:12:47 -0400 Subject: [PATCH 13/30] tweak note --- src/content/blog/2025/10/01/react-19-2.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 5d30e77f85f..a2eaae705e2 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -133,11 +133,9 @@ function ChatRoom({ roomId, theme, threadId }) { -#### Please don't over use `useEffectEvent` {/*please-dont-over-use-useeffectevent*/} +#### When to use `useEffectEvent` {/*when-to-use-useeffectevent*/} -We introduced `useEffectEvent` as an experimental API several years ago, and you may be curious why it took so long to ship. We've considered multiple alternatives, but all of them have different tradeoffs that can make it too easy to accidentally opt out of reactivity, especially if it is overused. - -We're shipping `useEffectEvent` because it helps solve a common problem, but we recommend using it sparingly. In the future we'll continue to explore solutions to improve the reactive model more broadly. +You should use `useEffectEvent` for functions that are conceptually "events" that happen to be fired from an Effect instead of a user event (that's what makes it an "Effect Event"). You don't need to wrap everything in `useEffectEvent`, or to use it just to silence the lint error, as this can lead to bugs. @@ -146,6 +144,10 @@ For more information, see [Separating Events from Effects](/learn/separating-eve --- +### Partial Pre-render Support {/*partial-prerender-support*/} + +--- + ### `cacheSignal` {/*cache-signal*/} From 1b5abe025366a5e48865339c9cd29bc9bc9b00e8 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 12:18:48 -0400 Subject: [PATCH 14/30] tweak useEffectEvent --- src/content/blog/2025/10/01/react-19-2.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index a2eaae705e2..61cef75c451 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -91,7 +91,7 @@ See the [Component track docs](/reference/dev-tools/react-performance-tracks#com ### `useEffectEvent` {/*use-effect-event*/} -When using Effects you may want to read the most recent props or state inside an Effect without re-running the Effect when those values change. For example, in the following code the `theme` prop is used inside an Effect, but we don’t want the Effect to re-run when `theme` changes: +One common pattern with useEffect is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: ```js {5,11} function ChatRoom({ roomId, theme }) { @@ -108,29 +108,31 @@ function ChatRoom({ roomId, theme }) { // ... ``` -To solve this, most users just disable the lint rule and exclude the dependency. But that can lead to bugs since the linter can no longer help you keep the dependencies up to date if you need to update the Effect later. +The problem with the code above is that any values used inside such an "event" will cause the surrounding Effect to re-run when they change. For example, changing the theme will cause the chat room to reconnect. This behavior makes sense for values that are related to the Effect logic itself, like roomId, but it doesn't make sense for theme. -React 19.2 introduces `useEffectEvent`, which lets you declare "Effect Events" that can be called inside Effects. Effect Events always access the latest values from props and state when they are invoked, so you can read the latest values without re-running the Effect: +To solve this, most users just disable the lint rule and exclude the dependency. But that can lead to bugs since the linter can no longer help you keep the dependencies up to date if you need to update the Effect later. -With `useEffectEvent`, we can define the `onConnected` callback as an "Effect Event". Now, it doesn't re-run when the values change, but it can still “see” the latest values of your props and state: +With `useEffectEvent`, you can split the "event" part of this logic out of the Effect that emits it: ```js {2,3,4,9} -function ChatRoom({ roomId, theme, threadId }) { +function ChatRoom({ roomId, theme }) { const onConnected = useEffectEvent(() => { showNotification('Connected!', theme); }); useEffect(() => { - const connection = createConnection(serverUrl, roomId, threadId); + const connection = createConnection(serverUrl, roomId); connection.on('connected', () => { onConnected(); }); connection.connect(); return () => connection.disconnect(); - }, [roomId, threadId]); // ✅ All dependencies declared + }, [roomId]); // ✅ All dependencies declared // ... ``` +Similar to DOM events, Effect Events always "see" the latest props and state. They should not be declared in the dependency array. They can only be declared in the same component or Hook, which is verified by the linter. + #### When to use `useEffectEvent` {/*when-to-use-useeffectevent*/} From 15cb93f836a246c95a859333c8492c9215829750 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 12:22:49 -0400 Subject: [PATCH 15/30] formatting --- src/content/blog/2025/10/01/react-19-2.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 61cef75c451..33199d5c224 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -91,7 +91,7 @@ See the [Component track docs](/reference/dev-tools/react-performance-tracks#com ### `useEffectEvent` {/*use-effect-event*/} -One common pattern with useEffect is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: +One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: ```js {5,11} function ChatRoom({ roomId, theme }) { @@ -108,7 +108,7 @@ function ChatRoom({ roomId, theme }) { // ... ``` -The problem with the code above is that any values used inside such an "event" will cause the surrounding Effect to re-run when they change. For example, changing the theme will cause the chat room to reconnect. This behavior makes sense for values that are related to the Effect logic itself, like roomId, but it doesn't make sense for theme. +The problem with the code above is that any values used inside such an "event" will cause the surrounding Effect to re-run when they change. For example, changing the `theme` will cause the chat room to reconnect. This behavior makes sense for values that are related to the Effect logic itself, like `roomId`, but it doesn't make sense for `theme`. To solve this, most users just disable the lint rule and exclude the dependency. But that can lead to bugs since the linter can no longer help you keep the dependencies up to date if you need to update the Effect later. @@ -139,10 +139,9 @@ Similar to DOM events, Effect Events always "see" the latest props and state. Th You should use `useEffectEvent` for functions that are conceptually "events" that happen to be fired from an Effect instead of a user event (that's what makes it an "Effect Event"). You don't need to wrap everything in `useEffectEvent`, or to use it just to silence the lint error, as this can lead to bugs. - - +For a deep dive on how to think about Event Effects, see: [Separating Events from Effects](https://react.dev/learn/separating-events-from-effects#extracting-non-reactive-logic-out-of-effects). -For more information, see [Separating Events from Effects](/learn/separating-events-from-effects) and the [`useEffectEvent` docs](/reference/react/useEffectEvent). + --- From 08765252ca02828e2a6c9fc33620bde1b579110d Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 12:31:38 -0400 Subject: [PATCH 16/30] tweaks --- src/content/blog/2025/10/01/react-19-2.md | 91 +++++++++++++---------- 1 file changed, 52 insertions(+), 39 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 33199d5c224..6bd1c6bbbd7 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -21,7 +21,7 @@ This is our third release in the last year, following React 19 in December and R --- -## New Features {/*new-features*/} +## New React Features {/*new-react-features*/} ### `` {/*activity*/} @@ -54,41 +54,6 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re --- -### Performance Tracks {/*performance-tracks*/} - -React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app: - -
- - - - - - - - -
- -The [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks) explain everything included in the tracks, but here is a high-level overview. - -#### Scheduler ⚛ {/*scheduler-*/} - -The Scheduler track shows what React is working on for different priorities such as "blocking" for user interactions, or "transition" for updates inside startTransition. Inside each track, you will see the type of work being performed such as the event that scheduled an update, and when the render for that update happened. - -We also show information such as when an update is blocked waiting for a different priority, or when React is waiting for paint before continuing. The Scheduler track helps you understand how React splits your code into different priorities, and the order it completed the work. - -See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs to see everything included. - -#### Components ⚛ {/*components-*/} - -The Components track shows the tree of components that React is working on either to render or run effects. Inside you'll see labels such as "Mount" for when children mount or effects are mounted, or "Blocked" for when rendering is blocked due to yielding to work outside React. - -The Component track helps you understand when components are rendered or run effects, and the time it takes to complete that work to help identify performance problems. - -See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for see everything included. - ---- - ### `useEffectEvent` {/*use-effect-event*/} One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: @@ -127,11 +92,13 @@ function ChatRoom({ roomId, theme }) { }); connection.connect(); return () => connection.disconnect(); - }, [roomId]); // ✅ All dependencies declared + }, [roomId]); // ✅ All dependencies declared (Effect Events aren't dependencies) // ... ``` -Similar to DOM events, Effect Events always "see" the latest props and state. They should not be declared in the dependency array. They can only be declared in the same component or Hook, which is verified by the linter. +Similar to DOM events, Effect Events always “see” the latest props and state. + +Effect Events should _not_ be declared in the dependency array. They can only be declared in the same component or Hook as "their" Effect. These restrictions are verified by the linter. @@ -145,7 +112,53 @@ For a deep dive on how to think about Event Effects, see: [Separating Events fro --- -### Partial Pre-render Support {/*partial-prerender-support*/} +### Performance Tracks {/*performance-tracks*/} + +React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app: + +
+ + + + + + + + +
+ +The [React Performance Tracks docs](/reference/dev-tools/react-performance-tracks) explain everything included in the tracks, but here is a high-level overview. + +#### Scheduler ⚛ {/*scheduler-*/} + +The Scheduler track shows what React is working on for different priorities such as "blocking" for user interactions, or "transition" for updates inside startTransition. Inside each track, you will see the type of work being performed such as the event that scheduled an update, and when the render for that update happened. + +We also show information such as when an update is blocked waiting for a different priority, or when React is waiting for paint before continuing. The Scheduler track helps you understand how React splits your code into different priorities, and the order it completed the work. + +See the [Scheduler track](/reference/dev-tools/react-performance-tracks#scheduler) docs to see everything included. + +#### Components ⚛ {/*components-*/} + +The Components track shows the tree of components that React is working on either to render or run effects. Inside you'll see labels such as "Mount" for when children mount or effects are mounted, or "Blocked" for when rendering is blocked due to yielding to work outside React. + +The Component track helps you understand when components are rendered or run effects, and the time it takes to complete that work to help identify performance problems. + +See the [Component track docs](/reference/dev-tools/react-performance-tracks#components) for see everything included. + +--- + +## New React DOM Features {/*new-react-dom-features*/} + +### `resume` {/*resume*/} + +We're adding new APIs to support partial pre-rendering for SSR: + +- `resume` +- `resumeToPipeableStream` +- `resumeAndPrerender` +- `resumeAndPrerenderToNodeStream` + +Additionally, the prerender apis now return a `postpone` state to pass to the `resume` apis. --- From bde6ca6845402fe2201a84ef9e5f5f7c6b05e11a Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 13:05:35 -0400 Subject: [PATCH 17/30] ppr --- src/content/blog/2025/10/01/react-19-2.md | 46 ++++++++++++++++++++--- 1 file changed, 41 insertions(+), 5 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 6bd1c6bbbd7..c1550268025 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -151,12 +151,48 @@ See the [Component track docs](/reference/dev-tools/react-performance-tracks#com ### `resume` {/*resume*/} -We're adding new APIs to support partial pre-rendering for SSR: +In 19.2 we're adding a new capability to pre-render part of the app ahead of time, and resume rendering it later. -- `resume` -- `resumeToPipeableStream` -- `resumeAndPrerender` -- `resumeAndPrerenderToNodeStream` +This feature is called "Partial Pre-rendering", and allows you to pre-render the static parts of your app and serve it from a CDN, and then resume rendering the shell to fill it in with dynamic content later. + +To pre-render an app to resume later, first call `prerender` with an `AbortController`: + +``` +const {prelude, postponed} = await prerender(, { + signal: controller.signal, +}); + +// Save the postponed state for later +await savePostponedState(postponed); + +// Send prelude to client or CDN. +``` + +Then, you can return the `prelude` shell to the client, and later call `resume` to "resume" to a SSR stream: + +``` +const postponed = await getPostponedState(request); +const resumeStream = await resume(, postponed); + +// Send stream to client. +``` + +Or you can call `resumeAndPrerender` to resume to get static HTML for SSG: + +``` +const postponedState = getPostponedState(request); +const { prelude } = await resumeAndPrerender(, postponedState); + +// Send complete HTML prelude to CDN. +``` + +For more info, see the docs for the new APIs: +- `react-dom/server` + - [`resume`](/reference/react-dom/server/resume): for Web Streams. + - [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) for Node Streams. +- `react-dom/static` + - [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender) for Web Streams. + - [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) for Node Streams. Additionally, the prerender apis now return a `postpone` state to pass to the `resume` apis. From e08a6f3f542d95f294ce84c87da9f33f57e9ae3b Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 13:57:31 -0400 Subject: [PATCH 18/30] rm canary stuff --- src/content/reference/react-dom/server/resume.md | 9 --------- .../reference/react-dom/server/resumeToPipeableStream.md | 9 --------- src/content/reference/react-dom/static/prerender.md | 4 ++-- .../reference/react-dom/static/prerenderToNodeStream.md | 4 ++-- .../reference/react-dom/static/resumeAndPrerender.md | 9 --------- .../react-dom/static/resumeAndPrerenderToNodeStream.md | 9 --------- src/content/reference/react/cacheSignal.md | 8 -------- src/sidebarReference.json | 5 ----- 8 files changed, 4 insertions(+), 53 deletions(-) diff --git a/src/content/reference/react-dom/server/resume.md b/src/content/reference/react-dom/server/resume.md index 836b46c0572..eaa106f7bb1 100644 --- a/src/content/reference/react-dom/server/resume.md +++ b/src/content/reference/react-dom/server/resume.md @@ -1,16 +1,7 @@ --- title: resume -canary: true --- - - -**The `resume` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `resume` streams a pre-rendered React tree to a [Readable Web Stream.](https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream) diff --git a/src/content/reference/react-dom/server/resumeToPipeableStream.md b/src/content/reference/react-dom/server/resumeToPipeableStream.md index cf597e55994..48caa3be64e 100644 --- a/src/content/reference/react-dom/server/resumeToPipeableStream.md +++ b/src/content/reference/react-dom/server/resumeToPipeableStream.md @@ -1,16 +1,7 @@ --- title: resumeToPipeableStream -canary: true --- - - -**The `resumeToPipeableStream` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `resumeToPipeableStream` streams a pre-rendered React tree to a pipeable [Node.js Stream.](https://nodejs.org/api/stream.html) diff --git a/src/content/reference/react-dom/static/prerender.md b/src/content/reference/react-dom/static/prerender.md index c788ad841c9..f03d96f69d3 100644 --- a/src/content/reference/react-dom/static/prerender.md +++ b/src/content/reference/react-dom/static/prerender.md @@ -64,7 +64,7 @@ On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to `prerender` returns a Promise: - If rendering the is successful, the Promise will resolve to an object containing: - `prelude`: a [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) of HTML. You can use this stream to send a response in chunks, or you can read the entire stream into a string. - - `postponed` : a JSON-serializeable, opaque object that can be passed to [`resume`](/reference/react-dom/server/resume) if `prerender` did not finish. Otherwise `null` indicating that the `prelude` contains all the content and no resume is necessary. + - `postponed`: a JSON-serializeable, opaque object that can be passed to [`resume`](/reference/react-dom/server/resume) if `prerender` did not finish. Otherwise `null` indicating that the `prelude` contains all the content and no resume is necessary. - If rendering fails, the Promise will be rejected. [Use this to output a fallback shell.](/reference/react-dom/server/renderToReadableStream#recovering-from-errors-inside-the-shell) #### Caveats {/*caveats*/} @@ -313,7 +313,7 @@ async function renderToString() { Any Suspense boundaries with incomplete children will be included in the prelude in the fallback state. - This can be used for partial prerendering together with [`resume`](/reference/react-dom/server/resume) or [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender). +This can be used for partial prerendering together with [`resume`](/reference/react-dom/server/resume) or [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender). ## Troubleshooting {/*troubleshooting*/} diff --git a/src/content/reference/react-dom/static/prerenderToNodeStream.md b/src/content/reference/react-dom/static/prerenderToNodeStream.md index 411c4eb1b6a..10c0fa21bb0 100644 --- a/src/content/reference/react-dom/static/prerenderToNodeStream.md +++ b/src/content/reference/react-dom/static/prerenderToNodeStream.md @@ -65,7 +65,7 @@ On the client, call [`hydrateRoot`](/reference/react-dom/client/hydrateRoot) to `prerenderToNodeStream` returns a Promise: - If rendering the is successful, the Promise will resolve to an object containing: - `prelude`: a [Node.js Stream.](https://nodejs.org/api/stream.html) of HTML. You can use this stream to send a response in chunks, or you can read the entire stream into a string. - - `postponed` : a JSON-serializeable, opaque object that can be passed to [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) if `prerenderToNodeStream` did not finish. Otherwise `null` indicating that the `prelude` contains all the content and no resume is necessary. + - `postponed`: a JSON-serializeable, opaque object that can be passed to [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) if `prerenderToNodeStream` did not finish. Otherwise `null` indicating that the `prelude` contains all the content and no resume is necessary. - If rendering fails, the Promise will be rejected. [Use this to output a fallback shell.](/reference/react-dom/server/renderToPipeableStream#recovering-from-errors-inside-the-shell) #### Caveats {/*caveats*/} @@ -314,7 +314,7 @@ async function renderToString() { Any Suspense boundaries with incomplete children will be included in the prelude in the fallback state. - This can be used for partial prerendering together with [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) or [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream). +This can be used for partial prerendering together with [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) or [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream). ## Troubleshooting {/*troubleshooting*/} diff --git a/src/content/reference/react-dom/static/resumeAndPrerender.md b/src/content/reference/react-dom/static/resumeAndPrerender.md index 95e9474f02e..10b240dd916 100644 --- a/src/content/reference/react-dom/static/resumeAndPrerender.md +++ b/src/content/reference/react-dom/static/resumeAndPrerender.md @@ -1,16 +1,7 @@ --- title: resumeAndPrerender -version: canary --- - - -**The `resume` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `resumeAndPrerender` continues a prerendered React tree to a static HTML string using a [Web Stream](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API). diff --git a/src/content/reference/react-dom/static/resumeAndPrerenderToNodeStream.md b/src/content/reference/react-dom/static/resumeAndPrerenderToNodeStream.md index 559ad8e02ff..4ce3c473653 100644 --- a/src/content/reference/react-dom/static/resumeAndPrerenderToNodeStream.md +++ b/src/content/reference/react-dom/static/resumeAndPrerenderToNodeStream.md @@ -1,16 +1,7 @@ --- title: resumeAndPrerenderToNodeStream -version: canary --- - - -**The `resumeAndPrerenderToNodeStream` API is currently only available in React’s Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `resumeAndPrerenderToNodeStream` continues a prerendered React tree to a static HTML string using a a [Node.js Stream.](https://nodejs.org/api/stream.html). diff --git a/src/content/reference/react/cacheSignal.md b/src/content/reference/react/cacheSignal.md index 31b6a34a15b..ceeb56df8c1 100644 --- a/src/content/reference/react/cacheSignal.md +++ b/src/content/reference/react/cacheSignal.md @@ -2,14 +2,6 @@ title: cacheSignal --- - - -**The `cacheSignal()` API is currently only available in React’s Canary and Experimental channels.** - -[Learn more about React’s release channels here.](/community/versioning-policy#all-release-channels) - - - `cacheSignal` is currently only used with [React Server Components](/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#react-server-components). diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 0e6ef1d8d85..153220e0792 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -134,7 +134,6 @@ { "title": "cacheSignal", "path": "/reference/react/cacheSignal", - "version": "canary" }, { "title": "captureOwnerStack", @@ -320,12 +319,10 @@ { "title": "resume", "path": "/reference/react-dom/server/resume", - "version": "canary" }, { "title": "resumeToPipeableStream", "path": "/reference/react-dom/server/resumeToPipeableStream", - "version": "canary" } ] }, @@ -344,12 +341,10 @@ { "title": "resumeAndPrerender", "path": "/reference/react-dom/static/resumeAndPrerender", - "version": "canary" }, { "title": "resumeAndPrerenderToNodeStream", "path": "/reference/react-dom/static/resumeAndPrerenderToNodeStream", - "version": "canary" } ] }, From e37657aa0dfa8264fa552aa17fe70588d7c3fcae Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 14:17:25 -0400 Subject: [PATCH 19/30] fix json --- src/sidebarReference.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 153220e0792..2d908f7d564 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -318,11 +318,11 @@ }, { "title": "resume", - "path": "/reference/react-dom/server/resume", + "path": "/reference/react-dom/server/resume" }, { "title": "resumeToPipeableStream", - "path": "/reference/react-dom/server/resumeToPipeableStream", + "path": "/reference/react-dom/server/resumeToPipeableStream" } ] }, @@ -340,11 +340,11 @@ }, { "title": "resumeAndPrerender", - "path": "/reference/react-dom/static/resumeAndPrerender", + "path": "/reference/react-dom/static/resumeAndPrerender" }, { "title": "resumeAndPrerenderToNodeStream", - "path": "/reference/react-dom/static/resumeAndPrerenderToNodeStream", + "path": "/reference/react-dom/static/resumeAndPrerenderToNodeStream" } ] }, From 91ffb93971bdad8ee6cda6c2b651c4dfa632ee54 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 14:19:28 -0400 Subject: [PATCH 20/30] fix json --- src/sidebarReference.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/sidebarReference.json b/src/sidebarReference.json index 2d908f7d564..44f1554ecbe 100644 --- a/src/sidebarReference.json +++ b/src/sidebarReference.json @@ -133,7 +133,7 @@ }, { "title": "cacheSignal", - "path": "/reference/react/cacheSignal", + "path": "/reference/react/cacheSignal" }, { "title": "captureOwnerStack", From 7ffe3e41831f6c68f1e039f5750b5544923fd510 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 14:53:38 -0400 Subject: [PATCH 21/30] tweaks --- src/content/blog/2025/10/01/react-19-2.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index c1550268025..51a05dfb711 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -265,6 +265,11 @@ React 19.2 adds support for Web Streams for streaming SSR in Node.js: - [`renderToReadableStream`](/reference/react-dom/server/renderToReadableStream) is now available for Node.js - [`prerender`](/reference/react-dom/static/prerender) is now available for Node.js +As well as the new `resume` APIs: +- [`resume`](/reference/react-dom/server/resume): is available for Node.js. +- [`resumeAndPrerender`](/reference/react-dom/static/resumeAndPrerender) is available for Node.js. + + #### Prefer Node Streams for server-side rendering in Node.js {/*prefer-node-streams-for-server-side-rendering-in-nodejs*/} @@ -272,7 +277,9 @@ React 19.2 adds support for Web Streams for streaming SSR in Node.js: In Node.js environments, we still highly recommend using the Node Streams APIs: - [`renderToPipeableStream`](/reference/react-dom/server/renderToPipeableStream) +- [`resumeToPipeableStream`](/reference/react-dom/server/resumeToPipeableStream) - [`prerenderToNodeStream`](/reference/react-dom/static/prerenderToNodeStream) +- [`resumeAndPrerenderToNodeStream`](/reference/react-dom/static/resumeAndPrerenderToNodeStream) This is because Node Streams are much faster than Web Streams in Node, and Web Streams do not support compression by default, leading to users accidentally missing the benefits of streaming. From 83a84a074726c68fbc06680adb66ff1f4f777a3a Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 14:59:33 -0400 Subject: [PATCH 22/30] linter note --- src/content/blog/2025/10/01/react-19-2.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 51a05dfb711..072cd45289f 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -56,6 +56,8 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re ### `useEffectEvent` {/*use-effect-event*/} +_Note: Please upgrade to `eslint-plugin-react-hooks@6.1.0` when using `useEffectEvent`._ + One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: ```js {5,11} From d357bfae728dd22fac159059b21aa7c1c5f8e2d5 Mon Sep 17 00:00:00 2001 From: Dan Abramov Date: Wed, 1 Oct 2025 20:30:20 +0100 Subject: [PATCH 23/30] nit --- src/content/blog/2025/10/01/react-19-2.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 072cd45289f..e9c26ab3809 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -41,10 +41,10 @@ You can use Activity as an alternative to conditionally rendering parts of your In React 19.2, Activity supports two modes: `visible` and `hidden`. -- `hidden`: hides the children, unmounts effects, and defers all updates until React has nothing left to work on. +- `hidden`: hides the children, unmounts effects, and defers all updates until React has nothing left to work on. - `visible`: shows the children, mounts effects, and allows updates to be processed normally. -This means you can pre-render and keep rendering hidden parts of the app without impacting the performance of anything visible on screen. +This means you can pre-render and keep rendering hidden parts of the app without impacting the performance of anything visible on screen. You can use Activity to render hidden parts of the app that a user is likely to navigate to next, or to save the state of parts the user navigates away from. This helps make navigations quicker by loading data, css, and images in the background, and allows back navigations to maintain state such as input fields. @@ -56,9 +56,7 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re ### `useEffectEvent` {/*use-effect-event*/} -_Note: Please upgrade to `eslint-plugin-react-hooks@6.1.0` when using `useEffectEvent`._ - -One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, a chat room may get connected, and you might want to display a notification when that happens: +One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, when a chat room gets connected, and you might want to display a notification: ```js {5,11} function ChatRoom({ roomId, theme }) { @@ -75,7 +73,7 @@ function ChatRoom({ roomId, theme }) { // ... ``` -The problem with the code above is that any values used inside such an "event" will cause the surrounding Effect to re-run when they change. For example, changing the `theme` will cause the chat room to reconnect. This behavior makes sense for values that are related to the Effect logic itself, like `roomId`, but it doesn't make sense for `theme`. +The problem with the code above is that a change to any values used inside such an "event" will cause the surrounding Effect to re-run. For example, changing the `theme` will cause the chat room to reconnect. This makes sense for values related to the Effect logic itself, like `roomId`, but it doesn't make sense for `theme`. To solve this, most users just disable the lint rule and exclude the dependency. But that can lead to bugs since the linter can no longer help you keep the dependencies up to date if you need to update the Effect later. @@ -100,7 +98,7 @@ function ChatRoom({ roomId, theme }) { Similar to DOM events, Effect Events always “see” the latest props and state. -Effect Events should _not_ be declared in the dependency array. They can only be declared in the same component or Hook as "their" Effect. These restrictions are verified by the linter. +**Effect Events should _not_ be declared in the dependency array**. You'll need to upgrade to `eslint-plugin-react-hooks@6.1.0` so that the linter doesn't try to insert them as dependencies. Note that Effect Events can only be declared in the same component or Hook as "their" Effect. These restrictions are verified by the linter. @@ -153,7 +151,7 @@ See the [Component track docs](/reference/dev-tools/react-performance-tracks#com ### `resume` {/*resume*/} -In 19.2 we're adding a new capability to pre-render part of the app ahead of time, and resume rendering it later. +In 19.2 we're adding a new capability to pre-render part of the app ahead of time, and resume rendering it later. This feature is called "Partial Pre-rendering", and allows you to pre-render the static parts of your app and serve it from a CDN, and then resume rendering the shell to fill it in with dynamic content later. @@ -233,7 +231,7 @@ For more info, see the [`cacheSignal` docs](/reference/react/cacheSignal). ### Batching Suspense Boundaries for SSR {/*batching-suspense-boundaries-for-ssr*/} -We fixed a behavioral bug where Suspense boundaries would reveal differently depending on if they were rendered on the client or when streaming from server-side rendering. +We fixed a behavioral bug where Suspense boundaries would reveal differently depending on if they were rendered on the client or when streaming from server-side rendering. Starting in 19.2, React will batch reveals of server-rendered Suspense boundaries for a short time, to allow more content to be revealed together and align with the client-rendered behavior. @@ -255,7 +253,7 @@ This fix also prepares apps for supporting `` for Suspense durin React uses heuristics to ensure throttling does not impact core web vitals and search ranking. -For example, if the total page load time is approaching 2.5s (which is the time considered "good" for [LCP](https://web.dev/articles/lcp)), React will stop batching and reveal content immediately so that the throttling is not the reason to miss the metric. +For example, if the total page load time is approaching 2.5s (which is the time considered "good" for [LCP](https://web.dev/articles/lcp)), React will stop batching and reveal content immediately so that the throttling is not the reason to miss the metric. From d05a2e956e1ce576440e4a696025e8db3b4c8f14 Mon Sep 17 00:00:00 2001 From: Dan Abramov Date: Wed, 1 Oct 2025 20:31:48 +0100 Subject: [PATCH 24/30] nit --- src/content/blog/2025/10/01/react-19-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index e9c26ab3809..a50e943e890 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -56,7 +56,7 @@ For examples on how to use Activity, check out the [Activity docs](/reference/re ### `useEffectEvent` {/*use-effect-event*/} -One common pattern with `useEffect` is to notify the app code about some kind of "events" in an external system. For example, when a chat room gets connected, and you might want to display a notification: +One common pattern with `useEffect` is to notify the app code about some kind of "events" from an external system. For example, when a chat room gets connected, you might want to display a notification: ```js {5,11} function ChatRoom({ roomId, theme }) { From ac8e311c6db99861e858a23b993f8517be4ea253 Mon Sep 17 00:00:00 2001 From: Dan Abramov Date: Wed, 1 Oct 2025 20:34:29 +0100 Subject: [PATCH 25/30] link --- src/content/blog/2025/10/01/react-19-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index a50e943e890..301620fc9fe 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -106,7 +106,7 @@ Similar to DOM events, Effect Events always “see” the latest props and state You should use `useEffectEvent` for functions that are conceptually "events" that happen to be fired from an Effect instead of a user event (that's what makes it an "Effect Event"). You don't need to wrap everything in `useEffectEvent`, or to use it just to silence the lint error, as this can lead to bugs. -For a deep dive on how to think about Event Effects, see: [Separating Events from Effects](https://react.dev/learn/separating-events-from-effects#extracting-non-reactive-logic-out-of-effects). +For a deep dive on how to think about Event Effects, see: [Separating Events from Effects](/learn/separating-events-from-effects#extracting-non-reactive-logic-out-of-effects). From 2e07386ef7e6f806742538d52c1e001e491dec24 Mon Sep 17 00:00:00 2001 From: Dan Abramov Date: Wed, 1 Oct 2025 20:37:59 +0100 Subject: [PATCH 26/30] nit --- src/content/blog/2025/10/01/react-19-2.md | 58 +++++++++++----------- src/content/reference/react/cacheSignal.md | 8 +-- 2 files changed, 33 insertions(+), 33 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 301620fc9fe..8a05284ae5e 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -112,6 +112,35 @@ For a deep dive on how to think about Event Effects, see: [Separating Events fro --- +### `cacheSignal` {/*cache-signal*/} + + + +`cacheSignal` is only for use with [React Server Components](/reference/rsc/server-components). + + + +`cacheSignal` allows you to know when the [`cache()`](/reference/react/cache) lifetime is over: + +``` +import {cache, cacheSignal} from 'react'; +const dedupedFetch = cache(fetch); + +async function Component() { + await dedupedFetch(url, { signal: cacheSignal() }); +} +``` + +This allows you to clean up or abort work when the result will no longer be used in the cache, such as: + +- React has successfully completed rendering +- The render was aborted +- The render has failed + +For more info, see the [`cacheSignal` docs](/reference/react/cacheSignal). + +--- + ### Performance Tracks {/*performance-tracks*/} React 19.2 adds a new set of [custom tracks](https://developer.chrome.com/docs/devtools/performance/extension) to Chrome DevTools performance profiles to provide more information about the performance of your React app: @@ -198,35 +227,6 @@ Additionally, the prerender apis now return a `postpone` state to pass to the `r --- -### `cacheSignal` {/*cache-signal*/} - - - -`cacheSignal` is only for use with [React Server Components](/reference/rsc/server-components). - - - -`cacheSignal` allows you to know when the [`cache()`](/reference/react/cache) lifetime is over: - -``` -import {cache, cacheSignal} from 'react'; -const dedupedFetch = cache(fetch); - -async function Component() { - await dedupedFetch(url, { signal: cacheSignal() }); -} -``` - -This allows you to clean up or abort work when the result will no longer be used in the cache, such as: - -- React has successfully completed rendering -- The render was aborted -- The render has failed - -For more info, see the [`cacheSignal` docs](/reference/react/cacheSignal). - ---- - ## Notable Changes {/*notable-changes*/} ### Batching Suspense Boundaries for SSR {/*batching-suspense-boundaries-for-ssr*/} diff --git a/src/content/reference/react/cacheSignal.md b/src/content/reference/react/cacheSignal.md index ceeb56df8c1..c898ca53b1d 100644 --- a/src/content/reference/react/cacheSignal.md +++ b/src/content/reference/react/cacheSignal.md @@ -4,13 +4,13 @@ title: cacheSignal -`cacheSignal` is currently only used with [React Server Components](/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#react-server-components). +`cacheSignal` is currently only used with [React Server Components](/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023#react-server-components). -`cacheSignal` allows you to know when the `cache()` life time is over. +`cacheSignal` allows you to know when the `cache()` lifetime is over. ```js const signal = cacheSignal(); @@ -37,7 +37,7 @@ async function Component() { When React has finished rendering, the `AbortSignal` will be aborted. This allows you to cancel any in-flight work that is no longer needed. Rendering is considered finished when: -- React has successfully completed rendering +- React has successfully completed rendering - the render was aborted - the render has failed @@ -110,4 +110,4 @@ async function Component({id}) { } return
{data.name}
; } -``` \ No newline at end of file +``` From ba8bd160ae3650be53f21918dfefab40bf4529b6 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 16:03:11 -0400 Subject: [PATCH 27/30] ppr --- src/content/blog/2025/10/01/react-19-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 8a05284ae5e..fbc3220b4c9 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -178,7 +178,7 @@ See the [Component track docs](/reference/dev-tools/react-performance-tracks#com ## New React DOM Features {/*new-react-dom-features*/} -### `resume` {/*resume*/} +### Partial Pre-rendering {/*partial-pre-rendering*/} In 19.2 we're adding a new capability to pre-render part of the app ahead of time, and resume rendering it later. From 29d31a0acafa26ce16d70956097066b2504c472e Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 16:29:36 -0400 Subject: [PATCH 28/30] missing await --- src/content/blog/2025/10/01/react-19-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index fbc3220b4c9..8a31ecb9f32 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -209,7 +209,7 @@ const resumeStream = await resume(, postponed); Or you can call `resumeAndPrerender` to resume to get static HTML for SSG: ``` -const postponedState = getPostponedState(request); +const postponedState = await getPostponedState(request); const { prelude } = await resumeAndPrerender(, postponedState); // Send complete HTML prelude to CDN. From 76d7fbae0d330439155c56087f1a07d475290259 Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 16:59:58 -0400 Subject: [PATCH 29/30] add lint v6 --- src/content/blog/2025/10/01/react-19-2.md | 17 +++++++++++++++++ .../eslint-plugin-react-hooks/index.md | 16 +++++----------- .../lints/component-hook-factories.md | 9 +++------ .../eslint-plugin-react-hooks/lints/config.md | 8 +++----- .../lints/error-boundaries.md | 8 +++----- .../eslint-plugin-react-hooks/lints/gating.md | 8 +++----- .../eslint-plugin-react-hooks/lints/globals.md | 8 +++----- .../lints/immutability.md | 8 +++----- .../lints/incompatible-library.md | 8 +++----- .../lints/preserve-manual-memoization.md | 8 +++----- .../eslint-plugin-react-hooks/lints/purity.md | 8 +++----- .../eslint-plugin-react-hooks/lints/refs.md | 8 +++----- .../lints/set-state-in-effect.md | 8 +++----- .../lints/set-state-in-render.md | 8 +++----- .../lints/static-components.md | 8 +++----- .../lints/unsupported-syntax.md | 8 +++----- .../eslint-plugin-react-hooks/lints/use-memo.md | 8 +++----- 17 files changed, 67 insertions(+), 87 deletions(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index 8a31ecb9f32..c48b696ecf6 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -287,6 +287,23 @@ This is because Node Streams are much faster than Web Streams in Node, and Web S --- +### `eslint-plugin-react-hooks` v6 {/*eslint-plugin-react-hooks*/} + +We also published `eslint-plugin-react-hooks@6.1.0` with flat config by default in the `recommended` preset, and opt-in for new React Compiler powered rules. + +To continue using the legacy config, you can change to `recommended-legacy`: + +```diff +- extends: ['plugin:react-hooks/recommended'] ++ extends: ['plugin:react-hooks/recommended-legacy'] +``` + +For a full list of compiler enabled rules, [check out the linter docs](/reference/eslint-plugin-react-hooks#available-lints). + +Check out the `eslint-plugin-react-hooks` [changelog for a full list of changes](https://github.com/facebook/react/blob/main/packages/eslint-plugin-react-hooks/CHANGELOG.md#610). + +--- + ### Update the default `useId` prefix {/*update-the-default-useid-prefix*/} In 19.2, we're updating the default `useId` prefix from `:r:` (19.0.0) or `«r»` (19.1.0) to `_r_`. diff --git a/src/content/reference/eslint-plugin-react-hooks/index.md b/src/content/reference/eslint-plugin-react-hooks/index.md index 21e1222d803..34dbdc632c9 100644 --- a/src/content/reference/eslint-plugin-react-hooks/index.md +++ b/src/content/reference/eslint-plugin-react-hooks/index.md @@ -9,14 +9,6 @@ version: rc - - -These docs include rules available in the RC version of `eslint-plugin-react-hooks`. - -You can try them by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - - This plugin helps you catch violations of React's rules at build time, ensuring your components and hooks follow React's rules for correctness and performance. The lints cover both fundamental React patterns (exhaustive-deps and rules-of-hooks) and issues flagged by React Compiler. React Compiler diagnostics are automatically surfaced by this ESLint plugin, and can be used even if your app hasn't adopted the compiler yet. @@ -25,14 +17,16 @@ When the compiler reports a diagnostic, it means that the compiler was able to s What this means for linting, is that you don’t need to fix all violations immediately. Address them at your own pace to gradually increase the number of optimized components. -## Available Lints {/*available-lints*/} +## Recommended Rules {/*recommended*/} -These rules are available in the stable version of `eslint-plugin-react-hooks`: +These rules are included in the `recommended` preset `eslint-plugin-react-hooks`: * [`exhaustive-deps`](/reference/eslint-plugin-react-hooks/lints/exhaustive-deps) - Validates that dependency arrays for React hooks contain all necessary dependencies * [`rules-of-hooks`](/reference/eslint-plugin-react-hooks/lints/rules-of-hooks) - Validates that components and hooks follow the Rules of Hooks -These rules are available in the RC version of `eslint-plugin-react-hooks`: +## Additional Rules {/*additional-rules*/} + +Starting in version 6.0, these rules are available to opt-in: * [`component-hook-factories`](/reference/eslint-plugin-react-hooks/lints/component-hook-factories) - Validates higher order functions defining nested components or hooks * [`config`](/reference/eslint-plugin-react-hooks/lints/config) - Validates the compiler configuration options diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/component-hook-factories.md b/src/content/reference/eslint-plugin-react-hooks/lints/component-hook-factories.md index 44d23d758f1..49d6b6d43da 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/component-hook-factories.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/component-hook-factories.md @@ -1,6 +1,5 @@ --- title: component-hook-factories -version: rc --- @@ -9,13 +8,11 @@ Validates against higher order functions defining nested components or hooks. Co - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/config.md b/src/content/reference/eslint-plugin-react-hooks/lints/config.md index f7e099752b5..98bc8b27855 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/config.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/config.md @@ -9,13 +9,11 @@ Validates the compiler [configuration options](/reference/react-compiler/configu - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/error-boundaries.md b/src/content/reference/eslint-plugin-react-hooks/lints/error-boundaries.md index bd013f5325e..c9430ea36b2 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/error-boundaries.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/error-boundaries.md @@ -9,13 +9,11 @@ Validates usage of Error Boundaries instead of try/catch for errors in child com - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/gating.md b/src/content/reference/eslint-plugin-react-hooks/lints/gating.md index fdbbadf0efc..62b98df0898 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/gating.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/gating.md @@ -9,13 +9,11 @@ Validates configuration of [gating mode](/reference/react-compiler/gating). - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/globals.md b/src/content/reference/eslint-plugin-react-hooks/lints/globals.md index b9a20d4dbc7..ea429404a86 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/globals.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/globals.md @@ -9,13 +9,11 @@ Validates against assignment/mutation of globals during render, part of ensuring - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/immutability.md b/src/content/reference/eslint-plugin-react-hooks/lints/immutability.md index 9376271ebd9..33498ebe8c7 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/immutability.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/immutability.md @@ -9,13 +9,11 @@ Validates against mutating props, state, and other values that [are immutable](/ - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/incompatible-library.md b/src/content/reference/eslint-plugin-react-hooks/lints/incompatible-library.md index aa587750328..b041d02c5a5 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/incompatible-library.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/incompatible-library.md @@ -9,13 +9,11 @@ Validates against usage of libraries which are incompatible with memoization (ma - - -This rule is available in the RC version of `eslint-plugin-react-hooks`. + -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). +This rule is available in `eslint-plugin-react-hooks` v6. - + diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/preserve-manual-memoization.md b/src/content/reference/eslint-plugin-react-hooks/lints/preserve-manual-memoization.md index 2f296ac56b1..5efc2f82d7a 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/preserve-manual-memoization.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/preserve-manual-memoization.md @@ -9,13 +9,11 @@ Validates that existing manual memoization is preserved by the compiler. React C - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/purity.md b/src/content/reference/eslint-plugin-react-hooks/lints/purity.md index 14c870fb53b..74c1327597a 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/purity.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/purity.md @@ -9,13 +9,11 @@ Validates that [components/hooks are pure](/reference/rules/components-and-hooks - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/refs.md b/src/content/reference/eslint-plugin-react-hooks/lints/refs.md index 78776ba5724..d8fe222e825 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/refs.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/refs.md @@ -9,13 +9,11 @@ Validates correct usage of refs, not reading/writing during render. See the "pit - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-effect.md b/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-effect.md index df285fedfe8..55b63b3116a 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-effect.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-effect.md @@ -9,13 +9,11 @@ Validates against calling setState synchronously in an effect, which can lead to - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-render.md b/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-render.md index d5bd4f82abf..a88de100663 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-render.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/set-state-in-render.md @@ -9,13 +9,11 @@ Validates against unconditionally setting state during render, which can trigger - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/static-components.md b/src/content/reference/eslint-plugin-react-hooks/lints/static-components.md index 06945838f38..b403cc0b6af 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/static-components.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/static-components.md @@ -9,13 +9,11 @@ Validates that components are static, not recreated every render. Components tha - - -This rule is available in the RC version of `eslint-plugin-react-hooks`. + -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). +This rule is available in `eslint-plugin-react-hooks` v6. - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/unsupported-syntax.md b/src/content/reference/eslint-plugin-react-hooks/lints/unsupported-syntax.md index 3f3e04d53ad..b6055449a1d 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/unsupported-syntax.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/unsupported-syntax.md @@ -9,13 +9,11 @@ Validates against syntax that React Compiler does not support. If you need to, y - - -This rule is available in the RC version of `eslint-plugin-react-hooks`. + -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). +This rule is available in `eslint-plugin-react-hooks` v6. - + ## Rule Details {/*rule-details*/} diff --git a/src/content/reference/eslint-plugin-react-hooks/lints/use-memo.md b/src/content/reference/eslint-plugin-react-hooks/lints/use-memo.md index d19206d3c99..faa8c42d12b 100644 --- a/src/content/reference/eslint-plugin-react-hooks/lints/use-memo.md +++ b/src/content/reference/eslint-plugin-react-hooks/lints/use-memo.md @@ -9,13 +9,11 @@ Validates that the `useMemo` hook is used with a return value. See [`useMemo` do - + -This rule is available in the RC version of `eslint-plugin-react-hooks`. +This rule is available in `eslint-plugin-react-hooks` v6. -You can try it by upgrading the lint plugin [to the most recent RC version](/learn/react-compiler/installation#eslint-integration). - - + ## Rule Details {/*rule-details*/} From 6a3d1840da4f9589cbc0cf5c255f955346e7130b Mon Sep 17 00:00:00 2001 From: Rick Hanlon Date: Wed, 1 Oct 2025 17:15:57 -0400 Subject: [PATCH 30/30] fix link --- src/content/blog/2025/10/01/react-19-2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/blog/2025/10/01/react-19-2.md b/src/content/blog/2025/10/01/react-19-2.md index c48b696ecf6..1162e055521 100644 --- a/src/content/blog/2025/10/01/react-19-2.md +++ b/src/content/blog/2025/10/01/react-19-2.md @@ -298,7 +298,7 @@ To continue using the legacy config, you can change to `recommended-legacy`: + extends: ['plugin:react-hooks/recommended-legacy'] ``` -For a full list of compiler enabled rules, [check out the linter docs](/reference/eslint-plugin-react-hooks#available-lints). +For a full list of compiler enabled rules, [check out the linter docs](/reference/eslint-plugin-react-hooks#additional-rules). Check out the `eslint-plugin-react-hooks` [changelog for a full list of changes](https://github.com/facebook/react/blob/main/packages/eslint-plugin-react-hooks/CHANGELOG.md#610).