はじめに

React Compiler の機能

React Compiler は、ビルド時に React アプリケーションを自動的に最適化します。React は最適化なしでも十分に高速ですが、アプリの応答性を保つために、コンポーネントや値を手動でメモ化する必要がある場合があります。このメモ化は面倒で、間違いやすく、コードのメンテナンス性を損ねます。React Compiler はこの最適化を自動的に行い、開発者は機能開発に集中できるようになります。

React Compiler を使用しない場合

再レンダーを最適化するためにコンポーネントや値をメモ化する必要があります。

import { useMemo, useCallback, memo } from 'react';

const ExpensiveComponent = memo(function ExpensiveComponent({ data, onClick }) {
  const processedData = useMemo(() => {
    return expensiveProcessing(data);
  }, [data]);

  const handleClick = useCallback((item) => {
    onClick(item.id);
  }, [onClick]);

  return (
    <div>
      {processedData.map(item => (
        <Item key={item.id} onClick={() => handleClick(item)} />
      ))}
    </div>
  );
});

<Item key={item.id} onClick={() => handleClick(item)} />

React Compiler を使用する場合

メモ化なしで同じコードを書くことができます。

function ExpensiveComponent({ data, onClick }) {
  const processedData = expensiveProcessing(data);

  const handleClick = (item) => {
    onClick(item.id);
  };

  return (
    <div>
      {processedData.map(item => (
        <Item key={item.id} onClick={() => handleClick(item)} />
      ))}
    </div>
  );
}

React Compiler Playground でこの例を確認

React Compiler は最適なメモ化を自動で適用し、必要なときだけ再レンダーされるようにします。

function FriendList({ friends }) {
  const onlineCount = useFriendOnlineCount();
  if (friends.length === 0) {
    return <NoFriends />;
  }
  return (
    <div>
      <span>{onlineCount} online</span>
      {friends.map((friend) => (
        <FriendListCard key={friend.id} friend={friend} />
      ))}
      <MessageButton />
    </div>
  );
}

// **Not** memoized by React Compiler, since this is not a component or hook
function expensivelyProcessAReallyLargeArrayOfObjects() { /* ... */ }

// Memoized by React Compiler since this is a component
function TableContainer({ items }) {
  // This function call would be memoized:
  const data = expensivelyProcessAReallyLargeArrayOfObjects(items);
  // ...
}

コンパイラを試すべきか？

すべての方に React Compiler の使用を開始することをお勧めします。ココンパイラは現在は任意機能ですが、将来的には一部の機能を完全に動作させるためにコンパイラが必要になる可能性があります。

安全に使用できるか？

React Compiler は現在安定板であり、本番環境で広範囲にテストされています。Meta などの企業で本番環境で使用されていますが、あなたのアプリケーションでコンパイラを導入できるかどうかは、コードベースの健全性と React のルールをどの程度遵守しているかに依存します。

どのビルドツールがサポートされているか？

React Compiler は いくつかのビルドツール で利用できます。具体的には Babel、Vite、Metro、Rsbuild などが含まれます。

React Compiler は主に、コアコンパイラを囲む軽量な Babel プラグインラッパーです。これは Babel 自体から分離されるように設計されています。コンパイラの最初の安定版は主に Babel プラグインとして残りますが、swc と oxc チームと協力して、React Compiler のファーストクラスサポートを構築しており、将来的にビルドパイプラインに Babel を追加する必要がなくなります。

Next.js を使用しているユーザは、v15.3.1 以降のバージョンを利用することで、SWC 経由（swc‑invoked）の React Compiler を有効化できます。

useMemo、useCallback、React.memo をどう扱うべきか？

デフォルトでは、React Compiler はコードの分析結果とヒューリスティックに基づいてコードをメモ化します。ほとんどの場合このメモ化は、あなたが書くであろうものと同等か、それ以上に正確です。

ただし、場合によっては開発者がメモ化をより細かく制御する必要があるかもしれません。useMemo と useCallback フックは、React Compiler と併用して、どの値をメモ化するかを制御するための避難ハッチ (escape hatch) として使用し続けることができます。一般的なユースケースは、メモ化された値がエフェクトの依存値として使用される場合で、依存値が実質的に変化しないならエフェクトが繰り返し発火しないようにする、というものです。

新しいコードにおいては、メモ化をコンパイラに任せ、詳細な制御が必要な場合に useMemo/useCallback を使用することをお勧めします。

既存のコードの場合は、既存のメモ化をそのまま残すか（削除するとコンパイル出力が変わる可能性があります）、メモ化を削除する前に慎重にテストすることをお勧めします。

React Compiler を試す

このセクションでは、React Compiler の始め方と、プロジェクトで効果的に使用するための情報を提供します。

• インストール - React Compiler をインストールし、ビルドツール用に設定する
• React バージョン互換性 - React 17、18、19 のサポート
• 設定 - 特定のニーズに合わせてコンパイラをカスタマイズする
• 段階的な導入 - 既存のコードベースでコンパイラを段階的に展開する戦略
• デバッグとトラブルシューティング - コンパイラ使用時の問題の特定と修正
• ライブラリのコンパイル - コンパイルされたコードを配布するためのベストプラクティス
• API リファレンス - すべての設定オプションの詳細ドキュメント

追加情報

これらのドキュメントに加えて、コンパイラに関する追加情報や議論については React Compiler Working Group を確認することをお勧めします。