react-dom

Below is a list of all new features, APIs, and bug fixes.

Read the React 19.3 release post for more information.

New React Features

• <ViewTransition />: Adds <ViewTransition /> and addTransitionType APIs to power View Transition animations in React (@sebmarkbage, @jackpope, @gaearon: #31975, #31987, #31996, #31999, #32001, #32002, #32028, #32029, #32031, #32034, #32038, #32041, #32050, #32090, #32105, #32254, #32379, #32422, #32462, #32540, #32545, #32585, #32599, #32611, #32612, #32617, #32651, #32653, #32656, #32664, #32699, #32723, #32734, #32751, #32752, #32760, #32761, #32764, #32772, #32790, #32819, #32820, #32822, #32833, #32849, #33094, #33191, #33200, #33206, #33293, #33330, #33331, #33332, #33357, #33362, #33433, #33576, #34374, #34450, #34481, #34500, #34502, #34510, #34511, #34539, #35567, #35564, #35485, #35380, #35063, #35060, #34676, #36917, #35337, #35520)
• Fragment Refs: Add Refs to <Fragment /> to support composable platform behavior (@jackpope, @sebmarkbage, @eps1lon, @Dhakshin2007, @chirokas, @teamleaderleo, @fallintoplace: #32465, #32613, #32619, #32654, #32660, #32682, #32722, #32813, #32814, #33056, #33058, #33093, #34069, #34103, #34544, #34545, #37062, #37061, #37060, #36047, #36010, #35642, #35641, #35637, #35630, #34935, #37457, #37408, , , , , , , , , , , , , , , )

New React DOM Features

• browser(): a new react-dom API that returns a usable which errors during server rendering and resolves in the browser. use(browser()) inside a <Suspense> boundary marks a subtree as browser-only without reporting a recoverable error (@gnoff: #37143, #37241)
  • Added an onBrowserBailout option to the react-dom/server APIs to observe when a subtree defers to the browser (@gnoff #37193)

Notable changes

• Enable Trusted Types API integration (@rickhanlonii #35816)
• Transitions now render independently instead of being entangled into a single render, so a slow transition no longer holds up unrelated ones (@acdlite #37290)
• Added a DEV-only warning when a component appears to have been unblocked by calling use() conditionally (@hoxyq, @eps1lon: #37104, #37203, #37491)

All Changes

React

• Fast Refresh Fixes
  • Fix Fast Refresh to find and remount edits to components wrapped behind lazy() (@sophiebits #36965)
  • Fix Fast Refresh so edits to a memo() comparison function take effect (@sophiebits #36964)
  • Fix Fast Refresh crash when an edit changes the kind of a component's type (@sophiebits #36963)
  • Unify hot reload type resolution for Fast Refresh (@sophiebits #36962)
  • Fix Fast Refresh to remount correctly when an edit changes the component kind (@sophiebits #36950)
  • Double invoke effects in StrictMode after Fast Refresh (@eps1lon #35962)
• Performance Track Fixes
  • Prevent crash when accessing $$typeof in Performance Tracks (@eps1lon #35679)
  • Handle non-string function names in Performance Tracks (@eps1lon #35659)
  • Use minus (-) instead of en dash for removed props in Performance Tracks (@eps1lon #35649)
  • Handle arrays with bigints in deep objects in Performance Tracks (@eps1lon #35648)
  • Don't enumerate typed array props in Performance Tracks in DEV (@UditDewan #36913)
  • Bail out of diffing wide objects and arrays in Performance Tracks (@eps1lon #34742)
  • Clear potentially large performance measures in DEV (@hoxyq #34803)
  • Fix missing else branch for renders with no props change in Performance Tracks (@hoxyq #34837)
• Activity Fixes
  • Fix missing store mutations that happened while an Activity tree was hidden (@sophiebits )

React DOM

• Copy source onto the synthetic toggle event (@lazerg #37389)
• Update HTML parser rules for the new <select> parser (@josepharhar #34804)
• Update defaultValue for type="number" inputs to match other input types (@sophiebits #36980)
• Avoid setting innerHTML when it hasn't changed (@sophiebits #36949)
• Forward the nonce option in ReactDOM.preloadModule() (@UditDewan #36851)
• Support fetchPriority for module resources (@TheAlexLichter #36835)
• Track stylesheet preloads when explicitly preloaded to avoid unnecessary suspension (@gnoff #36386)
• Suggest correct casing for the misspelled credentialless iframe attribute (@vmx906 #36322)
• Add credentialless as a recognized boolean attribute for iframes (@vmx906 #36148)
• Prevent reentrant finishedTask from calling completeAll multiple times (@gnoff #36287)
• Update the CSS shorthand property list (@kidonng #35636)
• Support the maskType SVG prop (@sleitor #35921)
• Add support for onFullscreenChange and onFullscreenError events (@chirokas #34621)
• Include submitter in submit events (@eps1lon #35590)

React Server

• Add nonce to rendered import maps (@mattcosta7 #37339)
• Add an onBrowserBailout option to observe subtrees that defer to the browser (@gnoff #37193)
• Stop the caller's signal from retaining a finished render (@unstubbable #37315)
• Construct the render lifetime controller only when it is needed (@unstubbable #37357)
• Fix react-dom/server hanging on Deno (@fraidev #35235)
• Extend stack overflow recovery to retries in SSR (@jackpope #36977)
• Fix false-positive hydration mismatch on nonce attributes (@MaxwellCohen #37030)
• Guard shell-error callbacks instead of nulling them out on the request (@eps1lon #36916)
• Stop firing onAllReady after the shell errored (@eps1lon #36903)
• Treat an incomplete tree as an error during error recovery (@acdlite #36911)
• Fix non-script modulepreload tracking (@fallintoplace #36564)
• Finalize postponed nextSegmentId after the prelude flush (@gaojude #36779)
• Preserve referrerPolicy in image preload headers (@ulises-jeremias #36803)
• Allow pending work to specialize abort reasons (@gnoff #36586)
• Abort tasks that suspend after aborting during render (@gnoff #36585)
• Finish abort in a scheduled task (@gnoff )

React Server Components

• Keep an element pending while a referenced row is resolving (@unstubbable #37542)
• Fix RangeError from exponential debug info growth (@unstubbable #37481)
• Abort the cache signal when debug objects are retained (@unstubbable #37342)
• Transfer key validation of lazy nodes when they are unwrapped (@unstubbable #37258)
• Add pending_weak to the Flight thenable protocol (@acdlite #37154)
• Outline and dedupe repeated strings (@gaearon #37147)
• Port Reply Server traversal guards to the Flight Client (@eps1lon #37144)
• Define Flight chunk .then with Object.defineProperty (@eps1lon #37109)
• Support Turbopack's experimental array format for chunks (@sampoder #37095)
• Limit fake JSX call site stacks to 10 frames (@timneutkens #37086)
• Improve performance when decoding Flight replies (@gnoff #37090)
• Recognize Node 22+ V8 frames for Promise statics in debug info (@gaearon #36969)
• Tailor the warning for binary data serialized through toJSON (Node Buffer) (@unstubbable #36873)
• Resolve models before JSON.stringify for faster serialization (@mhart #36795)
• Prune debug info when chunks error (@gnoff #36782)
• Avoid main-thread stalls from large debug strings (@unstubbable )