From d917a2b898893f3a9a5bc6cedb3dd3890e823eca Mon Sep 17 00:00:00 2001 From: caiolucasbittencourt Date: Mon, 4 May 2026 22:55:37 -0300 Subject: [PATCH] docs(react-dom): clarify unstable_batchedUpdates --- src/content/reference/react-dom/index.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/content/reference/react-dom/index.md b/src/content/reference/react-dom/index.md index d01bd656204..43321b61ab7 100644 --- a/src/content/reference/react-dom/index.md +++ b/src/content/reference/react-dom/index.md @@ -41,6 +41,14 @@ The `react-dom` package provides two additional entry points: --- +## Legacy APIs {/*legacy-apis*/} + +These APIs are exported for compatibility with legacy roots created with `ReactDOM.render` in React 18 and earlier. They are not recommended for newly written code. + +* `unstable_batchedUpdates` lets you batch updates that happen outside React event handlers in legacy roots. In React 18+ with `createRoot`, React batches updates automatically, so `unstable_batchedUpdates` is a no-op. + +--- + ## Removed APIs {/*removed-apis*/} These APIs were removed in React 19: