本線を書き終えたあと、実際に自分でフォームを1つ作りました。名前とメールアドレスを入れて、送信ボタンを押すだけのものです。
これは深掘りです。本線の順路ではありません。 本線のコンポーネントとpropsの回で「状態は、他から計算できないものだけ持つ」と分かった人が、それでも状態が5個6個に増えて、画面がおかしくなり始めたところで読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて VM(Ubuntu Server)の中で打ちます。 Windows の PowerShell ではありません。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った
~/react-demo/には触りません。 この記事では、まっさらな~/reactlab/を新しく作ります。
書き上がった時点で、useState が6個並んでいました。 そして、テストしていたらこの画面が出ました。
送信中…
エラー: メールアドレスの形式が正しくありません
両方、同時に出ています。 送信中なのに、エラーも出ている。そんな状態は、現実には存在しません。
原因は分かりました。2回目に送信するとき、前のエラーを消し忘れていただけです。setError(null) を1行足せば直ります。
ですが、そこで止めたのが間違いでした。 1行足したあと、「もう一度送信する」ボタンを付けたら、同じことがもう1回起きました。
消し忘れたのが悪いのではありません。 消し忘れられる形で状態を持っていたことが問題です。
この記事は、その話をします。同じフォームを useState 版と useReducer 版の2通りで作り、並べて比べます。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- フックを
ifの中で呼んではいけないのは、行儀の問題ではないこと。React はフックを名前で覚えておらず、呼ばれた順番だけで覚えているので、順番が変わると前回の別の state が返ってくる - 関連する値を別々の
useStateで持つと、「あり得ない組み合わせ」が作れてしまうこと。3つのuseStateは8通りの状態を表現でき、そのうち意味があるのは4通りだけ - reducer は「いまの状態 + 起きたこと → 次の状態」を返すだけの純粋関数であること。React も画面も出てこないので、そのまま単体テストが書ける
useState(重い計算())の初期値は、毎回の再レンダリングで実際に計算されること。結果は捨てられるのに、計算だけは走るsetCount(count + 1)を2回書いても、2つは進まないこと。前の値に依存するときは関数型更新が必須であること
この記事でやること
~/reactlab/を新しく作り、本線の~/react-demo/とは別のポートで動かすuseStateをわざとifの中に入れて壊し、React が出す実際のエラー文と、eslint-plugin-react-hooksが止めてくれることを確認するuseState6個で会員登録フォームを作り、「送信中なのにエラーも出ている」画面を自分の手で再現する- 同じフォームを
useReducerで書き直し、その組み合わせが作れなくなることを確かめる useStateの初期値が毎回評価されることをconsole.timeで実測し、遅延初期化で消す- reducer の単体テストを1本書いて、
node --testで走らせる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| フック(hook) | use で始まる React の関数。コンポーネントに「記憶」や「外との接続」を持たせる |
| フックの規則(Rules of Hooks) | コンポーネントのトップレベルでだけ呼ぶ、毎回同じ順番で同じ数だけ呼ぶ、という2つの決まり |
| 純粋関数 | 同じ引数を渡せば、必ず同じ結果を返し、外の世界を書き換えない関数。時刻も乱数も通信も使わない |
| reducer | (いまの状態, action) => 次の状態 という形の純粋関数 |
| action | 「何が起きたか」を表すただのオブジェクト。{ type: "submitted" } のような形 |
dispatch | action を reducer に届ける関数。「これが起きました」と報告する係 |
| あり得ない状態(impossible state) | プログラム上は作れるのに、現実には存在しない状態の組み合わせ。「送信中かつエラー」など |
| 遅延初期化(lazy initializer) | useState(値) ではなく useState(() => 値) と書き、初期値の計算を最初の1回だけに限る書き方 |
| 関数型更新 | setX(新しい値) ではなく setX((前の値) => 新しい値) と書く更新のしかた |
| StrictMode | 開発中だけ、わざと2回レンダリングして問題を炙り出すReact の仕組み。本番では動かない |
① 準備 — reactlab を新しく作る
本線で作った ~/react-demo/ は、そのまま残します。 この記事はまっさらなプロジェクトでやります。壊す手順があるからです。
VMの中で、ホームディレクトリに戻って作ります。
質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。
eslint.config.js index.html package.json public README.md src vite.config.js
この一覧が出れば成功です。 npm install は初回だけ数分かかります。何が起きているかはnpmの回、dist/ が何なのかはビルドツールの回にあります。
ポートを開ける
本線で 5173番を使っています。 ぶつからないように、この記事は 5174番でやります。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5174/tcp ALLOW Anywhere
5174/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。
起動する
ホストの Windows のブラウザで http://192.168.226.50:5174/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。Vite のロゴとカウンターが出れば成功です。
止め方: ターミナルで Ctrl+C。この記事の間は起動したままで構いません。 保存するたびにブラウザが自動で更新されます。
[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5174 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5174 になっているのが見える形で。
eslint が入っていることを確認する
Vite の React テンプレートには、最初から eslint と eslint-plugin-react-hooks が入っています。 後で使うので、いま動くことだけ確かめます。
別のターミナル(VS Code のターミナルをもう1枚開くのが楽です)で打ちます。
何も出力されずにプロンプトが戻れば、問題ゼロという意味です。 eslint そのものの話はESLintとPrettierの回にあります。
eslint.config.jsが無い、と言われたときは、Vite の版が古い可能性があります。この記事の eslint の確認だけ飛ばしてください。 本筋(フックの規則)は、eslint が無くても React 本体がエラーで教えてくれます。
② フックの規則 — なぜ「トップレベルだけ」なのか
先に規則を書きます。2つだけです。
1. フックは、コンポーネント関数のトップレベルでだけ呼ぶ。
ifの中、forの中、returnより後、普通の関数の中では呼ばない
2. 毎回のレンダリングで、同じフックを同じ順番で、同じ数だけ呼ぶ。
「なぜ?」に答えられないと、この規則は必ず破ります。 理由はこれです。
React は、フックを名前で覚えていません。
useState("たろう")と書いても、React 側に「name」という情報は1文字も渡っていません。 React が持っているのは、そのコンポーネント1つにつき「フックの並び」1本だけです。1個目、2個目、3個目……という順番だけで、どの state かを決めています。
つまり、こう対応しています。
function Profile() {
const [name, setName] = useState("たろう"); // ← React の中では「1個目」
const [age, setAge] = useState(20); // ← 「2個目」
const [city, setCity] = useState("東京"); // ← 「3個目」
}
| React が持っている並び | 中身 |
|---|---|
| 1個目 | "たろう" |
| 2個目 | 20 |
| 3個目 | "東京" |
2回目のレンダリングで、もし2個目が呼ばれなかったら? 3個目だったはずの useState が「2個目」として扱われ、city に 20 が入ります。 名前で照合していないので、React には中身の取り違えは分かりません。 ただしこの例のように数が減ったときは、最後に Rendered fewer hooks than expected. のエラーで止まります。黙って別の値のまま動いてしまうのは、数は同じで順番だけが入れ替わる書き方です。
これが「順番が変わってはいけない」の中身です。 では、実際に壊します。
壊す — if の中に useState を入れる
src/components/ を作って、ファイルを1つ置きます。
src/components/HookOrder.jsx(新規)
import { useState } from "react";
function HookOrder() {
const [showNote, setShowNote] = useState(false);
// ここが規則違反です。わざとやっています
if (showNote) {
const [note, setNote] = useState("メモです");
console.log(note, setNote);
}
const [name, setName] = useState("たろう");
return (
<div className="card">
<h2>フックの規則をわざと破る</h2>
<p>名前: {name}</p>
<button onClick={() => setName(name === "たろう" ? "はなこ" : "たろう")}>
名前を切り替える
</button>
<button onClick={() => setShowNote(true)}>メモを出す(壊れます)</button>
</div>
);
}
export default HookOrder;
src/App.jsx(丸ごと置き換え)
import HookOrder from "./components/HookOrder.jsx";
function App() {
return (
<div className="app">
<HookOrder />
</div>
);
}
export default App;
src/index.css(丸ごと置き換え)
body {
margin: 0;
font-family: system-ui, sans-serif;
background: #f5f5f5;
color: #222;
}
.app {
max-width: 640px;
margin: 2rem auto;
padding: 1rem;
}
.card {
background: #fff;
border: 1px solid #ddd;
border-radius: 8px;
padding: 1rem 1.25rem;
margin-bottom: 1rem;
}
label {
display: block;
margin: 0.5rem 0;
}
input[type="text"],
input[type="email"] {
width: 100%;
padding: 0.4rem;
box-sizing: border-box;
}
button {
margin-right: 0.5rem;
padding: 0.4rem 0.8rem;
}
.info { color: #0b5; font-weight: bold; }
.error { color: #c22; font-weight: bold; }
.ok { color: #06c; font-weight: bold; }
実際に押す
ブラウザで確かめます。
- まず「名前を切り替える」を数回押してください。 問題なく動きます。
showNoteがfalseのままなので、フックの数は毎回2個で変わっていません - 次に「メモを出す(壊れます)」を押します。
画面が真っ赤(または真っ白)になり、ブラウザの Console にこう出ます。
Uncaught Error: Rendered more hooks than during the previous render.
「前回のレンダリングより、フックの数が増えた」と、React が名指しで言っています。規則を破ると、React は黙って間違った値を返すのではなく、はっきり止まります。
[スクリーンショット: 02_フック規則のエラー.png] 「メモを出す」を押した直後の画面を撮ってください。Vite のエラー画面か、F12 の Console に Rendered more hooks than during the previous render. が出ているところを。
なぜ「増えた」場合はエラーになるのに、危ないのか。 数は同じで順番だけが入れ替わる書き方だと、エラーにならず黙って別の値を返すことがあるからです(減った場合は
Rendered fewer hooks than expected.で止まります)。 今回のように「あとから増える」書き方は、たまたま React が気づける形でした。 気づけない書き方も普通に書けます。 だから規則で禁止しています。
eslint が、押す前に止めてくれる
画面を出して押すまで気づけないのでは遅すぎます。 先ほど確認した eslint を、この状態で走らせます。
/home/ユーザー名/reactlab/src/components/HookOrder.jsx
7:31 error React Hook "useState" is called conditionally. React Hooks must be
called in the exact same order in every component render
react-hooks/rules-of-hooks
✖ 1 problem (1 error, 0 warnings)
react-hooks/rules-of-hooks が、行番号つきで止めました。 メッセージも「すべてのレンダリングで、まったく同じ順番で呼ばれなければならない」と、理由まで書いてあります。
この規則は、機械が完全に検査できます。 だから eslint を入れておけば、この種のバグは実質ゼロになります。
直す
if の中から出せば直ります。 HookOrder.jsx の違反部分を、こう書き換えてください。
import { useState } from "react";
function HookOrder() {
const [showNote, setShowNote] = useState(false);
const [note] = useState("メモです"); // ← トップレベルに出した
const [name, setName] = useState("たろう");
return (
<div className="card">
<h2>フックの規則</h2>
<p>名前: {name}</p>
{showNote && <p>{note}</p>}
<button onClick={() => setName(name === "たろう" ? "はなこ" : "たろう")}>
名前を切り替える
</button>
<button onClick={() => setShowNote(!showNote)}>メモを出す / 隠す</button>
</div>
);
}
export default HookOrder;
フックは必ず呼び、出すか出さないかは JSX 側の && で切り替える。 これが型です。
確認: npx eslint src が無言で戻り、ブラウザでどちらのボタンを何度押しても壊れなければ成功です。画面が真っ赤なままのときは、ブラウザを一度リロードしてください。(後述の「つまずいたところ」)
③ 関連する state がバラバラだと、矛盾する
ここからが本題です。 会員登録フォームを、まず素直に useState だけで作ります。
送信先のかわり(偽のAPI)
サーバーはまだ用意しません。 800ミリ秒待ってから成功か失敗を返すだけの関数を置きます。
src/api.js(新規)
// 本物のサーバーの代わり。800ミリ秒待ってから、成功か失敗を返すだけ
export function fakeSignup({ name, email }) {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (!email.includes("@")) {
reject(new Error("メールアドレスの形式が正しくありません"));
} else {
resolve({ id: 1, name });
}
}, 800);
});
}
@ が入っていなければ必ず失敗します。 好きなときに失敗させられる、というのが大事な点です。
useState 版のフォーム
src/components/SignupFormState.jsx(新規)
import { useState } from "react";
import { fakeSignup } from "../api.js";
function SignupFormState() {
const [name, setName] = useState("");
const [email, setEmail] = useState("");
const [agreed, setAgreed] = useState(false);
const [isLoading, setIsLoading] = useState(false);
const [error, setError] = useState(null);
const [result, setResult] = useState(null);
const handleSubmit = async (e) => {
e.preventDefault();
setIsLoading(true);
try {
const r = await fakeSignup({ name, email });
setResult(r);
} catch (err) {
setError(err.message);
} finally {
setIsLoading(false);
}
};
return (
<form className="card" onSubmit={handleSubmit}>
<h2>useState 版</h2>
<label>
名前
<input type="text" value={name} onChange={(e) => setName(e.target.value)} />
</label>
<label>
メールアドレス
<input type="email" value={email} onChange={(e) => setEmail(e.target.value)} />
</label>
<label>
<input
type="checkbox"
checked={agreed}
onChange={(e) => setAgreed(e.target.checked)}
/>
規約に同意する
</label>
<button type="submit" disabled={isLoading || !agreed}>送信</button>
{isLoading && <p className="info">送信中…</p>}
{error && <p className="error">エラー: {error}</p>}
{result && <p className="ok">{result.name} さんを登録しました</p>}
</form>
);
}
export default SignupFormState;
src/App.jsx(丸ごと置き換え)
import SignupFormState from "./components/SignupFormState.jsx";
function App() {
return (
<div className="app">
<SignupFormState />
</div>
);
}
export default App;
useState が6個並びました。 ここまでは、誰が書いてもこうなります。間違ってはいません。
矛盾を、手で作る
ブラウザで、この順番どおりに操作してください。
- 名前に
たろう、メールアドレスにabc(@なし)と入れる - 「規約に同意する」にチェックを入れる
- 「送信」を押す → 800ミリ秒後に
エラー: メールアドレスの形式が正しくありませんが出る - メールアドレスを
taro@example.comに直す - もう一度「送信」を押す
5の直後、800ミリ秒のあいだ、画面はこうなります。
送信中…
エラー: メールアドレスの形式が正しくありません
両方、同時に出ています。
[スクリーンショット: 03_矛盾した状態.png] 「送信中…」と「エラー: …」が同時に出ている瞬間を撮ってください。800ミリ秒しかないので、押した直後に素早く。 難しければ api.js の 800 を 5000 に変えると余裕ができます(撮り終わったら 800 に戻してください)。
何が起きているのか
handleSubmit が setError(null) を呼んでいないからです。error は、前回入った値を持ったままです。
「なるほど、1行足せばいい」で終わらせません。 数えます。
isLoading | error | result | 意味があるか |
|---|---|---|---|
| false | null | null | ✅ まだ何もしていない |
| true | null | null | ✅ 送信中 |
| false | あり | null | ✅ 失敗した |
| false | null | あり | ✅ 成功した |
| true | あり | null | ❌ 送信中なのにエラー(いま出したもの) |
| true | null | あり | ❌ 送信中なのに成功済み |
| false | あり | あり | ❌ 失敗と成功が同時 |
| true | あり | あり | ❌ 全部同時 |
2 × 2 × 2 = 8通り。意味があるのは4通り。残りの4通りは、現実には存在しない状態です。 そして、その4通りは「バグ」ではなく、いま書いたコードが正式に表現できる状態です。
問題を、正確に言い直します。
setError(null)を書き忘れたことが問題なのではありません。 「書き忘れる」という操作が可能な形で状態を持っていることが問題です。
setError(null) を足せば、いまの症状は消えます。 ですが、
- 「もう一度送信する」ボタンを足したら、そこでも消す必要があります
- 「入力し直したらエラーを消す」を足したら、そこでも必要です
足すたびに、書き忘れる場所が1つ増えます。 これは、注意力で解決する種類の問題ではありません。
④ 同じフォームを useReducer で書き直す
答えは「3つの真偽値をやめて、1つの状態名にする」です。
isLoading/error/resultは、独立した3つの事実ではありません。 「いま、このフォームがどの段階にいるか」という、1つの事実の別々の見え方です。
段階は4つしかありません。
idle(まだ何もしていない) → submitting(送信中) → success(成功) / error(失敗)
この4つを1つの status に持てば、「送信中かつエラー」は書きようがなくなります。 文字列は1つしか入らないからです。
reducer とは何か
reducer は、この形の関数です。
function reducer(いまの状態, action) {
return 次の状態;
}
これだけです。 React も、画面も、通信も出てきません。 値を受け取って、値を返すだけです。
そして、この関数は純粋関数でなければいけません。
| 守ること | 意味 |
|---|---|
| 同じ引数なら、必ず同じ結果 | 中で Date.now() や Math.random() を使わない |
| 外を書き換えない | 通信しない、localStorage を触らない、console.log 以外の副作用を持たない |
| 引数を書き換えない | state.name = ... と直接代入しない。必ず新しいオブジェクトを返す |
この3つを守ると、あとで見るように「そのままテストできる関数」になります。
src/formReducer.js(新規)
export const initialState = {
name: "",
email: "",
agreed: false,
status: "idle", // idle | submitting | success | error
error: null,
result: null,
};
export function formReducer(state, action) {
switch (action.type) {
case "changed":
return { ...state, [action.field]: action.value };
case "submitted":
return { ...state, status: "submitting", error: null, result: null };
case "succeeded":
return { ...state, status: "success", error: null, result: action.result };
case "failed":
return { ...state, status: "error", error: action.message, result: null };
case "reset":
return initialState;
default:
throw new Error("知らない action.type です: " + action.type);
}
}
読むべき点が4つあります。
"submitted"の1行で、statusとerrorとresultが同時に決まります。 「送信を始めたら、前のエラーは消える」が、書き忘れようのない場所に1回だけ書かれました"failed"はresultをnullにします。 「失敗と成功が同時」も、ここで閉じました[action.field]: action.valueは「計算されたプロパティ名」です。action.fieldが"name"ならnameを、"email"ならemailを差し替えます。 入力欄が10個に増えても、この1行のままですdefaultでthrowするのは、わざとです。"submited"と打ち間違えたとき、黙って何も起きないのが一番困ります。 画面が赤くなるほうが100倍ましです
action.typeを「submitted(過去形)」にしているのは理由があります。"submit"だと「送信しろ」という命令に読めます。 ですが dispatch が伝えているのは 「送信が始まった、という出来事」 です。それをどう state に反映するかを決めるのは reducer 側です。 命令ではなく報告。 本線の回の「子は出来事を報告するだけ」と、まったく同じ考え方です。
src/components/SignupFormReducer.jsx(新規)
import { useReducer, useRef } from "react";
import { formReducer, initialState } from "../formReducer.js";
import { fakeSignup } from "../api.js";
function SignupFormReducer() {
const [state, dispatch] = useReducer(formReducer, initialState);
const { name, email, agreed, status, error, result } = state;
// dispatch が毎回同じ関数かどうかを確かめるための仕掛け
const firstDispatch = useRef(dispatch);
console.log("dispatch は初回と同じ関数か:", firstDispatch.current === dispatch);
const change = (field) => (e) =>
dispatch({
type: "changed",
field,
value: e.target.type === "checkbox" ? e.target.checked : e.target.value,
});
const handleSubmit = async (e) => {
e.preventDefault();
dispatch({ type: "submitted" });
try {
const r = await fakeSignup({ name, email });
dispatch({ type: "succeeded", result: r });
} catch (err) {
dispatch({ type: "failed", message: err.message });
}
};
return (
<form className="card" onSubmit={handleSubmit}>
<h2>useReducer 版</h2>
<label>
名前
<input type="text" value={name} onChange={change("name")} />
</label>
<label>
メールアドレス
<input type="email" value={email} onChange={change("email")} />
</label>
<label>
<input type="checkbox" checked={agreed} onChange={change("agreed")} />
規約に同意する
</label>
<button type="submit" disabled={status === "submitting" || !agreed}>
送信
</button>
<button type="button" onClick={() => dispatch({ type: "reset" })}>
最初から
</button>
<p>いまの status: <code>{status}</code></p>
{status === "submitting" && <p className="info">送信中…</p>}
{status === "error" && <p className="error">エラー: {error}</p>}
{status === "success" && <p className="ok">{result.name} さんを登録しました</p>}
</form>
);
}
export default SignupFormReducer;
並べて見る
src/App.jsx(丸ごと置き換え)
import SignupFormState from "./components/SignupFormState.jsx";
import SignupFormReducer from "./components/SignupFormReducer.jsx";
function App() {
return (
<div className="app">
<h1>同じフォームを2通りで</h1>
<SignupFormState />
<SignupFormReducer />
</div>
);
}
export default App;
ブラウザで、③とまったく同じ操作を、下の「useReducer 版」でやってください。
- メールに
abcを入れて、同意にチェックして送信 →エラー: …、statusはerror - メールを
taro@example.comに直して、もう一度送信
今度は「送信中…」だけが出ます。 エラーは消えています。
[スクリーンショット: 04_reducer版.png] 上下に2つのフォームが並んでいる画面を撮ってください。下の useReducer 版で いまの status: submitting が出ているところが見えると理想です。
何が変わったのか
setError(null) を書き足したわけではありません。
「送信中なのにエラーもある」という状態を作る手段が、どこにも無くなりました。
statusは文字列を1つしか持てず、それを変えられるのは reducer の中の5行だけだからです。
useState 版 | useReducer 版 | |
|---|---|---|
| 表現できる状態の数 | 8通り(うち4通りは無意味) | 4通り(全部意味がある) |
| 「送信を始めたらエラーを消す」が書いてある場所 | handleSubmit の中(書き忘れられる) | reducer の "submitted" の1行(1箇所だけ) |
| 状態の変え方が書いてある場所 | 呼び出す側に散らばる | reducer 1ファイル |
| そのままテストできるか | できない(コンポーネントごと必要) | できる(ただの関数) |
副次効果 — dispatch は毎回同じ関数
F12 の Console を見てください。 入力欄に何文字打っても、送信しても、こう出続けます。
dispatch は初回と同じ関数か: true
dispatch は、再レンダリングをまたいで、常に同じ関数です。 React がそれを保証しています。だから、子コンポーネントに渡しても「毎回違う props」にならず、useEffect の依存配列に書いても無限ループになりません。
正直に書いておきます。
useStateが返すsetNameなども、実は同じく安定しています。 これはdispatchだけの特権ではありません。 本当に効いてくるのは、こちらです。–
useState版は、子に渡すときonSubmit={() => { setIsLoading(true); ... }}のような関数を作ることになります。 その関数は毎回作り直されます –useReducer版は、dispatchを1つ渡すだけで済みます。 6個のset...を配って回る必要がありません
渡すものが1つになる。 これが、階層が深くなったときに効きます。深い位置へ配る話は本線の状態管理の回にあります。
⑤ 使い分けの基準
useState を捨てて全部 reducer にする、という話ではありません。
| 状況 | 使うもの | 理由 |
|---|---|---|
| 独立した1つの値(入力中の文字、開閉フラグ) | useState | reducer にすると、書く量が増えるだけ |
| 複数の値が連動する(読み込み中・エラー・結果) | useReducer | 1つの action で同時に変えられる。あり得ない組み合わせを消せる |
| 更新のしかたが3〜4通り以上ある | useReducer | 変え方が1ファイルに集まり、上から下まで読まなくてよくなる |
| 次の状態が前の状態に強く依存する(履歴、カウンタ、並べ替え) | useReducer | reducer は必ず最新の状態を受け取る |
| 同じ変更を、離れた場所から何度も起こす | useReducer | dispatch 1つを配れば済む |
| 状態の変え方をテストしたい | useReducer | reducer はただの関数なので、React 抜きでテストできる |
上のフォームでも、name や email を useState のまま残す判断はあり得ます。 今回まとめたのは、「入力値も含めて reset で一気に戻したい」からです。 目的が違えば、答えも変わります。
迷ったときの目安を1つだけ。
useStateを書き足すとき、「この値と、あの値が食い違ったらどうなるか」を考えてしまったら、その2つは1つの状態です。
⑥ useState の初期値は、毎回評価される
もう1つ、よく踏む落とし穴です。
本線で「useState(初期値) の初期値は、最初の1回しか使われない」と書きました。 正しいのですが、言葉が足りません。
使われるのは1回きりです。 ですが、
useState(重い計算())と書くと、その計算は毎回のレンダリングで実際に実行されます。 実行して、結果が返ってきて、React がそれを捨てます。
実測します。
src/components/HeavyInit.jsx(新規)
import { useState } from "react";
function heavyInit() {
console.time("初期値の計算");
let sum = 0;
for (let i = 0; i < 20000000; i++) sum += i;
console.timeEnd("初期値の計算");
return sum;
}
function HeavyInit() {
const [total] = useState(heavyInit()); // ← 括弧を付けて「呼んで」いる
const [text, setText] = useState("");
return (
<div className="card">
<h2>初期値の落とし穴</h2>
<p>合計: {total}</p>
<label>
ここに文字を打つ
<input type="text" value={text} onChange={(e) => setText(e.target.value)} />
</label>
</div>
);
}
export default HeavyInit;
src/App.jsx に1行足します(import と、<HeavyInit /> の1行)。
import SignupFormState from "./components/SignupFormState.jsx";
import SignupFormReducer from "./components/SignupFormReducer.jsx";
import HeavyInit from "./components/HeavyInit.jsx";
function App() {
return (
<div className="app">
<h1>同じフォームを2通りで</h1>
<SignupFormState />
<SignupFormReducer />
<HeavyInit />
</div>
);
}
export default App;
測る
F12 の Console を開き、Console タブの表示を一度クリアしてから、入力欄に abcde と5文字打ってください。
初期値の計算: 22.3 ms
初期値の計算: 21.8 ms
初期値の計算: 22.1 ms
初期値の計算: 21.9 ms
初期値の計算: 22.4 ms
初期値の計算: 22.0 ms
1文字打つたびに、2000万回の足し算が走っています。 その結果は、1回目以降まったく使われません。 total は最初の値を返し続けます。
開発中は、この行数が倍になります。 StrictMode が、わざと2回レンダリングしているからです(
src/main.jsxの<StrictMode>)。 数が倍でも結論は変わりません。 本番ビルドでは2回になりませんが、「毎回走る」ことは変わりません。
[スクリーンショット: 05_初期値の計測.png] 5文字打ったあとの Console を撮ってください。初期値の計算: ○○ ms が何行も並んでいるところが見える形で。
直す — 遅延初期化
1文字だけ変えます。括弧を消します。
const [total] = useState(heavyInit); // ← 呼ばずに「関数そのもの」を渡す
もしくは、こう書きます(引数を渡したいときはこちら)。
const [total] = useState(() => heavyInit());
Console をクリアして、もう一度5文字打ってください。
初期値の計算: 22.5 ms
1行だけです(StrictMode で2行になることがあります)。
理由は単純です。
| 書き方 | React に渡っているもの | いつ計算されるか |
|---|---|---|
useState(heavyInit()) | 計算し終わった数値 | 毎回。React に渡す前に、JavaScript が計算してしまう |
useState(heavyInit) | 関数そのもの | React が「初回だ」と判断したときだけ呼ぶ |
React が「毎回計算しないようにしてくれる」のではありません。
heavyInit()と書いた時点で、React の出番が来る前に、JavaScript が計算を終えています。 React には結果しか届きません。 だから React 側では、どうやっても防げません。 括弧を外して「まだ計算しないでおく」のは、書く側の仕事です。
同じことが useReducer にもあります。 useReducer(reducer, undefined, () => 重い初期化()) と3番目の引数を渡せます。この記事の initialState はただのオブジェクトなので、要りません。
⑦ 前の値に依存するときは、関数型更新
短く、1つだけ確かめます。
src/components/CounterDemo.jsx(新規)
import { useState } from "react";
function CounterDemo() {
const [count, setCount] = useState(0);
return (
<div className="card">
<h2>+1 を2回</h2>
<p>count: {count}</p>
<button
onClick={() => {
setCount(count + 1);
setCount(count + 1);
}}
>
値で更新(2回)
</button>
<button
onClick={() => {
setCount((c) => c + 1);
setCount((c) => c + 1);
}}
>
関数型で更新(2回)
</button>
</div>
);
}
export default CounterDemo;
App.jsx に足して、押し比べてください。
| 押したボタン | count の増え方 |
|---|---|
| 値で更新(2回) | +1 しか進まない |
| 関数型で更新(2回) | +2 進む |
理由: count は、そのレンダリングの瞬間に固定された「ただの数値」です。count が 0 のとき、setCount(count + 1) は2回とも setCount(1) です。1を2回入れても1です。
setCount((c) => c + 1) は「いまの値に1足す」という指示を渡しています。 React はそれを順番に適用するので、2回ぶん進みます。
dispatchには、この問題がありません。 reducer は呼ばれるときに、必ずそのときの最新の状態を渡されます。 これも「複数が連動するならuseReducer」の理由の1つです。
覚え方は1つだけです。
setの中で前の値を使うなら、関数型で書く。
⑧ reducer はテストできる
ここが useReducer の、たぶん一番地味で一番効く長所です。
formReducerは、React を1行も import していません。 ブラウザも DOM も要りません。 だから、Node だけで、そのまま呼べます。
「送信を始めたら、前のエラーが必ず消える」 ——③で書き忘れた、あの1行を、テストで固定します。
src/formReducer.test.js(新規)
import { test } from "node:test";
import assert from "node:assert/strict";
import { formReducer, initialState } from "./formReducer.js";
test("送信を始めたら、前のエラーは必ず消える", () => {
const errored = {
...initialState,
status: "error",
error: "メールアドレスの形式が正しくありません",
};
const next = formReducer(errored, { type: "submitted" });
assert.equal(next.status, "submitting");
assert.equal(next.error, null);
});
test("知らない action は、黙って無視されず落ちる", () => {
assert.throws(() => formReducer(initialState, { type: "submited" }));
});
走らせる
VMの中で打ちます。
✔ 送信を始めたら、前のエラーは必ず消える (0.9ms)
✔ 知らない action は、黙って無視されず落ちる (0.2ms)
# tests 2
# pass 2
# fail 0
✔ が2つ出れば成功です。
[スクリーンショット: 06_テスト成功.png] node --test の出力で # pass 2 / # fail 0 が見えているところを撮ってください。
何も入れていないことに注目してください。
- テスト用のライブラリを
npm installしていません。node:testは Node 本体に入っています - ブラウザも Vite も動かしていません
importが動くのは、Vite が作ったpackage.jsonに"type": "module"が入っているからです
そして、テストが1行足せます。
useState版の「送信を始めたらエラーを消す」を、同じようにテストできますか? できません。 その処理はhandleSubmitの中にあり、handleSubmitはコンポーネントの中にあります。テストするには、コンポーネントを描画して、クリックを再現して、800ミリ秒待つ必要があります。
コンポーネントごとテストする方法もちゃんとあります(Vitestでテストを書く回)。ですが、必要な準備の量がまったく違います。
状態の変え方を「ただの関数」に追い出すと、テストが安くなる。 これが、reducer に書き換えることの、目に見えにくいほうの見返りです。
わざと失敗させて、テストが本当に効いているか確かめます。 formReducer.js の "submitted" の行から error: null, を消して、もう一度走らせてください。
✖ 送信を始めたら、前のエラーは必ず消える
# tests 2
# pass 1
# fail 1
落ちれば、テストが仕事をしています。 確認したら error: null, を戻してください。
⑨ 状態管理ライブラリは、まだ要らない
「React 状態管理」で検索すると、いきなりライブラリの名前が並びます。 ですが、この記事でやったことは、全部 React 本体の機能です。npm install は1回もしていません。
useState— 独立した値useReducer— 連動する値、複雑な更新useContext— 深い位置へ配る(本線の回)
この3つで足りる範囲は、思っているよりずっと広いです。 足りなくなるのは、たいてい「サーバーから取ってきたデータ」を扱い始めたときで、そのときに要るのは状態管理ライブラリではなく、キャッシュの道具です。
その話は深入りしません。 本線の状態管理の回に、どのライブラリが何を解く道具なのかを整理してあります。
ここで言えるのは1つだけです。
useStateが6個並んで困ったときの答えは、ライブラリを入れることではありませんでした。 状態の持ち方を変えることでした。
つまずいたところ
フックを直したのに、画面が真っ赤のまま
②でわざと壊したあと、コードを直しても画面が戻らないことがあります。 フックの規則を破ると、そのコンポーネントの内部状態が壊れた状態で止まっているためです。
ブラウザを一度リロード(F5)してください。 それで戻ります。HMR(保存したら勝手に反映される仕組み)は、この種のエラーからは復帰できません。
「毎回2回出る」のを、バグだと思って30分探した
⑥の console.time が、必ず2行ずつ出ました。 ループの回数を疑い、React の版を疑い、最後に src/main.jsx を見て気づきました。
<StrictMode>
<App />
</StrictMode>
StrictMode が、開発中だけわざと2回レンダリングしています。 「初期値の中に副作用を書くと2回走ってしまう」ことを、開発者に見せるための仕組みです。バグを隠すのではなく、炙り出すために入っています。
外して確かめてもいいですが、戻すのを忘れないでください。 私は外したまま次の実験に進んで、別の場所で「1回しか出ない」ことに混乱しました。
遅延初期化のつもりで useState(() => heavyInit()) と書いたのに、速くならなかった
書いたのは、これでした。
const [total] = useState(() => heavyInit()); // 正しい
ですが、その前に一度、これを書いていました。
const [total] = useState((() => heavyInit())()); // 括弧が1組多い
末尾の () で、その場で呼んでしまっています。 見た目は遅延初期化なのに、渡っているのは数値です。
確かめ方: console.log(typeof 渡しているもの) を一時的に書いて、function と出るか見るのが確実です。number と出たら、その時点で負けています。
action.type を打ち間違えて、画面が真っ赤になった
{ type: "submited" }(t が1つ足りない)と書きました。 default の throw が効いて、赤い画面が出ました。
Uncaught Error: 知らない action.type です: submited
最初は「throw なんて書かなければよかった」と思いました。 ですが、throw が無かったら、switch は何もせずに undefined を返します。 状態が undefined になり、次のレンダリングで state.status を読んだ瞬間に、まったく関係ない場所で落ちます。
原因から遠い場所で落ちるほうが、100倍やっかいです。 default の throw は残してください。
npx eslint src が「No files matching」と言う
~/reactlab ではないディレクトリで打っています。 pwd を確認してください。/home/ユーザー名/reactlab でなければ、cd ~/reactlab してからです。
ブラウザが読み込み中のまま止まる
5174番を開け忘れています。 ターミナルには Local: と Network: が出ていて、成功しているように見えるので気づきにくいです。
5174/tcp の行が無ければ、①に戻ってください。
後片づけ
開発サーバーを止める
起動しているターミナルで Ctrl+C。
確認: 何も出なければ、止まっています。
ポートを閉じる
開けっぱなしにしません。
確認: 5174/tcp の行が消えていれば成功です。5173番は、本線で使うので残してあります。
プロジェクトをどうするか
~/reactlab/ は、消しても消さなくても構いません。
残す場合、node_modules が数百MBあります。中身は package.json から復元できるので、容量が気になるなら消して構いません。
戻すときは cd ~/reactlab && npm install だけです。この考え方はnpmの回にあります。
丸ごと消す場合。
~/react-demo/ は絶対に消さないでください。 本線がその続きで進みます。
確認: 本線のファイル一覧が出れば、無事です。
まとめ
- React はフックを名前で覚えていない。呼ばれた順番だけで覚えている。 だから
ifの中で呼ぶと、次の state が1つずれる - 規則は2つだけ。トップレベルで呼ぶ / 毎回同じ順番で同じ数だけ呼ぶ。 出し分けはフックではなく JSX の
&&でやる - 破ると
Rendered more hooks than during the previous render.で止まる。 ただし気づけない壊れ方もある eslint-plugin-react-hooksは、この規則を機械で完全に検査できる。 Vite の React テンプレートには最初から入っている。押す前に止まるisLoading/error/resultを別々のuseStateで持つと、2 × 2 × 2 = 8通りが表現でき、4通りは現実に存在しない- 「送信中なのにエラーもある」は、
setError(null)の書き忘れではなく、書き忘れられる形で持っていたことが原因 - 段階が4つなら、真偽値3つではなく
status1つで持つ。 文字列は1つしか入らないので、矛盾が構造的に作れなくなる - reducer は
(state, action) => 次の状態の純粋関数。 React も DOM も通信も出てこない "submitted"の1行でstatusとerrorとresultが同時に決まる。 「始めたら前のエラーを消す」が1箇所だけになるdefaultのthrowは残す。 打ち間違いを黙って無視されるほうが、はるかに危険- 使い分けは「1つの独立した値なら
useState」「複数が連動するならuseReducer」「更新のしかたが3つ以上ならuseReducer」 useStateを足すときに「この値とあの値が食い違ったら」と考えたら、その2つは1つの状態dispatchは再レンダリングをまたいで同じ関数。set...も同じく安定なので、効くのは「配るものが6個から1個になる」ほうuseState(重い計算())の計算は毎回走る。 結果は捨てられるのに計算だけ実行される- 防げるのは React ではなく書く側。
useState(heavyInit)と括弧を外すか、useState(() => heavyInit()) - 開発中の
consoleが2回ずつ出るのは StrictMode。 バグではなく、副作用を炙り出すための仕組み setCount(count + 1)を2回書いても +1 しか進まない。countはその瞬間に固定された数値だから。前の値を使うならsetCount((c) => c + 1)- reducer はただの関数なので、
node --testで単体テストが書ける。 ライブラリのインストールもブラウザも要らない - 状態管理ライブラリはまだ要らない。
useState/useReducer/useContextで足りる範囲は広い
参考リンク
- roadmap.sh — React
- React 公式 — useState
- React 公式 — useReducer
- React 公式 — 状態のロジックを reducer に切り出す
- React 公式 — 状態の構造の選び方
- React 公式 — フックの規則
- React 公式 — StrictMode
- eslint-plugin-react-hooks
- Node.js 公式 — テストランナー
- Vite 公式ガイド
次に読む
この記事は 【深掘り】React の 4 / 24 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | 再描画の仕組み — 押していない子まで描き直される |
| → 次の記事 | useEffect — その多くは要らない |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- フックの規則と useState の落とし穴
- useReducer で「あり得ない状態」を消す
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント