※本記事には広告(楽天アフィリエイト)リンクが含まれる場合があります。
「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>
);
}
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 を使うと、コンパイラが最適化できないコードを事前に検出できます。
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つを採用するだけで開発速度が大きく上がるでしょう。