状態管理ライブラリ — 入れる前に大半は要らなかった

状態管理を整理する。4種類に整理した状態のカード、仕分け用のトレイと歯車。

状態管理ライブラリは、入れる前に大半が要りません。何に困ったら入れるのかを、条件で決められるようにします。

前回: UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない

これは深掘りです。本線の順路ではありません。 本線の状態管理はライブラリの話ではない — Contextまでを読み終えて、「で、結局ライブラリは入れるのか入れないのか」が宙に浮いたままの人が読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、すべて VM の中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った ~/react-demo/ には触りません。 この記事では、まっさらな ~/reactlab/ を新しく作ります。ポートは 5186 を使います。

React を始めて2週間目に、こう書いてある記事を読みました。

Reactには状態管理ライブラリが必須です。

素直に信じました。名前が並んでいたので、一番よく見かけたものを npm install しました。そして、作りかけの ToDo アプリの状態を、全部そこに移しました。

  • 入力途中の文字を、ストアに入れました
  • APIから取ってきた一覧を、ストアに入れました
  • 開いているタブの名前を、ストアに入れました
  • ダークモードかどうかを、ストアに入れました

動きました。 動いたのですが、3日後に自分の書いたコードが読めなくなりました。

「この一覧、いつ取り直されるんだっけ」「このタブの状態、リロードしたら消えるのはなぜ」「入力欄が1文字ごとに全部再描画されているのは、ライブラリのせい?」

そして、あとから全部を素の React に戻したら、コードが短くなりました。

戻した結果、ストアに残ったのは4つだけでした。テーマ、サイドバーの開閉、通知、ログイン情報。 それ以外は、そもそもストアに置くべきものではありませんでした。

「状態管理ライブラリが要る」と思っている状態の大半は、状態管理ライブラリの担当ではありません。

この記事は、その仕分けの記事です。先に4種類に分けます。 そのうえで、本当に残ったぶんだけを Zustand に置き換えて、何が良くなるかを再描画の回数で数えます。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • 「状態」はひとかたまりではなく、少なくとも4種類あること。サーバーのデータ / URLの状態 / フォームの入力 / 本当のクライアント状態で、担当する道具が全部違う
  • ライブラリが欲しくなる場面の大半は、サーバーのデータであること。そこはキャッシュの問題で、状態管理の問題ではない
  • URLの状態は、URLに置くこと。ストアに置くと、リロードで消え、共有したリンクが別の画面を開く
  • 仕分けたあとに残るクライアント状態は、驚くほど少ないこと。テーマ・サイドバーの開閉・通知・認証情報くらい
  • Context と状態管理ライブラリの決定的な差は「セレクタ」1点であること。Context は「この人には要らない」を判断できない
  • Zustand は Provider を要求しないこと。ストアは React の外にあり、フックは購読しているだけ
  • セレクタを付けないと、Zustand でも全部再描画されること。入れただけでは速くならない
  • Redux Toolkit / Jotai / MobX は「同じものの別実装」ではないこと。中央集権 / 原子 / 監視という、考え方そのものが違う
  • 入れると、増える仕事があること。「どこで何が変わったか」が追いにくくなり、DevTools とテストの手当てが要る

この記事でやること

  1. ~/reactlab/ を新しく作り、ポート 5186番で起動する
  2. 手元の状態を4種類に仕分ける表を作り、ストアに残るものが何本あるかを数える
  3. 残ったぶんを Context で作り、Contextの回の結論(分割してもセレクタが無い)を、もう一度目で見る
  4. Zustand を入れて、同じものを create とセレクタで書き直す
  5. 再描画の回数を数えて、「使っている値だけで再描画される」ことを確かめる
  6. 入れる前のチェック3項目に自分のプロジェクトを通す

先に知る言葉

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

言葉意味
状態管理ライブラリ複数の画面から読み書きする値を、1箇所にまとめて置くための外部ライブラリ。React 本体の機能ではない
ストア(store)その「1箇所」の置き場所そのもの。 値と、値を変える関数が入っている
セレクタ(selector)ストアから「自分が使う部分だけ」を取り出す関数。 (s) => s.theme のような形。この記事の主役
購読(subscribe)値が変わったら教えてもらう約束。セレクタがあると「この部分が変わったときだけ」に絞れる
サーバー状態(server state)本当の持ち主がサーバーにあるデータ。手元にあるのは写しなので、古くなる
クライアント状態(client state)持ち主が自分(ブラウザ)のデータ。誰にも聞かずに決められる値
中央集権型状態を1つの大きな箱にまとめる考え方(Redux / Zustand)
原子(atom)型状態を小さな粒に分けて撒き、必要な粒だけを読む考え方(Jotai / Recoil)
監視(observable)型オブジェクトを普通に書き換えると、見ている画面が勝手に更新される考え方(MobX)
ボイラープレート中身は違うのに、毎回ほぼ同じ形で書かされる決まり文句のコード

