React を 18 から 19 に上げると動かなくなること
React を 18 から 19 に上げると、ReactDOM.render と findDOMNode が TypeError になり、関数コンポーネントの defaultProps は黙って無視される。
18.3 と 19.3 で打ち比べた 9 つの変更点と直し方をまとめる。
公開: 更新:
react@18 を入れたプロジェクトと、同じファイルのまま react@19 に上げたプロジェクトを並べ、同じコマンドを打ち比べた。
各節の出力は「v18 では」「v19 に上げると」「v19 で直すと」の 3 段で並ぶ。
ブラウザは使わず、Node.js の上で動かした。
JSX は tsx で変換し、DOM は jsdom で用意している。
tsx に新しい JSX 変換を使わせるため、プロジェクトの直下に "jsx": "react-jsx" と "allowJs": true を書いた tsconfig.json を置いた。
テストのコードも Jest や Vitest を通さずに tsx で直に動かしたので、出力に出るのは React と Node.js の文言だけである。
型の変更点は @types/react を 18 と 19 で入れ替え、同じ TypeScript 5.9 の tsc で確かめた。
旧版には 18 系の最新の 18.3.1 を使った。
公式の移行ガイドによると、18.3 は中身が 18.2 と同じで、19 で無くなる API に警告を足した版である。
v18 の段に出る Warning: の行は、型の検査の Failed prop type を除けば、19 で無くなるか非推奨になる API を指している。
公式の移行ガイドは、act を react へ移したことと、react-dom/test-utils から読んだときの非推奨の警告の文を載せている。
19 で react-dom/test-utils の act を呼んだときの動きは、このページでは打っていない。
警告の出ない変更もある。
関数コンポーネントの propTypes と、react-dom/test-utils の Simulate は、18.3 では何も言わずに 19 で無くなった。
動かなくなる原因は 3 つに分かれる。
1 つ目は API の削除で、ReactDOM.render や findDOMNode を呼ぶと TypeError になる。
2 つ目は挙動が黙って変わるもので、関数コンポーネントの defaultProps は 19 では読まれず、エラーも出ない。
3 つ目は @types/react の型の変更で、実行はできても tsc が止まる。
19 では、描画中のエラーが呼び出し元へ投げ直されなくなった。
公式の移行ガイドによると、エラーの境界で捕まらなかったエラーは window.reportError に渡され、境界で捕まったエラーは console.error に出る。
このページの jsdom の上では、エラーとスタックが出たあとも処理が続いた。
文字列の ref と findDOMNode の節では、エラーが出ても終了コードは 0 で、画面には何も描かれていない。
公式のガイドは、置き換えの多くを codemod の npx codemod@latest react/19/migration-recipe で書き換えられると案内している。
型の変更は別の codemod(npx types-react-codemod@latest preset-19 ./src)が受け持つ。
このページで打っていない変更点も、公式の移行ガイドに一覧がある。
19 は新しい JSX 変換を必須にし、古い変換のままだと outdated JSX transform の警告が出る。
このページは最初から新しい変換で動かしたので、この警告は出ていない。
ほかに、React.createFactory・モジュールパターンのファクトリ・UMD のビルドが無くなり、element.ref を読むと警告が出るようになった。
19.0.0 の CHANGELOG によると、renderToStaticNodeStream も無くなった。
Suspense の中の要素が待ちに入ると、兄弟を描き終えるのを待たずに fallback を出すようになった。
TypeScript の型では、ReactElement の props が unknown になり、useReducer に reducer の型を型引数で渡す書き方が使えなくなった(公式の移行ガイドの TypeScript の節)。VFC・ReactChild・ReactText・LegacyRef などの非推奨の型も消え、tsc が止まる(types-react-codemod の preset-19 が書き換える)。
ref のコールバックが値を返すと型エラーになる変更も、このページでは打っていない。
StrictMode の動きも変わった(公式の移行ガイド)。
開発中の 2 回目の描画では 1 回目の useMemo と useCallback の結果を使い回し、ref のコールバックも初回に 2 回呼ぶ。
どちらもこのページでは打っていない。
19.0 のあとの 19.1〜19.3 は機能の追加が中心だが、CHANGELOG には 18 のコードに響く変更もある。
19.1 で React.act が本番用のビルドから外れ、NODE_ENV=production で動かすテストでは act が使えなくなった。
HTML のコメント(<!-- -->)を描画先のコンテナにする書き方も、19.1 で使えなくなった。
useId が返す ID は 19.1 と 19.2 で形が変わり、18 の :r123: から : が無くなったので、ID を含むスナップショットは撮り直しになる。
19.3 では、複数のトランジションが 1 回の描画にまとめられず、別々に描かれるようになった。
どれもこのページでは打っていない。
ReactDOM.render と unmountComponentAtNode が無くなった
ReactDOM.render は React 17 までの描画の入口である。
18 では非推奨になり、呼ぶと警告を出したうえで React 17 と同じ描画で動いていた。
19 では render・hydrate・unmountComponentAtNode が react-dom から消えた。import ReactDOM from "react-dom" で読んだオブジェクトに render が無いので、呼んだところで TypeError になる。
v18 では
$ cat main.jsx
import "global-jsdom/register";
import ReactDOM from "react-dom";
function App() {
return <h1>Hello</h1>;
}
const container = document.createElement("div");
ReactDOM.render(<App />, container);
console.log(container.innerHTML);
ReactDOM.unmountComponentAtNode(container);$ npx tsx main.jsx
Warning: ReactDOM.render is no longer supported in React 18. Use createRoot instead. Until you switch to the new API, your app will behave as if it's running React 17. Learn more: https://reactjs.org/link/switch-to-createroot
<h1>Hello</h1>
Warning: unmountComponentAtNode is deprecated and will be removed in the next major release. Switch to the createRoot API. Learn more: https://reactjs.org/link/switch-to-createroot
$ echo $?
0$ node -p 'Object.keys(require("react-dom")).sort().join("\n")'
__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
createPortal
createRoot
findDOMNode
flushSync
hydrate
hydrateRoot
render
unmountComponentAtNode
unstable_batchedUpdates
unstable_renderSubtreeIntoContainer
versionv19 に上げると
$ npx tsx main.jsx
/work/v19/reactdom-render/main.jsx:9
ReactDOM.render(<App />, container);
^
TypeError: ReactDOM.render is not a function
at <anonymous> (/work/v19/reactdom-render/main.jsx:9:10)
at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
at async node:internal/modules/esm/loader:647:26
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
Node.js v24.22.2
$ echo $?
1$ node -p 'Object.keys(require("react-dom")).sort().join("\n")'
__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE
browser
createPortal
flushSync
preconnect
prefetchDNS
preinit
preinitModule
preload
preloadModule
requestFormReset
unstable_batchedUpdates
useFormState
useFormStatus
versionv19 で直すと
$ cat main.jsx
import "global-jsdom/register";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
function App() {
return <h1>Hello</h1>;
}
const container = document.createElement("div");
const root = createRoot(container);
flushSync(() => root.render(<App />));
console.log(container.innerHTML);
root.unmount();$ npx tsx main.jsx
<h1>Hello</h1>
$ echo $?
0react-dom が出す名前を並べると、19 では render・hydrate・unmountComponentAtNode・findDOMNode・unstable_renderSubtreeIntoContainer が無くなっていた。createRoot と hydrateRoot も react-dom の直下からは消え、react-dom/client だけが出している。
先頭の内部用の名前も、__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED から __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE に変わっていた。
公式の移行ガイドによると、React の内部に触れているライブラリは、こうした内部の変更で 19 に上げられなくなることがある。
react-dom/client の createRoot で root を作り、root.render で描く。
外すときは unmountComponentAtNode(container) の代わりに root.unmount() を呼ぶ。
サーバーで描いた HTML に ReactDOM.hydrate をかけていたなら、hydrateRoot(container, <App />) に置き換える。
ここで root.render を flushSync で包んだのは、描いた直後に innerHTML を読むためである。
react.dev の createRoot のリファレンスによると、root.render は呼んだ時点ではまだ DOM を変えない。
ブラウザのアプリでは root.render(<App />) だけを書けばよい。flushSync を外した形は、このページでは打っていない。
findDOMNode が無くなった
findDOMNode は、クラスコンポーネントのインスタンスから、それが描いた DOM を探す関数である。
18.3 は警告を出していたが、19 で消えた。
19 では componentDidMount の中で TypeError になり、入力欄は描かれず、フォーカスも BODY に残る。
v18 では
$ cat auto-focus.jsx
import "global-jsdom/register";
import { Component } from "react";
import ReactDOM, { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
class AutoFocus extends Component {
componentDidMount() {
ReactDOM.findDOMNode(this).focus();
}
render() {
return <input />;
}
}
const container = document.createElement("div");
document.body.append(container);
flushSync(() => createRoot(container).render(<AutoFocus />));
console.log(document.body.innerHTML);
console.log(document.activeElement.tagName);$ npx tsx auto-focus.jsx
Warning: findDOMNode is deprecated and will be removed in the next major release. Instead, add a ref directly to the element you want to reference. Learn more about using refs safely here: https://reactjs.org/link/strict-mode-find-node
at AutoFocus (/work/v18/find-dom-node/auto-focus.jsx:6:1)
<div><input></div>
INPUT
$ echo $?
0v19 に上げると
$ npx tsx auto-focus.jsx
TypeError: ReactDOM.findDOMNode is not a function
at AutoFocus.componentDidMount (/work/v19/find-dom-node/auto-focus.jsx:8:14)
at Object.react_stack_bottom_frame (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:28594:22)
at runWithFiberInDEV (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:1045:30)
at commitLayoutEffectOnFiber (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:15062:21)
at recursivelyTraverseLayoutEffects (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:16482:11)
at commitLayoutEffectOnFiber (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:15121:11)
at flushLayoutEffects (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:19839:15)
at commitRoot (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:19605:36)
at completeRoot (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:19509:9)
at completeRootWhenReady (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:18363:7)
An error occurred in the <AutoFocus> component.
Consider adding an error boundary to your tree to customize error handling behavior.
Visit https://react.dev/link/error-boundaries to learn more about error boundaries.
<div></div>
BODY
$ echo $?
0v19 で直すと
$ cat auto-focus.jsx
import "global-jsdom/register";
import { Component, createRef } from "react";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
class AutoFocus extends Component {
input = createRef();
componentDidMount() {
this.input.current.focus();
}
render() {
return <input ref={this.input} />;
}
}
const container = document.createElement("div");
document.body.append(container);
flushSync(() => createRoot(container).render(<AutoFocus />));
console.log(document.body.innerHTML);
console.log(document.activeElement.tagName);$ npx tsx auto-focus.jsx
<div><input></div>
INPUT
$ echo $?
0自分のコードで呼んでいなくても、依存しているライブラリが中で ReactDOM.findDOMNode(...) の形で呼んでいれば、19 では同じく関数が無いという TypeError になる。import { findDOMNode } from "react-dom" のように名前を指定して読む ES モジュールのライブラリは、読み込みの時点で SyntaxError になるはずだが、この形は打っていない。
バンドラーを通したコードでは文言が変わることがあり、このページではその形は打っていない。
エラーのスタックに出るファイルの場所を見ると、どのパッケージが呼んでいるかが分かる。
createRef で ref を作り、DOM 要素に ref={this.input} で渡す。componentDidMount の時点では this.input.current に DOM 要素が入っている。
関数コンポーネントなら useRef を使う。
関数コンポーネントの defaultProps と propTypes が無視されるようになった
19 は関数コンポーネントの defaultProps と propTypes を読まない。
どちらもエラーや警告を出さないので、name を渡さずに描いた <Greeting /> が Hello, ! になっても気づきにくい。
18.3 は defaultProps に予告の警告を出していたが、propTypes には型が合わないときの Failed prop type しか出していなかった。
v18 では
$ cat greeting.jsx
import PropTypes from "prop-types";
import { renderToString } from "react-dom/server";
function Greeting({ name }) {
return <p>Hello, {name}!</p>;
}
Greeting.propTypes = { name: PropTypes.string };
Greeting.defaultProps = { name: "guest" };
console.log(renderToString(<Greeting />));
console.log(renderToString(<Greeting name={42} />));$ npx tsx greeting.jsx
Warning: Greeting: Support for defaultProps will be removed from function components in a future major release. Use JavaScript default parameters instead.
at Greeting (/work/v18/default-props/greeting.jsx:4:21)
<p>Hello, <!-- -->guest<!-- -->!</p>
Warning: Failed prop type: Invalid prop `name` of type `number` supplied to `Greeting`, expected `string`.
at Greeting (/work/v18/default-props/greeting.jsx:4:21)
<p>Hello, <!-- -->42<!-- -->!</p>
$ echo $?
0v19 に上げると
$ npx tsx greeting.jsx
<p>Hello, <!-- -->!</p>
<p>Hello, <!-- -->42<!-- -->!</p>
$ echo $?
0v19 で直すと
$ cat greeting.jsx
import { renderToString } from "react-dom/server";
function Greeting({ name = "guest" }) {
return <p>Hello, {name}!</p>;
}
console.log(renderToString(<Greeting />));
console.log(renderToString(<Greeting name={42} />));$ npx tsx greeting.jsx
<p>Hello, <!-- -->guest<!-- -->!</p>
<p>Hello, <!-- -->42<!-- -->!</p>
$ echo $?
0既定値は、引数の分割代入に { name = "guest" } と書く。
19 は propTypes を検査しないので、42 を渡しても何も言わない。
props の型を検査したいなら TypeScript で型を書く。
公式の codemod(npx codemod@latest react/prop-types-typescript)は propTypes を TypeScript の型に書き換える。
公式の移行ガイドによると、クラスコンポーネントの defaultProps は 19 でも使える。
クラスには ES2015 の既定値で代わりを書く方法が無いからである。
文字列の ref が使えなくなった
ref="input" と書いて this.refs.input で読む文字列の ref は、16.3 から非推奨だった。
19 では描画の途中で Expected ref to be a function のエラーになり、<div> の中は空のまま残った。
終了コードが 0 なのは、19 が描画中のエラーを投げ直さないからである。
v18 では
$ cat search-box.jsx
import "global-jsdom/register";
import { Component } from "react";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
class SearchBox extends Component {
componentDidMount() {
this.refs.input.focus();
}
render() {
return <input ref="input" />;
}
}
const container = document.createElement("div");
document.body.append(container);
flushSync(() => createRoot(container).render(<SearchBox />));
console.log(document.body.innerHTML);$ npx tsx search-box.jsx
Warning: Component "SearchBox" contains the string ref "input". Support for string refs will be removed in a future major release. We recommend using useRef() or createRef() instead. Learn more about using refs safely here: https://reactjs.org/link/strict-mode-string-ref
at SearchBox (/work/v18/string-refs/search-box.jsx:6:1)
<div><input></div>
$ echo $?
0v19 に上げると
$ npx tsx search-box.jsx
Error: Expected ref to be a function, an object returned by React.createRef(), or undefined/null.
at markRef (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:10526:17)
at beginWork (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:12467:13)
at runWithFiberInDEV (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:1045:30)
at performUnitOfWork (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:19176:22)
at workLoopSync (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:19004:41)
at renderRootSync (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:18985:11)
at performWorkOnRoot (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:18094:35)
at performSyncWorkOnRoot (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:20680:7)
at flushSyncWorkAcrossRoots_impl (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:20522:21)
at flushSyncWork$1 (/work/v19/node_modules/react-dom/cjs/react-dom-client.development.js:18439:12)
An error occurred in the <input> component.
Consider adding an error boundary to your tree to customize error handling behavior.
Visit https://react.dev/link/error-boundaries to learn more about error boundaries.
<div></div>
$ echo $?
0v19 で直すと
$ cat search-box.jsx
import "global-jsdom/register";
import { Component } from "react";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
class SearchBox extends Component {
componentDidMount() {
this.input.focus();
}
render() {
return <input ref={(el) => { this.input = el; }} />;
}
}
const container = document.createElement("div");
document.body.append(container);
flushSync(() => createRoot(container).render(<SearchBox />));
console.log(document.body.innerHTML);$ npx tsx search-box.jsx
<div><input></div>
$ echo $?
0ref のコールバックで DOM 要素を受け取り、インスタンスに入れておく。
公式の codemod(npx codemod@latest react/19/replace-string-ref)は形が違い、ref のコールバックで this.refs.input に代入するように書き換える。
18.3.0 の CHANGELOG によると、この書き換えのために this.refs への代入が許されたので、読む側の this.refs.input はそのまま使える(このページでは打っていない)。
コールバックの本体は { this.input = el; } のように波括弧で囲む。
公式の移行ガイドによると、19 では ref のコールバックが返した関数を片付けの処理として呼ぶので、(el) => (this.input = el) のように値を返す書き方は @types/react 19 の型で弾かれる。
contextTypes と getChildContext の旧 Context が無くなった
childContextTypes と getChildContext で値を配り、contextTypes で受け取る旧 Context は、16.3 で createContext が入ったあとも動いていた。
19 ではこの仕組みが無くなり、this.context が空になる。
エラーでは止まらず、removed in React 19 のメッセージを出したあと、className の無い <button> が描かれた。
v18 では
$ cat theme.jsx
import "global-jsdom/register";
import PropTypes from "prop-types";
import { Component } from "react";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
class ThemeProvider extends Component {
static childContextTypes = { theme: PropTypes.string };
getChildContext() {
return { theme: "dark" };
}
render() {
return this.props.children;
}
}
class Button extends Component {
static contextTypes = { theme: PropTypes.string };
render() {
return <button className={this.context.theme}>OK</button>;
}
}
const container = document.createElement("div");
flushSync(() =>
createRoot(container).render(
<ThemeProvider>
<Button />
</ThemeProvider>,
),
);
console.log(container.innerHTML);$ npx tsx theme.jsx
Warning: ThemeProvider uses the legacy childContextTypes API which is no longer supported and will be removed in the next major release. Use React.createContext() instead
.Learn more about this warning here: https://reactjs.org/link/legacy-context
at ThemeProvider (/work/v18/legacy-context/theme.jsx:7:1)
Warning: Button uses the legacy contextTypes API which is no longer supported and will be removed in the next major release. Use React.createContext() with static contextType instead.
Learn more about this warning here: https://reactjs.org/link/legacy-context
at Button (/work/v18/legacy-context/theme.jsx:17:1)
at ThemeProvider (/work/v18/legacy-context/theme.jsx:7:1)
<button class="dark">OK</button>
$ echo $?
0v19 に上げると
$ npx tsx theme.jsx
ThemeProvider uses the legacy childContextTypes API which was removed in React 19. Use React.createContext() instead. (https://react.dev/link/legacy-context)
Button uses the legacy contextTypes API which was removed in React 19. Use React.createContext() with static contextType instead. (https://react.dev/link/legacy-context)
<button>OK</button>
$ echo $?
0v19 で直すと
$ cat theme.jsx
import "global-jsdom/register";
import { Component, createContext } from "react";
import { flushSync } from "react-dom";
import { createRoot } from "react-dom/client";
const ThemeContext = createContext("light");
class Button extends Component {
static contextType = ThemeContext;
render() {
return <button className={this.context}>OK</button>;
}
}
const container = document.createElement("div");
flushSync(() =>
createRoot(container).render(
<ThemeContext.Provider value="dark">
<Button />
</ThemeContext.Provider>,
),
);
console.log(container.innerHTML);$ npx tsx theme.jsx
<button class="dark">OK</button>
$ echo $?
0createContext で Context を作り、配る側は <ThemeContext.Provider value="dark"> で包む。
クラスコンポーネントで受け取るなら static contextType = ThemeContext を書き、this.context で値を読む。
関数コンポーネントでは useContext(ThemeContext) で読む。
古いライブラリが旧 Context で値を配っていると、そのライブラリを新しい版に上げるまで直せない。
メッセージの先頭に出るコンポーネントの名前で、どのライブラリかを探す。
react-dom/test-utils から act が移り、ほかの関数が無くなった
react-dom/test-utils は、19 で act だけを出すようになった。act は react へ移った。
公式の移行ガイドは、react-dom/test-utils から act を読むと非推奨の警告が出るとしている。
19 でこの act を呼んだときの動きは、このページでは打っていない。
Simulate や renderIntoDocument などのほかの関数は無くなり、名前を指定した import が SyntaxError で止まる。
公式の移行ガイドは、ほかの関数は呼ぶとエラーになり、export は将来の版で消すと書いているが、19.3.1 では export がすでに無かった。
v18 では
$ cat counter.test.jsx
import "global-jsdom/register";
import { useState } from "react";
import { createRoot } from "react-dom/client";
import { act, Simulate } from "react-dom/test-utils";
globalThis.IS_REACT_ACT_ENVIRONMENT = true;
function Counter() {
const [count, setCount] = useState(0);
return <button onClick={() => setCount(count + 1)}>{count}</button>;
}
const container = document.createElement("div");
await act(() => createRoot(container).render(<Counter />));
const button = container.querySelector("button");
act(() => Simulate.click(button));
console.log(button.textContent);$ npx tsx counter.test.jsx
Warning: `ReactDOMTestUtils.act` is deprecated in favor of `React.act`. Import `act` from `react` instead of `react-dom/test-utils`. See https://react.dev/warnings/react-dom-test-utils for more info.
1
$ echo $?
0$ node -p 'Object.keys(require("react-dom/test-utils")).join("\n")'
Simulate
act
findAllInRenderedTree
findRenderedComponentWithType
findRenderedDOMComponentWithClass
findRenderedDOMComponentWithTag
isCompositeComponent
isCompositeComponentWithType
isDOMComponent
isDOMComponentElement
isElement
isElementOfType
mockComponent
nativeTouchData
renderIntoDocument
scryRenderedComponentsWithType
scryRenderedDOMComponentsWithClass
scryRenderedDOMComponentsWithTag
traverseTwoPhasev19 に上げると
$ npx tsx counter.test.jsx
/work/v19/test-utils/counter.test.jsx:4
import { act, Simulate } from "react-dom/test-utils";
^
SyntaxError: The requested module 'react-dom/test-utils' does not provide an export named 'Simulate'
at #asyncInstantiate (node:internal/modules/esm/module_job:455:21)
at async ModuleJob.run (node:internal/modules/esm/module_job:553:5)
at async node:internal/modules/esm/loader:647:26
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
Node.js v24.22.2
$ echo $?
1$ node -p 'Object.keys(require("react-dom/test-utils")).join("\n")'
actv19 で直すと
$ cat counter.test.jsx
import "global-jsdom/register";
import { act, useState } from "react";
import { createRoot } from "react-dom/client";
globalThis.IS_REACT_ACT_ENVIRONMENT = true;
function Counter() {
const [count, setCount] = useState(0);
return <button onClick={() => setCount(count + 1)}>{count}</button>;
}
const container = document.createElement("div");
document.body.append(container);
await act(() => createRoot(container).render(<Counter />));
const button = container.querySelector("button");
act(() => button.dispatchEvent(new MouseEvent("click", { bubbles: true })));
console.log(button.textContent);$ npx tsx counter.test.jsx
1
$ echo $?
0このテストの 18.3 では、警告が出たのは act だけで、Simulate には何も出なかった。
ここで SyntaxError になったのは、ES モジュールの import で名前を指定して読んだからである。
Jest のように import を require に変換して動かす環境では、読み込みの時点では止まらず、Simulate を使ったところで落ちる。
この形はこのページでは打っていない。
act は react から読む。
クリックは DOM の dispatchEvent で起こし、bubbles: true を付ける。
React はイベントを root でまとめて受け取るので、泡立たないイベントはハンドラーまで届かない(bubbles を外した形は、このページでは打っていない)。
Testing Library を入れているなら、fireEvent.click や user-event で同じことを短く書ける。
react-test-renderer が非推奨になり、toJSON が null を返すようになった
19 の react-test-renderer は、使うと非推奨の警告を出す。
19.0.0 の CHANGELOG によると、web 向けの描画も concurrent に変わった。TestRenderer.create は戻った時点でまだ描き終えておらず、直後に toJSON() を読むと null が返る。
終了コードは 0 なので、新しくスナップショットを撮るテストなら、null を正しい値として保存しかねない。
v18 では
$ cat hello.test.jsx
import TestRenderer from "react-test-renderer";
function Hello() {
return <p>Hello</p>;
}
const tree = TestRenderer.create(<Hello />);
console.log(JSON.stringify(tree.toJSON()));$ npx tsx hello.test.jsx
{"type":"p","props":{},"children":["Hello"]}
$ echo $?
0v19 に上げると
$ npx tsx hello.test.jsx
react-test-renderer is deprecated. See https://react.dev/warnings/react-test-renderer
null
$ echo $?
0v19 で直すと
$ cat hello.test.jsx
import { act } from "react";
import TestRenderer from "react-test-renderer";
globalThis.IS_REACT_ACT_ENVIRONMENT = true;
function Hello() {
return <p>Hello</p>;
}
let tree;
await act(() => {
tree = TestRenderer.create(<Hello />);
});
console.log(JSON.stringify(tree.toJSON()));$ npx tsx hello.test.jsx
react-test-renderer is deprecated. See https://react.dev/warnings/react-test-renderer
{"type":"p","props":{},"children":["Hello"]}
$ echo $?
0$ cat hello-rtl.test.jsx
import "global-jsdom/register";
import { render } from "@testing-library/react";
function Hello() {
return <p>Hello</p>;
}
const { container } = render(<Hello />);
console.log(container.innerHTML);$ npx tsx hello-rtl.test.jsx
<p>Hello</p>
$ echo $?
0create を act で包むと、act を抜けるまでに描画が終わり、18 と同じ JSON が返る。
ただし非推奨の警告は残る。
公式の移行ガイドは非推奨の理由に、実際の環境と違う独自の描画環境で動くこと、実装の細部を試すテストを招くこと、React の内部に頼っていることを挙げている。
そのうえで Testing Library への移行を勧めている。@testing-library/react の render は描画を act で包んで行うので、戻った時点で DOM ができている。
Testing Library は DOM を使うため、Jest なら testEnvironment を jsdom に、Vitest なら environment を jsdom にして、jsdom のパッケージも入れる。
Jest 28 からは jsdom の環境が同梱されなくなったので、jest-environment-jsdom を別に入れる。
react-test-renderer/shallow は 19 で無くなった。
浅い描画を使い続けるなら、公式のガイドのとおり react-shallow-renderer を入れて読み込み先を書き換える。
useRef に引数が必須になった
@types/react 19 の useRef は、引数を 1 つ必須にした。
18 の型で通っていた useRef<number>() は TS2554 になる。
変わったのは @types/react の型定義で、公式の移行ガイドもこの変更を TypeScript の変更の節に挙げている。
v18 では
$ cat tsconfig.json
{
"compilerOptions": {
"target": "es2022",
"module": "esnext",
"moduleResolution": "bundler",
"jsx": "react-jsx",
"strict": true,
"noEmit": true,
"skipLibCheck": true
},
"include": ["src"]
}$ cat src/Timer.tsx
import { useEffect, useRef } from "react";
export function Timer() {
const intervalRef = useRef<number>();
useEffect(() => {
intervalRef.current = window.setInterval(() => {}, 1000);
return () => window.clearInterval(intervalRef.current);
}, []);
return null;
}$ npx tsc
$ echo $?
0v19 に上げると
$ npx tsc
src/Timer.tsx(4,23): error TS2554: Expected 1 arguments, but got 0.
$ echo $?
2v19 で直すと
$ cat src/Timer.tsx
import { useEffect, useRef } from "react";
export function Timer() {
const intervalRef = useRef<number>(undefined);
useEffect(() => {
intervalRef.current = window.setInterval(() => {}, 1000);
return () => window.clearInterval(intervalRef.current);
}, []);
return null;
}$ npx tsc
$ echo $?
0$ npx tsc -p /work/v18/use-ref-argument
$ echo $?
0useRef<number>(undefined) と初期値を書く。
直した書き方は @types/react 18.3 の型でも通ったので、React を上げる前に直しておける。
公式の移行ガイドによると、19 の型では ref がすべて書き換えのできる RefObject になり、MutableRefObject は非推奨になった。useRef<HTMLInputElement>(null) の戻り値は RefObject<HTMLInputElement | null> になる。
グローバルの JSX 名前空間が無くなった
@types/react 18 は JSX をグローバルにも宣言していたので、import を書かずに JSX.Element を使えた。
19 はグローバルの宣言をやめ、JSX を React.JSX の中にだけ置いた。
戻り値の型に JSX.Element と書いた関数が TS2503 になる。
v18 では
$ cat src/Title.tsx
export function Title({ text }: { text: string }): JSX.Element {
return <h1>{text}</h1>;
}$ npx tsc
$ echo $?
0v19 に上げると
$ npx tsc
src/Title.tsx(1,52): error TS2503: Cannot find namespace 'JSX'.
$ echo $?
2v19 で直すと
$ cat src/Title.tsx
import type { JSX } from "react";
export function Title({ text }: { text: string }): JSX.Element {
return <h1>{text}</h1>;
}$ npx tsc
$ echo $?
0$ npx tsc -p /work/v18/jsx-namespace
$ echo $?
0import type { JSX } from "react" を足すか、React.JSX.Element と書く。
直した書き方は 18.3 の型でも通った。
カスタム要素などの型を declare global { namespace JSX { ... } } で足していたなら、declare module の中の namespace JSX に移す。
公式の移行ガイドによると、書く先のモジュールは tsconfig.json の jsx で決まり、react-jsx なら react/jsx-runtime になる。
検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 15 件)
- 検証日
- 実行環境
node:24Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 24.22.2
- npm 11.19.1
- Python 3.11.2
- Git 2.39.5
- React(旧) 18.3.1
- React(新) 19.3.1
- react-dom(旧) 18.3.1
- react-dom(新) 19.3.1
- react-test-renderer(旧) 18.3.1
- react-test-renderer(新) 19.3.1
- @types/react(旧) 18.3.31
- @types/react(新) 19.3.0
- TypeScript 5.9.3
- tsx 4.23.15
- jsdom 31.0.0
- global-jsdom 30.0.0
- prop-types 15.8.1
- @testing-library/react 16.3.3
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。