※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。

「Reactのバージョンが19になったけど、何が変わったのかよくわからない」「useFormStateとuseActionStateが混乱する」「React Compilerって結局使えるの?」——React 19は2024年12月にリリースされ、フォーム処理の大幅改善・コンパイラによる自動最適化・Server Actionsの標準化など、個人開発に直結する変更が多数含まれています。

本記事ではReact 19の全主要機能を、コード例を交えて体系的に解説します。「何が変わったか」だけでなく「なぜ変わったか」「どう使うか」まで踏み込みます。Next.js 15・Remix・Astroなどのフレームワーク連携も取り上げます。

広告・楽天アフィリエイト

プログラミング技術書

実践寄りの技術書・参考書を探す。

楽天ポイント還元

技術書を楽天で見る →

React 19とは?リリースの背景

React 19は2024年12月にリリースされた、React史上最大の変更を含むメジャーバージョンです。フォーム・非同期処理の抜本的改善・React Compilerによる自動メモ化・Server Actionsの仕様化が柱です。

React 18まで「Pending状態をどう管理するか」「楽観的更新をどう実装するか」「フォームのローディング表示をどう出すか」はすべて開発者が手書きする必要がありました。React 19はこれらをフレームワーク不要でフックとして提供し、ボイラープレートを大幅削減しています。

主な変更点一覧

  • 新フック: useActionState・useFormStatus・useOptimistic・use()
  • React Compiler(旧React Forget)—— useMemo/useCallback の自動化
  • Server Actions の仕様標準化(Next.js/Remix等と連携)
  • ref を props として受け取れるよう変更(forwardRef 不要に)
  • <Context> を直接プロバイダとして使える
  • コンポーネント内で <title>・<meta> を直接書けるDocument Metadata
  • スタイルシート・スクリプトの宣言的ロード
  • エラーレポートの改善(hydration mismatch の詳細化)

1. useActionState — フォーム送信のボイラープレートを一掃

useActionState はReact 19最大の目玉です。「フォーム送信中のpending状態」「送信後のエラーメッセージ」「前回の状態の保持」を一つのフックにまとめます。React 18以前の useFormState(react-dom パッケージ)の後継で、react本体に移動されました。

React 18以前のパターン(冗長な例)

// React 18以前: 手書きの状態管理が必要
function LoginForm() {
  const [isPending, setIsPending] = useState(false);
  const [error, setError] = useState<string | null>(null);

  async function handleSubmit(e: React.FormEvent) {
    e.preventDefault();
    setIsPending(true);
    setError(null);
    const form = e.target as HTMLFormElement;
    const formData = new FormData(form);
    try {
      await loginAction(formData);
    } catch (err) {
      setError('ログインに失敗しました');
    } finally {
      setIsPending(false);
    }
  }

  return (
    <form onSubmit={handleSubmit}>
      {error && <p className="error">{error}</p>}
      <input name="email" />
      <button disabled={isPending}>
        {isPending ? '送信中...' : 'ログイン'}
      </button>
    </form>
  );
}

React 19: useActionState で簡潔に

import { useActionState } from 'react';

async function loginAction(
  prevState: { error: string | null },
  formData: FormData
) {
  const email = formData.get('email') as string;
  const password = formData.get('password') as string;

  const res = await fetch('/api/login', {
    method: 'POST',
    body: JSON.stringify({ email, password }),
    headers: { 'Content-Type': 'application/json' },
  });

  if (!res.ok) {
    return { error: 'メールアドレスまたはパスワードが正しくありません' };
  }
  return { error: null };
}

function LoginForm() {
  const [state, formAction, isPending] = useActionState(
    loginAction,
    { error: null }  // 初期状態
  );

  return (
    <form action={formAction}>
      {state.error && <p className="error">{state.error}</p>}
      <input name="email" type="email" />
      <input name="password" type="password" />
      <button type="submit" disabled={isPending}>
        {isPending ? '送信中...' : 'ログイン'}
      </button>
    </form>
  );
}