① 練習場を作る

本線で作った ~/react-demo/ は触りません。 壊しながら試すので、別のプロジェクトを1つ作ります。

VMの中で実行します。

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

確認: ls src で App.jsx と main.jsx が出れば成功です。

bash
$ ls src
App.css  App.jsx  assets  index.css  main.jsx

ポートを開けます。この記事では 5186 を使います。(他の深掘り記事の練習場と同時に動かしても、ぶつからないようにするためです)

bash
$ sudo ufw allow 5186/tcp
$ sudo ufw status

確認: 一覧に 5186/tcp ALLOW が出ていれば成功です。

起動します。

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

--host 0.0.0.0 が要る理由は、これが無いと VM の中からしか繋がらないからです(ネットワークの回)。VM の IP は ip a で調べます。

ホストの Windows のブラウザで http://<VMのIP>:5186/ を開いて、Vite のロゴが出れば準備完了です。

数えるために、StrictMode を外す

この記事も「何回再描画されたか」を数えます。 StrictMode が付いていると、開発中は関数がわざと2回呼ばれるので(再描画の回で扱いました)、数字が全部2倍になって読みにくくなります。

この記事の間だけ外します。src/main.jsx を、こう書き換えます。

import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'

createRoot(document.getElementById('root')).render(<App />)

本番のコードで外してはいけません。 外すのは「数を数える実験のときだけ」で、この記事の最後(後片づけ)で戻します。


② 先に、状態を4種類に分ける

ライブラリの話をする前に、これをやります。 ここを飛ばすと、入れても片づきません。

手元のアプリで「状態」と呼んでいるものを、全部紙に書き出して、この4つのどれかに振り分けます。

種類具体例本当の持ち主担当する道具
① サーバーのデータ記事一覧、ユーザー情報、在庫数、検索結果サーバー(手元にあるのは写し)TanStack Query / SWR
② URLの状態開いているタブ、検索語、ページ番号、絞り込み条件URL(アドレスバー)ルーター / URLSearchParams
③ フォームの入力入力途中の文字、検証エラー、送信中かどうかその画面のフォームuseState(多ければフォーム用ライブラリ)
④ 本当のクライアント状態テーマ、サイドバーの開閉、通知、認証情報アプリ全体useState + Context →(足りなければ)状態管理ライブラリ

状態管理ライブラリの担当は、④だけです。 ①②③は、担当が別にいます。

①「状態管理ライブラリが要る」の大半は、これ

「一覧をどこからでも読みたい」「登録したら一覧を更新したい」「同じデータを2画面で使いたい」。

この3つは、全部サーバーのデータの話です。 そして、サーバーのデータは状態ではありません。キャッシュです。

  • 状態は、自分が決めた値です。誰にも聞かずに変えられます
  • サーバーのデータは、本体がよそにあります。 自分の手元の値は、放っておくと勝手に古くなります

古くなる値をストアに入れると、「いつ取り直すか」を自分で書くことになります。 それが前回の記事で数えた 203行でした。

一覧データをストアに入れているなら、それはライブラリの選択を間違えているのではなく、種類の判定を間違えています。 そこは TanStack Query の回でやったとおり、キャッシュの道具の担当です。

この判定を1回やるだけで、ストアに入れるつもりだったものの大半が消えます。 私の場合、書き出した11本のうち6本が①でした。

② URLの状態は、URLに置く

「いま開いているタブ」「検索欄に入れた文字」「一覧の2ページ目」。

これを useState やストアに置くと、次の3つが黙って壊れます。

  1. リロードすると、1ページ目に戻る
  2. ブラウザの戻るボタンが効かない(またはアプリ全体から出てしまう)
  3. 画面のリンクを人に送っても、相手には別の画面が開く

3番目が一番痛いです。「この検索結果を見て」と URL を送って、相手が空の画面を見るという事故になります。

置き場所を URL にすると、この3つが同時に直ります。 ブラウザが履歴を持っていて、リロードでも消えず、コピーすれば他人にも同じ画面が出ます。

