useStateとuseReducer — 読み込み中なのにエラーもある

useStateとuseReducer。整理された状態のカードと歯車、チェックを表示するパソコン。

本線を書き終えたあと、実際に自分でフォームを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つは進まないこと。前の値に依存するときは関数型更新が必須であること

この記事でやること

  1. ~/reactlab/ を新しく作り、本線の ~/react-demo/ とは別のポートで動かす
  2. useState をわざと if の中に入れて壊し、React が出す実際のエラー文と、eslint-plugin-react-hooks が止めてくれることを確認する
  3. useState 6個で会員登録フォームを作り、「送信中なのにエラーも出ている」画面を自分の手で再現する
  4. 同じフォームを useReducer で書き直し、その組み合わせが作れなくなることを確かめる
  5. useState の初期値が毎回評価されることを console.time で実測し、遅延初期化で消す
  6. reducer の単体テストを1本書いて、node --test で走らせる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
フック(hook)use で始まる React の関数。コンポーネントに「記憶」や「外との接続」を持たせる
フックの規則(Rules of Hooks)コンポーネントのトップレベルでだけ呼ぶ、毎回同じ順番で同じ数だけ呼ぶ、という2つの決まり
純粋関数同じ引数を渡せば、必ず同じ結果を返し、外の世界を書き換えない関数。時刻も乱数も通信も使わない
reducer(いまの状態, action) => 次の状態 という形の純粋関数
action「何が起きたか」を表すただのオブジェクト。{ type: "submitted" } のような形
dispatchaction を reducer に届ける関数。「これが起きました」と報告する係
あり得ない状態(impossible state)プログラム上は作れるのに、現実には存在しない状態の組み合わせ。「送信中かつエラー」など
遅延初期化(lazy initializer)useState(値) ではなく useState(() => 値) と書き、初期値の計算を最初の1回だけに限る書き方
関数型更新setX(新しい値) ではなく setX((前の値) => 新しい値) と書く更新のしかた
StrictMode開発中だけ、わざと2回レンダリングして問題を炙り出すReact の仕組み。本番では動かない

① 準備 — reactlab を新しく作る

本線で作った ~/react-demo/ は、そのまま残します。 この記事はまっさらなプロジェクトでやります。壊す手順があるからです。

VMの中で、ホームディレクトリに戻って作ります。

bash
$ cd ~
$ npm create vite@latest reactlab -- --template react

質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。

bash
$ cd ~/reactlab
$ npm install
$ ls
eslint.config.js  index.html  package.json  public  README.md  src  vite.config.js

この一覧が出れば成功です。 npm install は初回だけ数分かかります。何が起きているかはnpmの回、dist/ が何なのかはビルドツールの回にあります。

ポートを開ける

本線で 5173番を使っています。 ぶつからないように、この記事は 5174番でやります。

bash
$ sudo ufw allow 5174/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere
5174/tcp                   ALLOW       Anywhere

5174/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。

起動する

bash
$ npm run dev -- --host 0.0.0.0 --port 5174

ホストの 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枚開くのが楽です)で打ちます。

bash
$ cd ~/reactlab
$ npx eslint src

何も出力されずにプロンプトが戻れば、問題ゼロという意味です。 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つ置きます。

bash
$ mkdir -p ~/reactlab/src/components

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; }

実際に押す

ブラウザで確かめます。

  1. まず「名前を切り替える」を数回押してください。 問題なく動きます。 showNote が false のままなので、フックの数は毎回2個で変わっていません
  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 を、この状態で走らせます。

bash
$ cd ~/reactlab
$ npx eslint src
/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個並びました。 ここまでは、誰が書いてもこうなります。間違ってはいません。

矛盾を、手で作る

ブラウザで、この順番どおりに操作してください。

  1. 名前に たろう、メールアドレスに abc(@ なし)と入れる
  2. 「規約に同意する」にチェックを入れる
  3. 「送信」を押す → 800ミリ秒後に エラー: メールアドレスの形式が正しくありません が出る
  4. メールアドレスを taro@example.com に直す
  5. もう一度「送信」を押す