シグネチャは useActionState(action, initialState, permalink?)。戻り値は [state, formAction, isPending] の3要素タプルです。form action={formAction} に直接渡せるのがポイントで、onSubmit のラッパーが不要になります。

useActionState の重要な注意点

  • アクション関数の第1引数は「前回の状態(prevState)」、第2引数が FormData
  • アクションは 純粋なサーバーまたは非同期関数 として設計する(副作用は最小化)
  • React 18のreact-dom版 useFormState は非推奨になった(引数の順が異なるので注意)

2. useFormStatus — フォーム送信状態をどこからでも取得

useFormStatus は <form> の子コンポーネントから、親フォームの送信状態を取得するフックです。サブミットボタンを独立したコンポーネントに分離したいときに便利です。

import { useFormStatus } from 'react-dom';

// 再利用可能なサブミットボタンコンポーネント
function SubmitButton({ label = '送信' }: { label?: string }) {
  const { pending, data, method, action } = useFormStatus();

  return (
    <button type="submit" disabled={pending}>
      {pending ? (
        <><span className="spinner" /> 処理中...</>
      ) : (
        label
      )}
    </button>
  );
}

// 使い方: formの子要素として配置するだけ
function ContactForm() {
  const [state, formAction] = useActionState(contactAction, null);

  return (
    <form action={formAction}>
      <textarea name="message" />
      <SubmitButton label="メッセージを送る" />
    </form>
  );
}

useFormStatus が返すオブジェクトの主要フィールド:

  • pending: フォームが送信中かどうか(boolean)
  • data: 送信中の FormData(送信完了後は null)
  • method: "get" | "post"
  • action: form の action 属性値
注意: useFormStatus は react-dom からインポートします(react 本体ではない)。また、このフックを呼び出すコンポーネントは <form> の子孫である必要があります。兄弟や親では機能しません。

3. useOptimistic — 楽観的更新を宣言的に実装

楽観的更新(Optimistic UI)は「サーバーの応答を待たずにUIを即時更新し、エラー時に元に戻す」パターンです。SNSの「いいね」ボタンなどでよく使われますが、React 18では自前で実装するのが面倒でした。React 19の useOptimistic はこれを3行で実現します。

import { useOptimistic, useActionState } from 'react';

type Todo = { id: string; text: string; completed: boolean };

async function toggleTodoAction(
  todos: Todo[],
  formData: FormData
): Promise<Todo[]> {
  const id = formData.get('id') as string;
  // サーバーへのリクエスト(時間がかかる)
  await fetch(`/api/todos/${id}/toggle`, { method: 'POST' });
  // 実際のデータを返す
  return todos.map(t => t.id === id ? { ...t, completed: !t.completed } : t);
}

function TodoList({ initialTodos }: { initialTodos: Todo[] }) {
  const [todos, formAction] = useActionState(toggleTodoAction, initialTodos);

  // useOptimistic: 楽観的に更新したtodosを別に持つ
  const [optimisticTodos, addOptimisticTodo] = useOptimistic(
    todos,
    (currentTodos: Todo[], toggledId: string) =>
      currentTodos.map(t =>
        t.id === toggledId ? { ...t, completed: !t.completed } : t
      )
  );

  return (
    <ul>
      {optimisticTodos.map(todo => (
        <li key={todo.id} style={{ opacity: todo.completed ? 0.5 : 1 }}>
          <form action={formAction}>
            <input type="hidden" name="id" value={todo.id} />
            <button
              type="submit"
              onClick={() => addOptimisticTodo(todo.id)}
            >
              {todo.completed ? '✅' : '⬜'} {todo.text}
            </button>
          </form>
        </li>
      ))}
    </ul>
  );
}

useOptimistic(state, updateFn) のポイント:

  • 第1引数: ベースとなる実際のstate
  • 第2引数: 楽観的更新を適用する関数((currentState, optimisticValue) => newState)
  • 非同期処理が完了すると自動的に実際のstateに切り替わる
  • エラー時も自動的にロールバック