// 現在のURLが http://example.com/books?q=react&page=2 のとき
const params = new URLSearchParams(location.search)
params.get('q')     // 'react'
params.get('page')  // '2'

実際のアプリでは、これを直接触るのではなく、ルーターに任せます(ルーティングの回)。

「URLに出したくない」という理由でストアに置くのは、たいてい間違いです。 URLに出したくないのは、ふつう③のフォーム入力のほうです。画面の位置を表す値は、URLに出ているのが正しい状態です。

③ フォームの入力は、その画面から出さない

入力途中の文字は、1文字打つたびに変わります。

これを全体のストアに置くと、1文字ごとに、そのストアを読んでいる全員が再描画されます。 これはフォームの回で実測しました。画面全体が、キーを打つたびに描き直されます。

入力値は、その画面(できればそのフォーム)の中に閉じ込めます。 外に出るのは、送信ボタンを押したあとの結果だけです。

④ ここだけが、状態管理ライブラリの担当

残ったものを見ます。次の章です。


③ 残るものを、実際に数える

私が書き出した11本を、②の表で振り分けた結果です。

書き出した状態判定置き場所
記事一覧① サーバーQuery
記事の詳細① サーバーQuery
検索結果① サーバーQuery
ログインユーザーのプロフィール① サーバーQuery
通知の未読件数(サーバー由来)① サーバーQuery
お気に入り一覧① サーバーQuery
検索語② URLルーター
開いているタブ② URLルーター
投稿フォームの入力値③ フォームその画面の useState
ダークモードかどうか④ クライアントストア
サイドバーが開いているか④ クライアントストア

11本のうち、残ったのは2本でした。

実際のアプリでは、もう少しだけ増えます。④として残りやすいのは、次の4つくらいです。

残るものなぜ④なのか
テーマ(ダーク / ライト)サーバーに聞かなくても決まる。読む場所がとても多い
サイドバー・モーダルの開閉画面の見た目の状態。URLに出す場合もある(モーダルは出したほうがいいことも多い)
通知(トースト)の一覧どこからでも追加され、どこか1箇所で表示される。 追加する側と表示する側が遠い
認証情報(ログイン中かどうか、トークン)アプリ全体の分岐に使う。トークン本体の扱いは認証の回の話で、置き場所とは別問題

多くて4〜6本です。 数十本にはなりません。

ここまで来て、はじめて「Context で足りるか」を考えます。 4〜6本しかないなら、まず Context です。 本当に足りないと分かってから、ライブラリを入れます。


④ まず Context で作る(そして限界を思い出す)

残った ④ を、Context で作ります。 これが比較の土台になります。

src/UiContext.jsx を作ります。

import { createContext, useContext, useMemo, useState } from 'react'

const UiContext = createContext(null)

export function UiProvider({ children }) {
  const [theme, setTheme] = useState('light')
  const [sidebarOpen, setSidebarOpen] = useState(false)
  const [notices, setNotices] = useState([])

  const value = useMemo(() => ({
    theme,
    sidebarOpen,
    notices,
    toggleTheme: () => setTheme((t) => (t === 'light' ? 'dark' : 'light')),
    toggleSidebar: () => setSidebarOpen((v) => !v),
    pushNotice: (text) => setNotices((list) => [...list, text]),
  }), [theme, sidebarOpen, notices])

  return <UiContext.Provider value={value}>{children}</UiContext.Provider>
}

export function useUi() {
  const ctx = useContext(UiContext)
  if (ctx === null) throw new Error('useUi は UiProvider の中で使ってください')
  return ctx
}

createContext(null) と throw の組み合わせは、Contextの回でやった定型です。Provider の囲み忘れが、既定値で静かに通ってしまう事故を防ぎます。

再描画を数える小さなフックを src/useRenderCount.js に置きます。

import { useRef } from 'react'

export function useRenderCount(name) {
  const n = useRef(0)
  n.current += 1
  console.log(`${name}: ${n.current}回目`)
  return n.current
}

読む側を3つ作ります。src/Parts.jsx です。

import { useUi } from './UiContext.jsx'
import { useRenderCount } from './useRenderCount.js'

export function ThemeLabel() {
  const { theme } = useUi()
  const n = useRenderCount('ThemeLabel')
  return <p>テーマ: {theme} <small>(描画 {n} 回)</small></p>
}

export function SidebarLabel() {
  const { sidebarOpen } = useUi()
  const n = useRenderCount('SidebarLabel')
  return <p>サイドバー: {sidebarOpen ? '開' : '閉'} <small>(描画 {n} 回)</small></p>
}

export function NoticeButton() {
  const { pushNotice } = useUi()
  const n = useRenderCount('NoticeButton')
  return (
    <button onClick={() => pushNotice('こんにちは')}>
      通知を1件足す(描画 {n} 回)
    </button>
  )
}

src/App.jsx を書き換えます。

import { UiProvider, useUi } from './UiContext.jsx'
import { ThemeLabel, SidebarLabel, NoticeButton } from './Parts.jsx'

function Controls() {
  const { toggleTheme, toggleSidebar } = useUi()
  return (
    <div>
      <button onClick={toggleTheme}>テーマ切替</button>
      <button onClick={toggleSidebar}>サイドバー切替</button>
    </div>
  )
}

export default function App() {
  return (
    <UiProvider>
      <h1>Context 版</h1>
      <Controls />
      <NoticeButton />
      <ThemeLabel />
      <SidebarLabel />
    </UiProvider>
  )
}

数える

ブラウザで http://<VMのIP>:5186/ を開き、F12 で Console を出します(開発者ツールの回)。

「通知を1件足す」を3回押してください。 テーマもサイドバーも、1ミリも変えていません。

ThemeLabel: 2回目
SidebarLabel: 2回目
NoticeButton: 2回目
ThemeLabel: 3回目
SidebarLabel: 3回目
NoticeButton: 3回目
ThemeLabel: 4回目
SidebarLabel: 4回目
NoticeButton: 4回目

押した回数だけ、全員が再描画されています。

[スクリーンショット: 01_context_全部再描画.png] 「通知を1件足す」を3回押したあとの Console を撮ってください。ThemeLabel と SidebarLabel が、押した回数ぶん増えているところが写るようにしてください。

理由は簡単です。 notices が変わる → useMemo の依存に notices が入っている → value が新しくなる → useContext している全員に通知が行く。

分けても、消えない

Contextの回では、これをContext の分割で減らしました。テーマ用、サイドバー用、通知用に3つに割れば、通知を足しても ThemeLabel は再描画されません。

そこまでは直ります。 ですが、次が直りません。

1つの Context の中に値が2つ以上あると、そのどちらが変わっても、両方の読者が再描画される。

たとえば通知の Context に notices(一覧)と unreadCount(未読数)を入れると、一覧しか使っていない部品も、未読数が変わるたびに再描画されます。

これを消すには「この人は notices しか使っていないので、unreadCount の変更では起こさない」という判断が要ります。 その判断をする関数がセレクタです。

Context にはセレクタがありません。 useContext は「その Context の値」を丸ごと受け取る API で、「一部だけ」を指定する口が無いからです。 だから Context を分ける = 手でセレクタの代わりをしていることになります。値の数だけ Context とファイルが増えます。

ここが、ライブラリの出番です。 ここまで来ていないのに入れるのは、早すぎます。


⑤ Zustand に置き換える

同じものを、Zustand で作ります。 まず入れます。

bash
$ npm install zustand

確認: package.json の dependencies に zustand が入っていれば成功です。

bash
$ cat package.json

ストアを1つ作る

src/uiStore.js を作ります。これで全部です。

import { create } from 'zustand'

export const useUiStore = create((set) => ({
  theme: 'light',
  sidebarOpen: false,
  notices: [],
  toggleTheme: () => set((s) => ({ theme: s.theme === 'light' ? 'dark' : 'light' })),
  toggleSidebar: () => set((s) => ({ sidebarOpen: !s.sidebarOpen })),
  pushNotice: (text) => set((s) => ({ notices: [...s.notices, text] })),
}))

読み方を分解します。

書いたもの意味
create(...)ストアを1つ作る。 返ってくるのはフック(useUiStore)。だから名前が use で始まる
(set) => ({ ... })ストアの中身を返す関数。 set は「更新する係」
theme: 'light'値。 useState の初期値にあたる
toggleTheme: () => ...更新関数も、値と同じ場所に置く。 Context 版と違って、外に切り出さなくていい
set((s) => ({ theme: ... }))返したキーだけが差し替わる。 書かなかった notices はそのまま残る(部分更新)

set は「上書き」ではなく「マージ」です。 set({ theme: 'dark' }) と書いても sidebarOpen は消えません。 ここは Redux の reducer(毎回、状態の全体を返す)と違うところで、最初に戸惑いました。

読む側を、セレクタで書く

src/PartsZ.jsx を作ります。Context 版との違いは、たった1行です。

import { useUiStore } from './uiStore.js'
import { useRenderCount } from './useRenderCount.js'

