React 19アップデートのために必要なこと

React 19アップデートのために必要なこと 2025-02-25うひょさん×Takepepeさんが語る！ React19 アプデによるフロントエンド開発の今後とは

発表者紹介 uhyo 株式会社カオナビフロントエンドエキスパート業務でもReactのバージョンを上げるために日々頑張っている。 2

これまでのあらすじ 2024年4月 React 19 Betaリリース 2024年5月 React 19 RC リリース
その後紆余曲折があり 2024年12月 React 19 正式版リリース！皆さんはもうバージョン上げましたか？ 3

過去のイベント・記事 4

今回のイベントでは React 19も正式版が出たということで、そろそろアップデートについて考えたい。アップデートは大変？破壊的変更は？エコシステムはどうなる？など…… 5

This Talk まずはReact 19へのアップデートに必要なことを振り返ります 6

React 19アップデートに向けてすべきこと 7

①公式のアップグレードガイドを読もう https://react.dev/blog/2024/04/25/react-19-upgrade-guide 8

React 19の破壊的変更 React 19の破壊的変更は、古いAPIの削除が主。 React 19で消えるAPIは意外と色々ある。 React v15～18の間にdeprecatedになったAPIたちがついに引退。 9

②React 18.3に上げてみるまだ上げていない人は、一旦18.3に上げてみよう。 React 19で消えるAPIに対するwarningが追加。アプデ前に対応すべきものを検知できる。 10

React 19で消えるAPI列挙 propTypes / defaultProps※ Legacy Context string refs Module
pattern factories createFactory ReactDOM.render / ReactDOM.hydrate ReactDOM.unmountComponentAtNode 11

React 19で消えるAPI列挙 propTypes / defaultProps※ Legacy Context string refs Module
pattern factories createFactory ReactDOM.render / ReactDOM.hydrate ReactDOM.unmountComponentAtNode 12 古い書き方（クラスコンポーネント向けなど） Concurrent Rendering

ReactDOMのrender/hydrateに注意 React 18へのアップデートの一環で、 renderからcreateRootへの移行が推奨されていた。（Upgrade Guideから引用） 13

ReactDOMのrender/hydrateに注意 React 18にアプデしたけどまだcreateRootにしていなかった人は、まずこちらを移行しよう。（React 18時点でwarningになっているので多分移行しているはずだが） createRootを使うことでConcurrent Renderingが有効になるため、ごくわずかだが挙動が変わるリスクがある。（変なReactの使い方をしていた場合など）
14

③依存ライブラリをチェック歴史あるライブラリを使っていた場合、先にアップデートしておいたほうがいい。（クラスコンポーネントを中心に古いAPIが消えるため）もしメンテが止まっていたらさよなら。 15

余談: internalsのやつ SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED ↓改名された↓ __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE __SERVER_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ライブラリがこれを使っていた場合、ライブラリ作者ではなくユーザーが解雇されてしまうバグがReact 19で修正された。 RecoilがこれのせいでReact
19対応できなかったのは有名。 16

React 19アップデートで大変なのは？ 17

TypeScript周りが一番大変古いAPIが消えても今どきのプロジェクトは別に困らないが、TypeScriptの破壊的変更は結構たいへん。 18

ランタイムの修正が必要な点ランタイムの修正で対処すべき場合も。「あらゆるランタイムの修正は動作確認が必要」みたいな社内文化だと地獄を見るので、まず社内文化を修正しよう。 19

習慣を直す必要がある点 MutableRef → RefObjectに吸収されてdeprecatedに JSX.Element → React.JSX.Element が推奨 React.VFC →
役目を終えた。 React.FC にする他にもReact.ReactChildなどdeprecatedになった型が存在。 20

アップデートのやり方は？ 21

TypeScriptとワーニングを駆使する修正が必要な箇所は大体tscで検知できるはず。ただし、依存ライブラリ内は無理なので、そこはReact 18.3のワーニングを活用しよう。 22

codemod 古いAPIなど用にcodemodがあるが、無理に使わなくてもいい。（修正必要な箇所が少ない）一方、TypeScript関連の修正をしてくれる types-react-codemodは有用。とりあえずtscを動かしてみて型エラーが多かったら使ってみよう。 23

新たなdeprecatedの対処 React 19で新たにdeprecatedになったものは今すぐ直す必要はないが、お好みで直してもいい。（codemodもある）将来に向けて新たに使用しないように習慣を更新することが重要。 • forwardRefが不要になった •
<Context.Provider> → <Context> など 24

まとめ React 19にアップデートするには、依存ライブラリをよく確認しつつ、 TypeScriptで変更が必要な箇所を洗い出して、 types-react-codemodを活用して修正しよう。古いコーディング習慣をReact 19対応に更新することも忘れずに。 25

React 19アップデートのために必要なこと

React 19アップデートのために必要なこと

uhyo

More Decks by uhyo

Other Decks in Programming

Featured

Transcript