4. use() フック — Promise と Context を統一的に扱う

use() は「Promiseを同期的に読む」「Contextを読む」の両方ができる新しいフックです。通常のフックと異なり、条件分岐やループの中でも呼び出せるのが最大の特徴です。

Promiseを読む

import { use, Suspense } from 'react';

type User = { id: string; name: string; email: string };

async function fetchUser(id: string): Promise<User> {
  const res = await fetch(`/api/users/${id}`);
  return res.json();
}

// コンポーネント内でPromiseを直接読む
function UserCard({ userPromise }: { userPromise: Promise<User> }) {
  const user = use(userPromise);  // Suspenseと連携して自動的に待機
  return (
    <div>
      <h2>{user.name}</h2>
      <p>{user.email}</p>
    </div>
  );
}

// Suspenseで囲む必要がある
function App() {
  const userPromise = fetchUser('123');
  return (
    <Suspense fallback={<p>読み込み中...</p>}>
      <UserCard userPromise={userPromise} />
    </Suspense>
  );
}

条件分岐内でContextを読む

import { use, createContext } from 'react';

const ThemeContext = createContext<'light' | 'dark'>('light');

function ThemedButton({ show }: { show: boolean }) {
  // 通常のuseContextと違い、条件分岐内でも呼べる
  if (!show) return null;

  const theme = use(ThemeContext);  // ← 条件分岐の後でOK
  return (
    <button className={`btn btn-${theme}`}>
      クリック
    </button>
  );
}
use() vs useContext: 通常の Context 読み取りは引き続き useContext で問題ありません。use() は「条件分岐の内側でContextを読みたい」「Promiseを直接読みたい」という特殊ケース向けです。

5. React Compiler — useMemo/useCallback が不要になる

React Compiler(旧React Forget)はReact 19と同時期にBetaとしてリリースされたコンパイラです。ビルド時に自動的にメモ化最適化を行うため、useMemo・useCallback・React.memo を手書きする必要がなくなります。

導入方法(Next.js 15の場合)

// next.config.ts
import type { NextConfig } from 'next';

const nextConfig: NextConfig = {
  experimental: {
    reactCompiler: true,
  },
};

export default nextConfig;

Vite / Babel プロジェクトの場合

npm install -D babel-plugin-react-compiler
// babel.config.js
module.exports = {
  plugins: [
    ['babel-plugin-react-compiler', {}],
  ],
};

コンパイラが自動最適化する例

// 書く前: 手動でuseMemoを書く必要があった
function ProductList({ products, filter }: Props) {
  const filteredProducts = useMemo(
    () => products.filter(p => p.category === filter),
    [products, filter]
  );
  const handleClick = useCallback((id: string) => {
    console.log('clicked:', id);
  }, []);

  return filteredProducts.map(p => (
    <ProductCard key={p.id} product={p} onClick={handleClick} />
  ));
}

// 書いた後: React Compilerが自動でメモ化してくれる
function ProductList({ products, filter }: Props) {
  const filteredProducts = products.filter(p => p.category === filter);
  const handleClick = (id: string) => console.log('clicked:', id);

  return filteredProducts.map(p => (
    <ProductCard key={p.id} product={p} onClick={handleClick} />
  ));
}

React Compilerが適用できる条件は「Reactのルール(純粋な関数・参照の安定性)に従っていること」です。eslint-plugin-react-compiler を使うと、コンパイラが最適化できないコードを事前に検出できます。

2026年時点の状況: React CompilerはStable版でも多くのプロジェクトで安定動作しています。ただし、副作用の多いコードやReactのルールに違反するコードは自動最適化の対象外になります。既存プロジェクトに導入する場合はESLintプラグインで検証してから適用することを推奨します。

6. Server Actions — サーバー関数を直接呼び出す