export function ThemeLabelZ() {
  const theme = useUiStore((s) => s.theme)      // ← セレクタ
  const n = useRenderCount('ThemeLabelZ')
  return <p>テーマ: {theme} <small>(描画 {n} 回)</small></p>
}

export function SidebarLabelZ() {
  const sidebarOpen = useUiStore((s) => s.sidebarOpen)
  const n = useRenderCount('SidebarLabelZ')
  return <p>サイドバー: {sidebarOpen ? '開' : '閉'} <small>(描画 {n} 回)</small></p>
}

export function NoticeButtonZ() {
  const pushNotice = useUiStore((s) => s.pushNotice)
  const n = useRenderCount('NoticeButtonZ')
  return (
    <button onClick={() => pushNotice('こんにちは')}>
      通知を1件足す(描画 {n} 回)
    </button>
  )
}

(s) => s.theme の部分がセレクタです。 これが、「私は theme しか使っていません」という申告になります。

src/App.jsx を書き換えます。注目してほしいのは、<UiProvider> が無いことです。

import { useUiStore } from './uiStore.js'
import { ThemeLabelZ, SidebarLabelZ, NoticeButtonZ } from './PartsZ.jsx'

function ControlsZ() {
  const toggleTheme = useUiStore((s) => s.toggleTheme)
  const toggleSidebar = useUiStore((s) => s.toggleSidebar)
  return (
    <div>
      <button onClick={toggleTheme}>テーマ切替</button>
      <button onClick={toggleSidebar}>サイドバー切替</button>
    </div>
  )
}

export default function App() {
  return (
    <>
      <h1>Zustand 版</h1>
      <ControlsZ />
      <NoticeButtonZ />
      <ThemeLabelZ />
      <SidebarLabelZ />
    </>
  )
}

⑥ 再描画の回数を数える

Console を一度クリアしてから、また 「通知を1件足す」を3回押してください。

NoticeButtonZ: 1回目
ThemeLabelZ: 1回目
SidebarLabelZ: 1回目

最初の1回だけです。 3回押しても、何も増えません。

[スクリーンショット: 02_zustand_再描画されない.png] Zustand 版で「通知を1件足す」を3回押したあとの Console を撮ってください。ThemeLabelZ と SidebarLabelZ が 1回目 のままであることが分かるようにしてください。

次に「テーマ切替」を押します。

ThemeLabelZ: 2回目

ThemeLabelZ だけです。 SidebarLabelZ も NoticeButtonZ も動きません。

Context 版と並べます。

操作Context 版(1つにまとめた場合)Zustand 版(セレクタあり)
通知を1件足す3つ全部が再描画0(誰も再描画されない)
テーマ切替3つ全部が再描画ThemeLabelZ だけ
サイドバー切替3つ全部が再描画SidebarLabelZ だけ

これが、セレクタの正体です。 「使っている値だけ」で起きる、という一点だけのために入れています。

なぜこれができるのか

ストアが React の外にあるからです。

  • Context: 値は React のツリーの中にあり、Provider の再描画に相乗りして流れます。 だから「途中で誰かを止める」ことができません
  • Zustand: 値はただの JavaScript のオブジェクトとして React の外にあります。フックはそこを見張っているだけです。値が変わると、購読者ごとに「セレクタの結果が変わったか」を比べ、変わった人だけ再描画します

セレクタを書かないと、この効果は出ません。 const s = useUiStore() と書くと、ストア全体を購読することになり、Context 版と同じ「全部再描画」に戻ります。 これが Zustand で一番多い事故です。入れただけでは速くなりません。

セレクタで、もう1つの事故

// v5 では無限ループで落ちることがある(v4 までは毎回再描画)
const { theme, sidebarOpen } = useUiStore((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))

セレクタが毎回「新しいオブジェクト」を返しているので、中身が同じでも別物と判定されます。 Context の value={{ a, b }} と同じ問題です。いま npm install zustand で入る v5 では、再描画が増えるだけでは済まず、Maximum update depth exceeded のエラーで画面が落ちることがあります。

素直な直し方は、行を分けることです。

const theme = useUiStore((s) => s.theme)
const sidebarOpen = useUiStore((s) => s.sidebarOpen)

2行になっても、こちらのほうが安全です。 どうしてもまとめたいときだけ、import { useShallow } from 'zustand/shallow' で読み込んだ useShallow でセレクタを包みます(useUiStore(useShallow((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))))。


⑦ Provider が要らない、という違い