5の直後、800ミリ秒のあいだ、画面はこうなります。

送信中…
エラー: メールアドレスの形式が正しくありません

両方、同時に出ています。

[スクリーンショット: 03_矛盾した状態.png] 「送信中…」と「エラー: …」が同時に出ている瞬間を撮ってください。800ミリ秒しかないので、押した直後に素早く。 難しければ api.js の 800 を 5000 に変えると余裕ができます(撮り終わったら 800 に戻してください)。

何が起きているのか

handleSubmit が setError(null) を呼んでいないからです。error は、前回入った値を持ったままです。

「なるほど、1行足せばいい」で終わらせません。 数えます。

isLoadingerrorresult意味があるか
falsenullnull✅ まだ何もしていない
truenullnull✅ 送信中
falseありnull✅ 失敗した
falsenullあり✅ 成功した
trueありnull❌ 送信中なのにエラー(いま出したもの)
truenullあり❌ 送信中なのに成功済み
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 版」でやってください。

  1. メールに abc を入れて、同意にチェックして送信 → エラー: …、status は error
  2. メールを 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つの値(入力中の文字、開閉フラグ)useStatereducer にすると、書く量が増えるだけ
複数の値が連動する(読み込み中・エラー・結果)useReducer1つの action で同時に変えられる。あり得ない組み合わせを消せる
更新のしかたが3〜4通り以上あるuseReducer変え方が1ファイルに集まり、上から下まで読まなくてよくなる
次の状態が前の状態に強く依存する(履歴、カウンタ、並べ替え)useReducerreducer は必ず最新の状態を受け取る
同じ変更を、離れた場所から何度も起こすuseReducerdispatch 1つを配れば済む
状態の変え方をテストしたいuseReducerreducer はただの関数なので、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の中で打ちます。

bash
$ cd ~/reactlab
$ node --test src/formReducer.test.js
✔ 送信を始めたら、前のエラーは必ず消える (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, を消して、もう一度走らせてください。

bash
$ node --test src/formReducer.test.js
✖ 送信を始めたら、前のエラーは必ず消える
# 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: が出ていて、成功しているように見えるので気づきにくいです。

bash
$ sudo ufw status

5174/tcp の行が無ければ、①に戻ってください。


後片づけ

開発サーバーを止める

起動しているターミナルで Ctrl+C。

bash
$ ss -ltnp | grep 5174

確認: 何も出なければ、止まっています。

ポートを閉じる

開けっぱなしにしません。

bash
$ sudo ufw delete allow 5174/tcp
$ sudo ufw status

確認: 5174/tcp の行が消えていれば成功です。5173番は、本線で使うので残してあります。

プロジェクトをどうするか

~/reactlab/ は、消しても消さなくても構いません。

残す場合、node_modules が数百MBあります。中身は package.json から復元できるので、容量が気になるなら消して構いません。

bash
$ du -sh ~/reactlab/node_modules
$ rm -rf ~/reactlab/node_modules

戻すときは cd ~/reactlab && npm install だけです。この考え方はnpmの回にあります。

丸ごと消す場合。

bash
$ rm -rf ~/reactlab

~/react-demo/ は絶対に消さないでください。 本線がその続きで進みます。

bash
$ ls ~/react-demo/src

確認: 本線のファイル一覧が出れば、無事です。


まとめ

  • 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つではなく status 1つで持つ。 文字列は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 で足りる範囲は広い

参考リンク


次に読む

この記事は 【深掘り】React の 4 / 24 本目です。

記事
← 前の記事再描画の仕組み — 押していない子まで描き直される
→ 次の記事useEffect — その多くは要らない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›React — Hooks
  • フックの規則と useState の落とし穴
  • useReducer で「あり得ない状態」を消す

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次