Server ActionsはもともとNext.js App Routerが独自に実装していた機能ですが、React 19でフレームワーク横断の仕様として標準化されました。'use server' ディレクティブをつけた関数を、クライアントから直接呼び出せます。

// actions/user.ts
'use server';

import { db } from '@/lib/db';
import { revalidatePath } from 'next/cache';

export async function updateUsername(
  prevState: { error: string | null },
  formData: FormData
) {
  const username = formData.get('username') as string;

  if (username.length < 3) {
    return { error: 'ユーザー名は3文字以上必要です' };
  }

  await db.user.update({
    where: { id: getCurrentUserId() },
    data: { username },
  });

  revalidatePath('/profile');
  return { error: null };
}
// components/UsernameForm.tsx
'use client';

import { useActionState } from 'react';
import { updateUsername } from '@/actions/user';

export function UsernameForm() {
  const [state, formAction, isPending] = useActionState(
    updateUsername,
    { error: null }
  );

  return (
    <form action={formAction}>
      {state.error && <p className="error">{state.error}</p>}
      <input name="username" placeholder="新しいユーザー名" />
      <button type="submit" disabled={isPending}>
        {isPending ? '更新中...' : '更新'}
      </button>
    </form>
  );
}

Server Actionsを使うと「API Routes を作成してfetchする」という手順が不要になり、フォームとサーバーロジックが直結します。型推論も自動で機能するため、型安全性も向上します。

7. ref as props — forwardRef が不要に

React 18では、コンポーネントに ref を渡すには forwardRef でラップする必要がありました。React 19では ref を通常の props として受け取れるようになり、このラッパーが不要になりました。

// React 18: forwardRefが必要だった
const Input = forwardRef<HTMLInputElement, InputProps>(
  ({ label, ...props }, ref) => (
    <div>
      <label>{label}</label>
      <input ref={ref} {...props} />
    </div>
  )
);

// React 19: refをpropsとして受け取るだけ
function Input({ label, ref, ...props }: InputProps & { ref?: React.Ref<HTMLInputElement> }) {
  return (
    <div>
      <label>{label}</label>
      <input ref={ref} {...props} />
    </div>
  );
}

// 使う側は変わらない
function App() {
  const inputRef = useRef<HTMLInputElement>(null);
  return <Input label="名前" ref={inputRef} />;
}

既存の forwardRef は引き続き動作します(非推奨ですが削除されていません)。新規コードでは ref をpropsとして受け取るシンプルな書き方を採用することを推奨します。

8. Context プロバイダの省略記法

React 19では、Context.Provider を省略して Context を直接プロバイダとして使えるようになりました。

const ThemeContext = createContext<'light' | 'dark'>('light');

// React 18: <ThemeContext.Provider> が必要
function App() {
  return (
    <ThemeContext.Provider value="dark">
      <Layout />
    </ThemeContext.Provider>
  );
}

// React 19: <ThemeContext> で直接囲める
function App() {
  return (
    <ThemeContext value="dark">
      <Layout />
    </ThemeContext>
  );
}

小さな変更ですが、Contextを多用するプロジェクトではコードがスッキリします。ThemeContext.Provider 形式も引き続き動作します。

9. Document Metadata — コンポーネントから <title> や <meta> を直接書く

React 19では、コンポーネント内に <title>・<meta>・<link> を書くと、自動的に <head> に移動されます。react-helmetなどの外部ライブラリが不要になります。

function ArticlePage({ article }: { article: Article }) {
  return (
    <div>
      {/* これらは自動的に <head> に移動される */}
      <title>{article.title} | TechTools Lab</title>
      <meta name="description" content={article.excerpt} />
      <meta property="og:title" content={article.title} />
      <link rel="canonical" href={`/articles/${article.slug}`} />

      {/* 通常のコンテンツ */}
      <article>
        <h1>{article.title}</h1>
        <div dangerouslySetInnerHTML={{ __html: article.html }} />
      </article>
    </div>
  );
}