Zustand 版の App.jsx には、囲みのタグがありません。

ContextZustand
囲むタグ必要(<UiProvider>)不要
囲み忘れ既定値が静かに使われる or throw起きない(囲むものが無い)
React の外から読むできないできる(useUiStore.getState())
テストのとき毎回 Provider で包む必要がある包まなくていい。代わりに状態のリセットが必要

3行目が地味に効きます。React のコンポーネントではない場所、たとえば通信のエラー処理の中から、こう書けます。

import { useUiStore } from './uiStore.js'

export function apiErrorHandler(err) {
  useUiStore.getState().pushNotice(`通信に失敗しました: ${err.message}`)
}

Context だとこれができません。 useContext はコンポーネントの中でしか呼べないからです。

ただし、これは「便利」であると同時に「危ない」ことでもあります。 どこからでも状態を書き換えられるということは、「誰がこれを変えたのか」を探すのが難しくなるということです。⑩で扱います。


⑧ 他の選択肢を、性格の違いで見る

Zustand が唯一の答えではありません。 ただし、「どれも同じことをする別の書き方」でもありません。 考え方が違います。

ライブラリ性格状態の置き方変え方向くとき
Zustand中央集権(小さい)1つのストアに値と関数をまとめる関数の中で set を呼ぶ④が数本〜十数本。まず試すもの
Redux Toolkit中央集権(厳格)slice に分けて1つの store に束ねるaction を dispatch し、reducer が返す人数が多い / 変更の履歴を追う必要がある
Jotai原子atom を小さく撒く。中央の箱が無いatom ごとに更新する状態が細かく分岐し、組み合わせが多い
MobX監視普通のオブジェクトを書き換えるだけobj.count++ のように書くオブジェクト指向で設計したい

Redux Toolkit

Redux は「状態管理ライブラリ」の代名詞ですが、いま名前だけで避けられがちです。 避けられている理由は、素の Redux のボイラープレートが多かったことでした。Redux Toolkit は、そこを畳んだ公式の道具です。

それでも Zustand より書く量は多くなります。その代わりに手に入るのが、「変更が必ず action を通る」という制約です。

  • すべての変更に名前が付きます(cart/itemAdded のような)
  • DevTools で、変更の一覧を時系列で見られます。 巻き戻しもできます
  • 「誰がこれを変えたのか」を探す作業が、ほぼ消えます

5人で1つの画面を触っているなら、この制約は窮屈さより価値のほうが大きいことがあります。一人で作っているうちは、たいてい重いだけです。

Jotai

中央の箱を作りません。 atom という小さな粒を作って、必要なところで読みます。

「セレクタを書く」のではなく、「最初から小さく分かれている」という発想です。粒どうしを組み合わせて、「Aが変わったら自動で計算し直す粒」を作れます。

状態が細かく、しかも依存し合っているときに向きます。逆に、④が4本しかないなら、粒に分ける旨みがありません。

MobX

obj.count++ と書くと、それを見ている画面が勝手に更新されます。

書き味は一番短いです。 代わりに、「どこで変わったか」が一番見えにくくなります。 React の「状態は上から下へ流れる」という前提とも、考え方がずれます。

すでに MobX を使っているチームに入るなら覚える価値がありますが、いまから一人で始める理由は薄いというのが、私の結論です。


⑨ 入れる前のチェック

入れる前に、この3つを自分に聞きます。 1つでも「いいえ」なら、入れません。

1. Context で足りないと、測って分かったか

「なんとなく重そう」で入れないでください。

  • ④に振り分けた状態は、何本ありますか(数えましたか)
  • Context を分けても直らない再描画が、実際に起きていますか
  • その再描画は、Console の数字か Profiler で確認しましたか

この記事で数えたように、まず数えます。 ④が4本で、Context を3つに分けて足りているなら、入れる理由がありません。

2. サーバーのデータを入れようとしていないか

②の表に戻ってください。

  • 入れようとしている値の本当の持ち主は、サーバーですか
  • 「いつ取り直すか」を自分で書こうとしていませんか

「はい」なら、それはキャッシュの道具の担当です。 状態管理ライブラリを入れても、203行はそのまま残ります。

3. チームで合意があるか

一人でも、これは効きます。 半年後の自分は他人です。

  • 「④だけを入れる」というルールを、書き留めましたか
  • 入れたあと、「便利だから」とサーバーのデータやフォーム入力が流れ込むのを、誰が止めますか