SSRでもSSGでもCSRでも同じ書き方で動作します。Next.jsの generateMetadata はさらに高機能ですが、シンプルなケースではコンポーネント内直書きが手軽です。

10. スタイルシートとスクリプトの宣言的ロード

React 19では、コンポーネント内でスタイルシートやスクリプトを宣言的に読み込むAPIが追加されました。同じリソースを複数回宣言しても自動的に重複排除されます。

import { preinit, preload, prefetchDNS } from 'react-dom';

function HeavyChart() {
  // チャートライブラリのスクリプトを事前に読み込む
  preinit('https://cdn.example.com/chart.js', { as: 'script' });
  // スタイルシートも宣言的に読み込める
  preinit('https://cdn.example.com/chart.css', { as: 'style' });

  return <canvas id="chart" />;
}

// 同じURLを複数コンポーネントで宣言しても重複しない
function App() {
  return (
    <>
      <HeavyChart />
      <HeavyChart />  {/* 2回目は無視される */}
    </>
  );
}

エラーハンドリングの改善

React 19ではエラーレポートが大幅に改善されました。特にハイドレーションミスマッチのエラーメッセージが詳細になり、「どこで差異が生じているか」がひと目でわかるようになりました。

// React 18のエラー
// Error: Hydration failed because the initial UI does not match
// what was rendered on the server.

// React 19のエラー(詳細)
// Warning: Expected server HTML to contain a matching <div> in <div>.
//
// Diff:
// + Client rendered: <div class="mobile-only">
// - Server rendered: (nothing)
//
// Likely cause: このコンポーネントはwindowオブジェクトにアクセスしています。
// 解決策: useEffectでクライアント専用ロジックをラップしてください。

広告・楽天アフィリエイト

ガジェット・オーディオ

イヤホン・便利ガジェットをポイント還元で。

楽天ポイント還元

ガジェットを楽天で見る →

React 18 → 19 移行ガイド

ステップ1: パッケージ更新

npm install react@19 react-dom@19
npm install -D @types/react@19 @types/react-dom@19

ステップ2: 破壊的変更の確認

React 19の主な破壊的変更(影響の大きいもの):

  • propTypes / defaultProps 削除: クラスコンポーネントの propTypes と defaultProps(関数コンポーネント用)は削除。TypeScriptの型で代替。
  • Legacy Context API 削除: contextTypes・childContextTypes は削除。createContext に移行。
  • string refs 削除: ref="myRef" 形式は削除。useRef に移行。
  • ReactDOM.render 削除: React 18で非推奨になった ReactDOM.render は完全削除。createRoot に移行。
  • useFormState → useActionState: react-domの useFormState は非推奨(引数の順が異なる)。

ステップ3: React Compiler を段階的に導入

// 特定のコンポーネントだけコンパイラを無効化したい場合
function LegacyComponent() {
  "use no memo";  // このコンポーネントはコンパイラ対象外に
  // ...既存のuseMemo/useCallbackのあるロジック
}

ステップ4: codemods で自動変換

# React公式のcodemodツール
npx react-codemod v19/migration-guide

# forwardRefをpropsのrefに変換
npx react-codemod v19/replace-use-form-state

フレームワーク別対応状況(2026年10月時点)

フレームワーク React 19 Server Actions React Compiler
Next.js 15+ ✅ デフォルト ✅ 標準サポート ✅ experimental フラグで有効化
Remix / React Router v7 ✅ 対応済み ✅ loaders/actions ✅ 対応済み
Vite + React ✅ 対応済み ⚠️ 別途設定必要 ✅ Babelプラグインで有効化
Astro ✅ 4.x以降 ✅ Astro Actions ✅ 対応済み
Create React App ❌ 非推奨・メンテ停止 ❌ ❌

実践: React 19 で作るTODOアプリ(フル実装例)

React 19の新機能を組み合わせたTODOアプリの完全実装例です。

// app/actions/todos.ts
'use server';

import { revalidatePath } from 'next/cache';
import { db } from '@/lib/db';