状態管理ライブラリが破綻するのは、性能ではなく、この規律が崩れたときです。 私が最初に失敗したのも、ライブラリのせいではなく、全部そこに入れたからでした。

ストアは、置ける場所であって、置くべき場所ではありません。


⑩ 入れたあとに増える仕事

入れると減る仕事ばかり書かれますが、増える仕事もあります。 先に知っておきます。

1. 「どこで何が変わったか」が追いにくくなる

useState なら、その値を変えられるのは、その関数の中だけです。読めば分かります。

ストアは、アプリのどこからでも書き換えられます。 useUiStore.getState().pushNotice(...) は、React の外からでも呼べます。

「テーマが勝手に戻る」というバグを追うときに、探す範囲がアプリ全体になります。

対策は、書き換える口を絞ることです。

  • set を、コンポーネントから直接呼ばない。 ストアの中に定義した関数(toggleTheme など)だけを外に出す
  • 関数名を、起きたことの名前にする。 setTheme より toggleTheme、setNotices より pushNotice
  • getState() での書き換えは、React の外(通信のエラー処理など)だけに限る

2. DevTools の手当てが要る

Redux Toolkit には、最初から強い DevTools が付いています。 変更の一覧と巻き戻しが、入れた瞬間から使えます。

Zustand は、自分で繋ぎます。 devtools というミドルウェアを挟むと、Redux DevTools 拡張で見られるようになります。

import { create } from 'zustand'
import { devtools } from 'zustand/middleware'

export const useUiStore = create(devtools((set) => ({
  theme: 'light',
  toggleTheme: () => set((s) => ({ theme: s.theme === 'light' ? 'dark' : 'light' }), false, 'toggleTheme'),
})))

3つ目の引数 'toggleTheme' が、変更に付ける名前です。 これを書かないと、DevTools の履歴が全部「匿名の更新」になり、意味がなくなります。

この記事の練習では入れていません。 実際に使うときは、最初から入れておいたほうがいいです。あとから全部の set に名前を付けて回るのは、つらい作業です。

3. テストで、状態のリセットが要る

Context には、この問題がありません。 テストのたびに Provider で包み直すので、毎回まっさらから始まります。

ストアは、モジュールとして1つしかありません。 テストを2本続けて実行すると、1本目で変えた状態が、2本目に残ります。

「単体では通るのに、まとめて実行すると落ちる」という、一番読みにくい失敗の形になります。

対策は、テストごとに初期状態に戻すことです。 初期状態を別に持っておいて、各テストの前に書き戻します。この後片づけを1行足す、という決まりを最初に作っておきます。


つまずいたところ

1. 「必須」と書いてある記事を、疑わなかった

一番の遠回りがこれでした。

「Reactには状態管理ライブラリが必須」と読んで、何が問題なのかを確かめる前に入れました。 そして問題が起きていないのに解決策を入れたので、何が良くなったのかも分かりませんでした。

いま思えば、その記事が書かれた時期の問題もありました。 データ取得の道具が今ほど普及していなかった頃は、サーバーのデータも状態管理ライブラリに入れるのが普通でした。「必須」は、その時代には正しかったのだと思います。

古い記事が嘘なのではなく、前提が変わっていました。 「いつ書かれたか」を見るようになりました。

2. Zustand を入れたのに、速くならなかった

最初、こう書いていました。

const { theme } = useUiStore()

「動くから合っている」と思っていました。 Console の数字は、Context 版とまったく同じでした。

セレクタを渡していなかったからです。 引数なしで呼ぶと、ストア全体を購読します。

const theme = useUiStore((s) => s.theme)

この (s) => s.theme を書くために入れているライブラリでした。 書き忘れてもエラーは出ません。ただ遅いままです。

3. まとめて取り出したら、画面が落ちた

セレクタを覚えたので、こう書きました。

const { theme, sidebarOpen } = useUiStore((s) => ({ theme: s.theme, sidebarOpen: s.sidebarOpen }))

Maximum update depth exceeded で画面が落ちました。 毎回、新しいオブジェクトを作って返しているからです(v4 までは、全部再描画されるだけでした)。

Contextの回の value={{ a, b }} と、まったく同じ問題でした。 道具が変わっても、「毎回新しいオブジェクトを作ると、別物と判定される」というJavaScriptの性質は変わりません。

素直に2行に分けて解決しました。

4. ストアに useState の代わりをさせて、逆に読みにくくなった

セレクタが気持ちよかったので、モーダルの開閉やタブの選択も、次々にストアに移しました。