export async function addTodo(
  prevState: { error: string | null },
  formData: FormData
) {
  const text = formData.get('text') as string;
  if (!text.trim()) return { error: 'タスクを入力してください' };

  await db.todo.create({ data: { text, completed: false } });
  revalidatePath('/todos');
  return { error: null };
}

export async function toggleTodo(id: string) {
  const todo = await db.todo.findUnique({ where: { id } });
  await db.todo.update({
    where: { id },
    data: { completed: !todo?.completed },
  });
  revalidatePath('/todos');
}
// app/todos/page.tsx (Server Component)
import { db } from '@/lib/db';
import { TodoList } from '@/components/TodoList';

export default async function TodosPage() {
  const todos = await db.todo.findMany({ orderBy: { createdAt: 'desc' } });
  return <TodoList initialTodos={todos} />;
}
// components/TodoList.tsx (Client Component)
'use client';

import { useActionState, useOptimistic } from 'react';
import { addTodo, toggleTodo } from '@/app/actions/todos';

type Todo = { id: string; text: string; completed: boolean };

function AddTodoForm() {
  const [state, formAction, isPending] = useActionState(addTodo, { error: null });

  return (
    <form action={formAction} style={{ display: 'flex', gap: '8px', marginBottom: '1rem' }}>
      {state.error && <p style={{ color: 'red' }}>{state.error}</p>}
      <input
        name="text"
        placeholder="新しいタスクを入力..."
        style={{ flex: 1, padding: '8px' }}
      />
      <button type="submit" disabled={isPending}>
        {isPending ? '追加中...' : '追加'}
      </button>
    </form>
  );
}

export function TodoList({ initialTodos }: { initialTodos: Todo[] }) {
  const [optimisticTodos, addOptimistic] = useOptimistic(
    initialTodos,
    (todos: Todo[], toggledId: string) =>
      todos.map(t => t.id === toggledId ? { ...t, completed: !t.completed } : t)
  );

  return (
    <div>
      <title>TODOリスト</title>  {/* React 19: headに自動移動 */}
      <AddTodoForm />
      <ul style={{ listStyle: 'none', padding: 0 }}>
        {optimisticTodos.map(todo => (
          <li
            key={todo.id}
            style={{
              display: 'flex',
              alignItems: 'center',
              gap: '8px',
              padding: '8px 0',
              opacity: todo.completed ? 0.5 : 1,
            }}
          >
            <input
              type="checkbox"
              checked={todo.completed}
              onChange={async () => {
                addOptimistic(todo.id);  // 楽観的に更新
                await toggleTodo(todo.id);
              }}
            />
            <span style={{ textDecoration: todo.completed ? 'line-through' : 'none' }}>
              {todo.text}
            </span>
          </li>
        ))}
      </ul>
    </div>
  );
}

まとめ: React 19で何が変わるか

React 19の変更を一言でまとめると「フォーム処理と非同期の定形コードをReact本体が吸収した」です。

課題 React 18まで React 19
フォームのローディング状態 useState + try/catch useActionState(isPendingが自動)
サブミットボタンのdisabled props でisPendingを渡す useFormStatusで親から取得
楽観的UI更新 手動でロールバック処理 useOptimistic(自動ロールバック)
メモ化最適化 useMemo/useCallback手書き React Compilerが自動生成
refの転送 forwardRefでラップ必須 refをpropsとして受け取るだけ
ページのtitle/meta react-helmetなど外部ライブラリ コンポーネント内に直接書く

React 19への移行は既存コードの多くが動作しますが、破壊的変更も複数あります。新規プロジェクトはReact 19を選ぶ理由しかなく、既存プロジェクトは段階的にcodemodを使って移行するのがベストプラクティスです。

特に useActionState + Server Actions の組み合わせは、フォーム処理のボイラープレートを劇的に削減します。個人開発・小規模SaaSでは最初にこの2つを採用するだけで開発速度が大きく上がるでしょう。