その画面でしか使わない状態まで、アプリ全体のストアに集まりました。 結果、uiStore.js が200行を超え、「この isEditing はどの画面のものか」が分からなくなりました。

1つの画面の中で完結する状態は、useState のままにします。 ストアに入れる基準は「遠い場所どうしが読み書きするか」であって、「便利かどうか」ではありません。

5. リロードするとテーマが戻る

当たり前でした。 ストアはメモリの中にあるので、リロードすれば消えます。

残したいなら、自分で保存します。 Zustand には persist というミドルウェアがあり、localStorage に自動で保存できます。

ただし、②の表を思い出してください。 「開いているタブ」を persist で保存するのは、URLに置くべきものを、間違った場所に永続化しているだけです。保存したくなったら、まず種類を疑います。


後片づけ

この記事の練習場を消します。 VMの中で実行します。

まず、npm run dev を止めます(Ctrl + C)。

bash
$ cd ~
$ rm -rf ~/reactlab
$ sudo ufw delete allow 5186/tcp
$ ls ~

確認: reactlab が消えていれば片づけ完了です。sudo ufw status に 5186/tcp が残っていないことも見ておきます。

消さずに残す場合は、src/main.jsx の StrictMode を必ず戻してください。 ①で数を数えるために外しました。外したまま開発を続けると、StrictMode が見つけてくれるはずのバグを見逃します。

import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'

createRoot(document.getElementById('root')).render(
  <StrictMode>
    <App />
  </StrictMode>
)

戻し方: もう一度やりたくなったら、①の npm create vite@latest reactlab -- --template react からやるだけです。数分で戻せます(node_modulesは消してよい)。


まとめ

  • 「Reactには状態管理ライブラリが必須」は、いまは正しくない。 前提が変わった古い記事が、そのまま残っている
  • 入れる前に、状態を4種類に分ける。 サーバーのデータ / URLの状態 / フォームの入力 / 本当のクライアント状態
  • 「ライブラリが要る」と思っているものの大半は、サーバーのデータ。 それはキャッシュの道具の担当で、状態管理の問題ではない
  • サーバーのデータをストアに入れると、「いつ取り直すか」を全部自分で書くことになる
  • URLの状態は、URLに置く。 ストアに置くと、リロードで戻り、戻るボタンが効かず、送ったリンクが別の画面を開く
  • フォームの入力は、その画面から出さない。 全体のストアに置くと、1文字ごとに全員が再描画される
  • 仕分けたあとに残るのは、4〜6本くらい。 テーマ・サイドバーの開閉・通知・認証情報
  • 4〜6本なら、まず Context。 Context を分けるだけで足りることは多い
  • Context の限界は1点だけ。セレクタが無いこと。 「この人には要らない」を判断できないので、値の数だけ Context が増える
  • Zustand は create でストアを1つ作るだけ。 値と更新関数を同じ場所に書く
  • set は上書きではなくマージ。 返したキーだけが差し替わる
  • セレクタ (s) => s.theme を書かないと、速くならない。 引数なしの useUiStore() はストア全体の購読で、Context 版と同じ
  • セレクタでオブジェクトを作って返すと、v5 では無限ループで落ちることがある(v4 までは全部再描画)。行を分けるのが一番安全。まとめるなら useShallow
  • Provider が要らない。 React の外からも getState() で触れる。便利であり、危なくもある
  • 他の選択肢は「別の書き方」ではなく「別の考え方」。 中央集権(Redux Toolkit)/ 原子(Jotai)/ 監視(MobX)
  • Redux Toolkit が売るのは短さではなく、制約。 全変更が action を通るので、履歴が追える。人数が多いときに効く
  • 入れる前の3つ: 測って足りないと分かったか / サーバーのデータではないか / ルールに合意があるか
  • 入れると仕事も増える。 変更元が追いにくくなる・DevTools を自分で繋ぐ・テストで状態を戻す
  • 1画面で完結する状態を、ストアに移さない。 基準は「遠い場所どうしが読み書きするか」
  • このサイトの方針: まず useState と Context で書く。困ったと測って分かってから Zustand。Redux Toolkit は、履歴を追う理由があるときだけ。

入れないことは、遅れていることではありません。

参考リンク


次に読む

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

記事
← 前の記事UIライブラリとヘッドレスUI — 自作モーダルはEscで閉じない
→ 次の記事Reactのテスト — 実装を直すたびに落ちる

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

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

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

Frontend›React — State Management
  • 状態を4種類に分けて、本当に残るものを数える
  • Zustand とセレクタ

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

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

コメント

コメントする

目次