/tasks/3 を直接開くと404 — ルーティング

Reactのルーティング。一覧と詳細のブラウザ画面、分岐する道と案内標識。

/tasks/3 を直接開くと404になるのは、そのURLの担当が決まっていないからです。React Routerを入れて、リロードしても正しい画面が出る状態にします。

前回: 状態管理はライブラリの話ではない — Contextまで 作業場所はVMの中(Ubuntu)、確認はホストの Windows のブラウザです。前回の ~/react-demo/ の続きです。

前回の最後に、こういう表を出しました。

種類例持ち主使う道具
URL の状態検索語、ページ番号、絞り込み条件URLルーター(次の段階以降で扱います)

その「ルーター」を、今日やります。

ですが、その前に確認したいことがあります。いま作っているタスクリストは、画面が1枚しかありません。 URL はずっと http://192.168.226.50:5173/ のままです。

画面が1枚しかないなら、ルーティングは要らないのでは? — これは正しい疑問です。そして、答えは「要らない」ではありません。

いまのアプリには、すでに3つの穴が開いています。

  • ブラウザの「戻る」ボタンが、何もしません。 押すと、アプリごと前のサイトへ出ていきます
  • 「この画面を見て」と人に送れません。 URL を送っても、相手には最初の画面が出ます
  • リロードすると、見ていた場所に戻れません

そして、この記事の山場は、そこではありません。

ルーティングを入れて画面を3枚にし、ビルドして配ると、/tasks/3 に直接アクセスした瞬間に 404 が出ます。

この罠は、ビルドツールの回で予告してあります。 あのときは「そういう罠がある、とだけ覚えておいてください」と書きました。今日、実際に起こして、直します。

対象レベル: 初級 / 区分: 必修

目次

この記事でわかること

  • 画面のURL(/tasks/3)と、APIのURL(/api/tasks/3)は、まったく別物だということ。似ているのは見た目だけで、返ってくるものも、作る人も違う
  • <a href> と <Link> は「見た目が同じで、中身が正反対」であること。<a href> を1つ混ぜると、そこだけページ全体が再読み込みされ、React が持っていた状態が全部消える
  • SPA の /tasks/3 は、サーバーから見れば「存在しないファイル」だということ。404 はサーバーのバグではなく、正しい返事である
  • 「見つかりません画面」と「404」は別物であること。React が出す「見つかりません」は、HTTP としては 200(成功)で返っている
  • npm run preview で確認しても、この罠は見つからないこと。preview はフォールバックを内蔵しているので、本番と違う挙動になる
  • URL は状態のひとつだということ。絞り込み条件を useState に入れた瞬間、その画面は人に送れなくなる

この記事でやること

  1. react-router-dom を入れ、いまの1画面を一覧 / 詳細 / 見つかりませんの3画面に分ける
  2. パスパラメータ /tasks/:id を useParams で受け取り、文字列で届くことを確かめる
  3. <Link> を一時的に <a href> に書き換え、状態が消えるところを自分の目で見る
  4. 絞り込みを useSearchParams で URL に持たせ、戻るボタンで絞り込みが戻ることを確かめる
  5. npm run build して静的に配り、/tasks/3 で 404 を出す。 そのうえで、サーバー側のフォールバックで直す

先に知る言葉

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

言葉意味
ルーティングURL を見て、どの画面を出すかを決めること
ルーターそのルーティングをやってくれる道具。ここでは react-router-dom
SPA(Single Page Application)HTMLファイルは1枚だけで、画面の切り替えを JavaScript がやるアプリ
クライアントサイドルーティング画面の切り替えを、サーバーに聞かずにブラウザの中だけで済ませること
パスパラメータURL の一部を変数として扱う場所。 /tasks/:id の :id
クエリ文字列URL の ? から後ろ。 ?filter=done のような「おまけの条件」
History APIブラウザが持っている「URL を、ページを読み込まずに書き換える」機能
フォールバック「見つからなかったときは、代わりにこれを返す」というサーバー側の設定
404HTTP の返事のひとつ。「そんなものは無い」という意味

① 準備 — 前回の続きから

VMの中で、前回のディレクトリに入ります。

bash
$ cd ~/react-demo
$ ls -R src
/home/user/react-demo/src:
App.css  App.jsx  assets  components  contexts  index.css  main.jsx  tasksReducer.js

/home/user/react-demo/src/components:
Board.jsx  Header.jsx  TaskForm.jsx  TaskItem.jsx  TaskList.jsx  TaskMeta.jsx  TaskSummary.jsx

/home/user/react-demo/src/contexts:
UserContext.js

この形になっていれば、前回の続きです。 違うときは前回からやり直してください。

前回の後片づけで 5173番を閉じました。 開け直します。今日は 8000番も使うので、まとめて開けます。

bash
$ sudo ufw allow 5173/tcp
$ sudo ufw allow 8000/tcp
$ sudo ufw status
Status: active

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

2行とも出ていることを確認してください。 開けずに進むと、起動は成功するのにブラウザは読み込み中のままになります。

起動します。

bash
$ npm run dev -- --host 0.0.0.0

ホストの Windows のブラウザで http://192.168.226.50:5173/(IPは自分の値に。分からなければ VM の中で ip a)を開き、前回のタスクリストが動いていることを確認してから先へ進んでください。

この記事の間は、起動したままで構いません。 止めるときはターミナルで Ctrl+C です。


② いま、何が困っているのか

「タスクをクリックすると、そのタスクの詳細画面が出る」を作りたくなったとします。ごく普通の要求です。

ルーターを知らないと、こう書きます。

// ❌ 打ち込まなくて構いません。「こう書きたくなる」という例です
function App() {
  const [tasks, dispatch] = useReducer(tasksReducer, initialTasks);
  const [selectedId, setSelectedId] = useState(null);   // ← いま何を見ているか

  if (selectedId !== null) {
    return <TaskDetail id={selectedId} onBack={() => setSelectedId(null)} />;
  }
  return <TaskListPage onSelect={setSelectedId} />;
}

これは動きます。 クリックすれば詳細が出て、「戻る」ボタンを自分で置けば一覧に戻れます。

そして、これで済ませてしまうと、次の3つが起きます。

困りごと1:ブラウザの「戻る」が、アプリごと出ていく

詳細画面を開いて、ブラウザの左上の「←」を押してください。

一覧に戻りません。 このサイトを開く前に見ていたページに戻ります。

理由は単純です。 URL が1ミリも変わっていないからです。 ブラウザにとって、「一覧」と「詳細」は同じ1ページです。戻る先が無いので、その前のサイトに戻ります。

これは、スマートフォンだと致命的です。多くの人が「戻る」で操作します。

困りごと2:いま見ている画面を、人に送れない

「このタスク、見といて」と URL を送ったとします。

相手のブラウザに出るのは、一覧の最初の画面です。selectedId は自分のブラウザのメモリの中にしかなく、URL には1文字も出ていないからです。

同じ理由で、こういうこともできません。

  • ブックマークに入れる
  • タブを複製して、2つの詳細を並べて見る
  • リロードして、同じ場所に戻る

困りごと3:どの画面を出しているかが、コードから読み取れない

selectedId !== null という条件で分岐しています。 画面が3枚、4枚と増えると、こうなります。

// ❌ 画面が増えるとこうなる
if (selectedId !== null) return <TaskDetail ... />;
if (showSettings) return <Settings ... />;
if (showHelp) return <Help ... />;
return <TaskListPage ... />;

「いまどの画面か」を表す状態が、3つに分かれました。 2つ同時に true になったらどうなるかは、上から順に読まないと分かりません。

3つとも、原因は1つ

「いまどの画面を見ているか」を、URL ではなく useState に持ったこと。

前回の表を、もう一度出します。

種類持ち主
URL の状態(いま見ている画面、絞り込み、ページ番号)URL

「いま見ている画面」は、URL が持つべき状態です。そして URL が持てば、戻るボタンも、共有も、ブックマークも、ブラウザが最初から持っている機能として、ただで付いてきます。

ルーターがやっているのは、これだけです。

URL を状態として扱い、その値に応じて、出すコンポーネントを切り替える。


③ react-router-dom を入れる

Ctrl+C で開発サーバーを一度止めて、VMの中で入れます。

bash
$ cd ~/react-demo
$ npm install react-router-dom

入ったことを確かめます。

bash
$ npm ls react-router-dom
react-demo@0.0.0 /home/user/react-demo
└── react-router-dom@7.1.1

バージョンの数字は違って構いません。 この記事の書き方は v6 でも v7 でも動きます。

[スクリーンショット: 01_react-router導入.png] npm install react-router-dom の実行後、npm ls react-router-dom の結果まで写るように撮ってください。バージョン番号が読める形で。

react-router と react-router-dom の2つが出てきますが、入れるのは -dom のほうです。 react-router が本体、react-router-dom が「ブラウザ用の皮」です。-dom を入れると本体も一緒に入ります。スマホアプリ(React Native)では別の皮を使うので、こう分かれています。

戻し方: npm uninstall react-router-dom で消えます。npmの回でやったとおり、node_modules/ は消してもやり直せます。

先に、id を作り直す

ルーティングを入れると、id が URL に出ます。 /tasks/1756891234567 です。

これは困ります。 前回、こう書きました。

本来 id は「見分けるためのもの」で、意味を持たせるべきではありません。

Date.now() を id にしたのは、その場しのぎでした。 URL に出るようになった以上、短くて、覚えられて、リロードしても同じ値のほうがいいです。

あわせて、最初から3件入った状態にします。 理由は、この記事の後半で「/tasks/3 に直接アクセスする」からです。毎回自分で3件打ち込むのは、確かめるときに面倒です。

src/tasksReducer.js を丸ごと置き換えます。

export const initialTasks = [
  { id: 1, title: "牛乳を買う", done: false },
  { id: 2, title: "ルーティングを試す", done: false },
  { id: 3, title: "ゴミを出す", done: true },
];

function nextId(tasks) {
  return tasks.reduce((max, t) => Math.max(max, t.id), 0) + 1;
}

export function tasksReducer(tasks, action) {
  switch (action.type) {
    case "added":
      return [...tasks, { id: nextId(tasks), title: action.title, done: false }];

    case "toggled":
      return tasks.map((t) =>
        t.id === action.id ? { ...t, done: !t.done } : t
      );

    case "removed":
      return tasks.filter((t) => t.id !== action.id);

    case "completedAll":
      return tasks.map((t) => ({ ...t, done: true }));

    case "clearedDone":
      return tasks.filter((t) => !t.done);

    default:
      throw new Error("知らない action.type です: " + action.type);
  }
}

nextId の中身に注目してください。

tasks.reduce((max, t) => Math.max(max, t.id), 0) + 1

「いまある id の最大値 + 1」です。カウンター用の変数をファイルの外側に置いて nextId++ とはしていません。

なぜか。 reducer は「同じ入力なら、いつでも同じ結果を返す関数」でなければいけないからです。 外の変数を書き換えると、その約束が壊れます。 そして前回出てきた <StrictMode> は、開発中に reducer をわざと2回呼びます。 nextId++ だと、呼ばれるたびに数字が飛びます。 必要な材料(tasks)から毎回計算するなら、何回呼ばれても結果は同じです。前回の「計算で出せるものを状態にしない」と、同じ話です。

この id の作り方は、本番では使いません。 2人が同時に追加したら、同じ id ができます。 本番では、サーバー側のデータベースが採番します。 ここでは「URL に出しても読める id」であれば十分です。

src/components/TaskMeta.jsx(丸ごと置き換え)

task.id から時刻を作っていた行が、意味を失いました(id が 1 では 1970年になります)。消します。

import { memo, useContext } from "react";
import { UserContext } from "../contexts/UserContext.js";

function TaskMeta({ task }) {
  const { user } = useContext(UserContext);

  return (
    <span className="meta">
      担当: {user} / id: {task.id}
    </span>
  );
}

export default memo(TaskMeta);

id を表示に出したのは、この後 URL と見比べるためです。

src/main.jsx(丸ごと置き換え)

ここが、ルーターの入口です。

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

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

<BrowserRouter> で <App /> を囲みました。 前回の <UserContext.Provider> と、まったく同じ形です。

やっていることも、実は同じです。 <BrowserRouter> は「いまの URL」を Context で配っているだけです。この内側にいるコンポーネントだけが、useParams や <Link> を使えます。 前回「Provider の外で読むと黙って既定値になる」と書きました。 ルーターの場合はもっと分かりやすく、useNavigate() may be used only in the context of a <Router> component とエラーが出ます。

BrowserRouter の「Browser」は、「ブラウザの History API を使う」という意味です。あとで出てくる HashRouter との対比なので、覚えておいてください。


④ 画面を3枚に分ける

ここから、ファイルを4つ作ります。

ファイル役割
src/pages/TaskListPage.jsx(新規)一覧の画面(/)
src/pages/TaskDetailPage.jsx(新規)1件の詳細(/tasks/:id)
src/pages/NotFoundPage.jsx(新規)知らないURLだったとき
src/App.jsx(書き換え)URL と画面の対応表を書く場所
src/components/TaskItem.jsx(書き換え)詳細へのリンクを足す
src/index.css(書き換え)見た目

pages/ という名前に、React 側の決まりはありません。 components/ と分けたのは、「画面まるごと」と「画面の部品」を見た目で区別できるようにするためです。多くのプロジェクトがこう分けています。

ディレクトリを作ります。

bash
$ mkdir -p ~/react-demo/src/pages

src/pages/TaskListPage.jsx(新規)

import Board from "../components/Board.jsx";
import TaskForm from "../components/TaskForm.jsx";
import TaskSummary from "../components/TaskSummary.jsx";
import TaskList from "../components/TaskList.jsx";

function TaskListPage({ tasks, dispatch }) {
  return (
    <Board>
      <TaskForm onAdd={(title) => dispatch({ type: "added", title })} />
      <TaskSummary tasks={tasks} />
      <TaskList
        tasks={tasks}
        onToggle={(id) => dispatch({ type: "toggled", id })}
        onRemove={(id) => dispatch({ type: "removed", id })}
      />
      <div className="bulk">
        <button onClick={() => dispatch({ type: "completedAll" })}>
          全部完了にする
        </button>
        <button onClick={() => dispatch({ type: "clearedDone" })}>
          完了したものを消す
        </button>
      </div>
    </Board>
  );
}

export default TaskListPage;

中身は、前回の App の return から切り出しただけです。新しいものは1つもありません。

src/pages/TaskDetailPage.jsx(新規)

この記事の主役です。

import { Link, useParams } from "react-router-dom";
import TaskMeta from "../components/TaskMeta.jsx";

function TaskDetailPage({ tasks, dispatch }) {
  const { id } = useParams();
  const task = tasks.find((t) => String(t.id) === id);

  if (!task) {
    return (
      <div className="board">
        <h2>そのタスクはありません</h2>
        <p className="empty">URL に書かれた id: {id}</p>
        <p>
          <Link to="/">← 一覧に戻る</Link>
        </p>
      </div>
    );
  }

  return (
    <div className="board">
      <h2 className={task.done ? "done" : ""}>{task.title}</h2>
      <p>状態: {task.done ? "完了" : "未完了"}</p>
      <TaskMeta task={task} />
      <p>
        <button onClick={() => dispatch({ type: "toggled", id: task.id })}>
          {task.done ? "未完了に戻す" : "完了にする"}
        </button>
      </p>
      <p>
        <Link to="/">← 一覧に戻る</Link>
      </p>
    </div>
  );
}

export default TaskDetailPage;

説明することが3つあります。

1つめ。useParams() が返すのはオブジェクトです。

const { id } = useParams();

/tasks/3 を開いていたら、{ id: "3" } が返ります。 id という名前は、次の節で path="/tasks/:id" と書いたときの :id から来ています。 :名前 と書いた場所が、そのまま useParams() のキーになります。

2つめ。ここが一番よく事故ります。

const task = tasks.find((t) => String(t.id) === id);

useParams() が返す値は、必ず文字列です。 URL は文字の列なので、3 と "3" を区別する方法がありません。数字に見えても、届くのは "3" です。

だから、こう書くと永久に見つかりません。

const task = tasks.find((t) => t.id === id);   // ❌ 1 === "3" ではなく、1 === "1" でも false

t.id は数値の 1、id は文字列の "1"。=== は false を返します。 JavaScriptの回でやった「"1" と 1 は等しいのか」が、ここで牙をむきます。

直し方は2つです。どちらでも構いません。

書き方やっていること
String(t.id) === id数値を文字列にしてから比べる(この記事はこちら)
t.id === Number(id)文字列を数値にしてから比べる

==(イコール2つ)で比べる、はやめてください。 一見うまくいきますが、前に見たとおり、== は他の場面で嘘をつきます。

3つめ。「見つからなかったとき」を必ず書くこと。

/tasks/999 は、誰でも打ち込めます。 書かないと task が undefined になり、次の行の task.title で Cannot read properties of undefined が出て、画面が真っ白になります。

URL は、ユーザーが自由に書き換えられる入力欄です。<input> に何を入れられるか分からないのと、まったく同じです。「そんな id は無い」は、必ず来ます。

src/pages/NotFoundPage.jsx(新規)

import { Link } from "react-router-dom";

function NotFoundPage() {
  return (
    <div className="board">
      <h2>ページが見つかりません</h2>
      <p className="empty">そのURLに対応する画面はありません。</p>
      <p>
        <Link to="/">← 一覧に戻る</Link>
      </p>
    </div>
  );
}

export default NotFoundPage;

src/App.jsx(丸ごと置き換え)

import { useReducer, useState, useMemo } from "react";
import { Routes, Route } from "react-router-dom";
import { UserContext } from "./contexts/UserContext.js";
import { tasksReducer, initialTasks } from "./tasksReducer.js";
import Header from "./components/Header.jsx";
import TaskListPage from "./pages/TaskListPage.jsx";
import TaskDetailPage from "./pages/TaskDetailPage.jsx";
import NotFoundPage from "./pages/NotFoundPage.jsx";

function App() {
  const [tasks, dispatch] = useReducer(tasksReducer, initialTasks);
  const [user, setUser] = useState("たろう");

  const userValue = useMemo(() => ({ user, setUser }), [user]);

  return (
    <UserContext.Provider value={userValue}>
      <div className="app">
        <Header user={user} />

        <Routes>
          <Route path="/" element={<TaskListPage tasks={tasks} dispatch={dispatch} />} />
          <Route path="/tasks/:id" element={<TaskDetailPage tasks={tasks} dispatch={dispatch} />} />
          <Route path="*" element={<NotFoundPage />} />
        </Routes>

        <button
          className="switch"
          onClick={() => setUser(user === "たろう" ? "はなこ" : "たろう")}
        >
          使う人を切り替える
        </button>
      </div>
    </UserContext.Provider>
  );
}

export default App;

<Routes> の3行が、この記事のすべてです。「この URL のときは、この画面」という対応表でしかありません。

書いたもの意味
path="/"ちょうど / のとき
path="/tasks/:id"/tasks/ の後ろに何か1つあるとき。 その何かが id という名前で受け取れる
path="*"上のどれにも当てはまらないとき。 順番ではなく「一致度」で選ばれるので、一番下に書かなくても動きますが、読みやすさのために一番下に書きます

そして、<Routes> の外に注目してください。

<Header user={user} />
<Routes> ... </Routes>
<button className="switch"> ... </button>

<Routes> の外に書いたものは、どの画面でも消えません。 ヘッダーと「使う人を切り替える」ボタンは、詳細画面に移っても出たままです。「画面ごとに変わる部分」だけを <Routes> の中に入れる、という考え方です。

もう1つ、重要なことがあります。

tasks は、いまも App が持っています。 画面を移っても、状態は消えません。 App は <Routes> の外にいるので、URL が変わっても App は作り直されないからです。前回までに作った状態の置き場所は、1つも変わっていません。

src/components/TaskItem.jsx(丸ごと置き換え)

一覧から詳細へ行く道を作ります。

import { Link } from "react-router-dom";
import TaskMeta from "./TaskMeta.jsx";

function TaskItem({ task, onToggle, onRemove }) {
  return (
    <li>
      <span
        onClick={() => onToggle(task.id)}
        className={task.done ? "done" : ""}
      >
        {task.title}
      </span>
      <Link to={`/tasks/${task.id}`} className="detail">詳細</Link>
      <button onClick={() => onRemove(task.id)}>削除</button>
      <TaskMeta task={task} />
    </li>
  );
}

export default TaskItem;

to={/tasks/${task.id}} のバッククォートはテンプレートリテラルです。task.id が 3 なら /tasks/3 という文字列になります。

src/index.css(丸ごと置き換え)

body {
  font-family: sans-serif;
  margin: 2rem;
  line-height: 1.7;
}

.done {
  text-decoration: line-through;
  color: #888;
}

li span {
  cursor: pointer;
}

.empty {
  color: #888;
}

.header {
  border-bottom: 1px solid #ddd;
  margin-bottom: 1rem;
}

.who {
  color: #666;
  font-size: 0.9rem;
  margin-top: -0.5rem;
}

.board {
  border: 1px solid #ddd;
  border-radius: 6px;
  padding: 1rem;
}

.meta {
  display: block;
  color: #999;
  font-size: 0.8rem;
  cursor: auto;
}

.switch {
  margin-top: 1rem;
}

.bulk {
  margin-top: 1rem;
  display: flex;
  gap: 0.5rem;
}

.detail {
  margin-left: 0.5rem;
  font-size: 0.85rem;
}

.filters {
  display: flex;
  gap: 0.5rem;
  margin-bottom: 0.5rem;
}

.filters は、この後⑥で使います。 先に入れておきます。

動かす

bash
$ npm run dev -- --host 0.0.0.0

ブラウザで、次の順に確かめてください。

  1. 一覧に3件出ている(牛乳を買う / ルーティングを試す / ゴミを出す)
  2. 「ルーティングを試す」の横の「詳細」を押す → URL が /tasks/2 に変わり、詳細画面が出る
  3. 「完了にする」を押す → 取り消し線が付く
  4. 「← 一覧に戻る」で戻る → 一覧でも、そのタスクに取り消し線が付いている
  5. ブラウザの「←」(戻る)を押す → 詳細画面に戻る。今度はアプリの中で動く
  6. アドレスバーに直接 /tasks/99 と打つ → 「そのタスクはありません」
  7. アドレスバーに直接 /zzz と打つ → 「ページが見つかりません」

[スクリーンショット: 02_詳細画面.png] /tasks/2 の詳細画面を撮ってください。アドレスバーの /tasks/2 と、画面の「id: 2」が両方写る形で。

3と4に注目してください。 詳細画面で押した「完了にする」が、一覧にも反映されています。 tasks は App が1つだけ持っているからです。画面が2枚になっても、信頼できる唯一の情報源は1つのままです。

6と7の違いも重要です。

URL出る画面誰が判断したか
/tasks/99そのタスクはありませんTaskDetailPage。ルートには一致している。データが無かった
/zzzページが見つかりませんルーター。どのルートにも一致しなかった

似た文言ですが、原因が全然違います。 前者は「URL の形は正しいが、中身が無い」、後者は「URL の形からして知らない」です。


⑤ <a href> を使わない理由

<Link to="/"> を見て、こう思ったはずです。

「<a href="/"> でいいのでは?」

見た目は同じです。 実際、ブラウザに出来上がるのも <a> タグです。それでも、絶対に <a href> にしてはいけません。

実際に壊す

src/pages/NotFoundPage.jsx の <Link to="/"> を、一時的に <a href="/"> に書き換えます。

// ❌ 一時的に、わざとこうします
import { Link } from "react-router-dom";

function NotFoundPage() {
  return (
    <div className="board">
      <h2>ページが見つかりません</h2>
      <p className="empty">そのURLに対応する画面はありません。</p>
      <p>
        <a href="/">← 一覧に戻る(a href版)</a>
      </p>
    </div>
  );
}

export default NotFoundPage;

import { Link } は残したままで構いません。 使っていない import があっても動きます(Console に警告が出ることはあります)。すぐ戻すので、そのままにします。

確かめる手順は、ここが肝心です。

  1. 一覧で、新しいタスクを1件追加してください(例: 「これは消えるはず」)。4件になります
  2. 「使う人を切り替える」を押して、「はなこ」にしてください
  3. 開発者ツールの Console で history.pushState(null, "", "/zzz"); dispatchEvent(new PopStateEvent("popstate")); と打って、「ページが見つかりません」を出す(アドレスバーに直接打つとページ全体が読み込み直され、<a href> を押す前に状態が消えてしまうため)
  4. 「← 一覧に戻る(a href版)」を押す

何が起きたか。

  • 画面が一瞬、白く点滅しました
  • 追加した4件目が消えています。3件に戻っています
  • 「ログイン中」が「たろう」に戻っています

[スクリーンショット: 03_aタグで状態が消える.png] a href のリンクで戻った直後の画面を撮ってください。タスクが3件に戻り、ヘッダーが「ログイン中: たろう」に戻っているのが分かる形で。

何が起きたのか

<a href> は、ブラウザに「そのURLを、サーバーに取りに行け」と命令します。 ブラウザは、いま動いている JavaScript を全部捨てて、HTMLを取り直し、React を最初から起動し直します。

React が持っていた tasks も user も、JavaScript の変数でしかありません。 ページを読み込み直せば、変数は初期値に戻ります。

<Link> は、これをやりません。

<a href="/tasks/3">   ブラウザが動く → サーバーに取りに行く → 全部作り直し → 状態が消える
<Link to="/tasks/3">  React が動く   → URL だけ書き換える     → 画面だけ差し替え → 状態は残る

<Link> の中身は、だいたいこういうことをしています。

  1. <a> タグとして表示する(だから右クリックで「新しいタブで開く」も効くし、読み上げソフトもリンクとして読む)
  2. クリックされたら e.preventDefault() で、ブラウザ本来の動きを止める
  3. History API で、URL の表示だけを書き換える
  4. React に「URL が変わった」と伝え、対応する画面に差し替える

2の e.preventDefault() は、DOM操作の回と前回のフォームで出てきたものです。同じ道具が、ここでも効いています。

重要なのは、3です。 History API は「URL の表示を書き換える」だけで、サーバーには何も聞きません。 これが、この後の 404 の直接の原因になります。ブラウザのアドレスバーに /tasks/3 と出ていても、そのURLをサーバーに要求したことは一度もないからです。

使い分け

行き先使うもの
同じアプリの中の画面<Link to="...">
外部サイト(ja.react.dev など)<a href="...">。ルーターは関係ない
ファイルのダウンロード、PDF<a href="...">。React で表示するものではない

<a href> を使うこと自体が悪いのではありません。 「アプリの中の移動なのに <a href> を使う」のが事故です。

戻してください。

        <Link to="/">← 一覧に戻る</Link>

Header.jsx の <h1>やること</h1> も、<Link to="/"> で包むと、どの画面からでも一覧に戻れるようになります。 余力があればやってみてください。この記事では触りません。


⑥ URL も状態のひとつ — 絞り込みをURLに置く

機能を1つ足します。 「すべて / 未完了 / 完了」の絞り込みです。

ここで、前回からの問いを繰り返します。

useState に入れる前に「これ、リンクで共有したい情報ではないか」と聞いてください。

絞り込み条件は、共有したい情報です。 「未完了だけの一覧、これ見といて」は、普通に起きます。

そして、URL に置くための道具が useSearchParams です。

src/pages/TaskListPage.jsx(丸ごと置き換え)

import { useSearchParams } from "react-router-dom";
import Board from "../components/Board.jsx";
import TaskForm from "../components/TaskForm.jsx";
import TaskSummary from "../components/TaskSummary.jsx";
import TaskList from "../components/TaskList.jsx";

function TaskListPage({ tasks, dispatch }) {
  const [searchParams, setSearchParams] = useSearchParams();
  const filter = searchParams.get("filter") || "all";

  const shown = tasks.filter((t) => {
    if (filter === "done") return t.done;
    if (filter === "todo") return !t.done;
    return true;
  });

  return (
    <Board>
      <TaskForm onAdd={(title) => dispatch({ type: "added", title })} />

      <div className="filters">
        <button onClick={() => setSearchParams({})}>すべて</button>
        <button onClick={() => setSearchParams({ filter: "todo" })}>未完了</button>
        <button onClick={() => setSearchParams({ filter: "done" })}>完了</button>
      </div>

      <TaskSummary tasks={tasks} />
      <TaskList
        tasks={shown}
        onToggle={(id) => dispatch({ type: "toggled", id })}
        onRemove={(id) => dispatch({ type: "removed", id })}
      />
      <div className="bulk">
        <button onClick={() => dispatch({ type: "completedAll" })}>
          全部完了にする
        </button>
        <button onClick={() => dispatch({ type: "clearedDone" })}>
          完了したものを消す
        </button>
      </div>
    </Board>
  );
}

export default TaskListPage;

useSearchParams は、useState にそっくりな形をしています。

useStateuseSearchParams
読むconst [filter] = useState("all")searchParams.get("filter")
書くsetFilter("done")setSearchParams({ filter: "done" })
値の置き場所メモリ。リロードで消えるURL。共有できる・戻れる・残る

searchParams.get("filter") が null を返すのは、?filter=... が付いていないときです。だから || "all" で既定値にしています。

TaskSummary には、絞り込む前の tasks を渡していることに注意してください。「未完了だけ表示中でも、全体の件数は全体のまま」にするためです。どちらが正しいかは仕様次第ですが、「何を数えているのか」を決めるのは自分です。

確かめる

  1. 「未完了」を押す → URL が /?filter=todo になり、完了済みの「ゴミを出す」が消える
  2. 「完了」を押す → /?filter=done になり、「ゴミを出す」だけになる
  3. ブラウザの「←」(戻る)を押す → /?filter=todo に戻り、表示も戻る
  4. その URL をコピーして、別のタブに貼る → 同じ絞り込みで開く

[スクリーンショット: 04_URLに絞り込みが出る.png] 「完了」で絞り込んだ状態を撮ってください。アドレスバーの ?filter=done と、1件だけの一覧が同時に写る形で。

3が、この節のすべてです。「戻る」で絞り込みが戻りました。 これを useState で作ると、自分で履歴を管理することになります。 URL に置いたので、ブラウザがただでやってくれています。

何を URL に置き、何を置かないか

全部 URL に置けばいい、という話ではありません。

例どこに置くか
いま見ている画面、詳細の idURL のパス(/tasks/3)
絞り込み、並び順、ページ番号、検索語URL のクエリ(?filter=done&page=2)
入力途中の文字useState。1文字打つたびに URL が変わるのは異常
メニューが開いているかuseState。共有する意味がない
ログイン用のトークン、パスワード絶対に URL に置かない(後述)

URL は、あちこちに残ります。 ブラウザの履歴、サーバーのアクセスログ、リンク元として次のサイトに送られる情報。 認証の回で扱うトークンのような秘密を URL に入れると、それが全部に残ります。 「共有していい情報だけを URL に置く」が判断基準です。


⑦ 画面のURLと、APIのURLは別物

ここで、混同しやすいものを整理します。

REST APIの回で、こういうURLを設計しました。

GET /api/tasks/3

今日作ったのは、これです。

/tasks/3

そっくりです。 そして、まったくの別物です。

画面のURL /tasks/3APIのURL /api/tasks/3
誰が開くか人間。ブラウザのアドレスバーに出るプログラム。fetch が呼ぶ
返ってくるものHTML(正確には、後述のとおり index.html 1枚)JSON
決めるのは誰かフロントエンドの担当(<Route path=...>)バックエンドの担当(サーバーのコード)
一致している必要はありません。まったく別に決めて構いません同上

この2つが「たまたま似ている」のは、どちらも「タスクの3番」を指しているからです。似せて書くのは読みやすさのためであって、決まりではありません。

実際、こういう組み合わせは普通にあります。

画面: /tasks/3            → API: /api/v1/todo-items/3
画面: /u/taro/posts/12    → API: /api/posts/12

なぜ、ここを強調するのか。 「画面のURLを変えたらAPIも変えないといけないのでは」と考えて、手が止まる人がいるからです。関係ありません。 逆も同じです。 API のパスを /api/v2/... に変えても、画面のURLは1文字も変わりません。

将来、この2つは同じサーバーが返すことになります。

/api/ で始まるもの   → API のプログラムに渡す(JSON が返る)
それ以外            → dist/ の中の静的ファイルを返す

この振り分けをやるのが、nginx のリバースプロキシです。第6段階でやったことが、ここで繋がります。


⑧ ビルドして配ると、404が出る

ここからが、この記事の本番です。

ビルドツールの回で、こう予告しました。

ページ内でURLを切り替えるタイプのアプリ(SPA)を配ると、/about に直接アクセスしたときに 404 になります。 今は「そういう罠がある」とだけ覚えておいてください。

いま、まさに「ページ内でURLを切り替えるタイプのアプリ」を作りました。 起こします。

まず、ビルドする

開発サーバーを Ctrl+C で止めて、VMの中で、

bash
$ cd ~/react-demo
$ npm run build
vite v7.0.4 building for production...
✓ 62 modules transformed.
dist/index.html                   0.46 kB │ gzip:  0.30 kB
dist/assets/index-BjK2p0Lq.css    1.31 kB │ gzip:  0.62 kB
dist/assets/index-Cw8tRn5X.js   235.18 kB │ gzip: 76.04 kB
✓ built in 1.42s

中身を見ます。

bash
$ ls -R dist
dist:
assets  index.html  vite.svg

dist/assets:
index-BjK2p0Lq.css  index-Cw8tRn5X.js

ここを、よく見てください。 tasks というディレクトリは、ありません。 tasks/3 というファイルも、ありません。 index.html が1枚と、JS と CSS が1本ずつ。それだけです。ビルドツールの回で見たものと、何も変わっていません。

画面は3枚あるはずなのに、HTMLは1枚しかない。 これが SPA(Single Page Application、ページ1枚のアプリ)という名前の意味です。

静的に配る

ビルドツールの回と同じやり方で配ります。 Vite も npm も使いません。

bash
$ cd ~/react-demo/dist
$ python3 -m http.server 8000 --bind 0.0.0.0

ホストのブラウザで http://192.168.226.50:8000/ を開いてください。

普通に動きます。 一覧が出て、「詳細」を押せば /tasks/2 に移り、詳細画面も出ます。 戻るボタンも効きます。

ここまでは、開発サーバーと何も変わりません。

そして、壊す

/tasks/2 を表示したまま、ブラウザの再読み込み(F5)を押してください。

Error response

Error code: 404

Message: File not found.

Error code explanation: 404 - Nothing matches the given URI.

アドレスバーに直接 http://192.168.226.50:8000/tasks/3 と打っても、同じです。

[スクリーンショット: 05_直接アクセスで404.png] /tasks/3 に直接アクセスして 404 が出ている画面を撮ってください。アドレスバーのURLが読める形で。

VMのターミナルも見てください。 python3 -m http.server が、何が起きたかを1行で出しています。

192.168.226.60 - - [05/Sep/2026 14:22:31] "GET / HTTP/1.1" 200 -
192.168.226.60 - - [05/Sep/2026 14:22:31] "GET /assets/index-Cw8tRn5X.js HTTP/1.1" 200 -
192.168.226.60 - - [05/Sep/2026 14:23:02] code 404, message File not found
192.168.226.60 - - [05/Sep/2026 14:23:02] "GET /tasks/3 HTTP/1.1" 404 -

なぜ、リンクで行けたのに、リロードすると死ぬのか

この差が、すべてです。

やったことサーバーへの要求結果
一覧から「詳細」を押した無し。 <Link> は History API で URL を書き換えただけJS が中で画面を差し替えた。動く
/tasks/3 をリロードしたGET /tasks/3 が飛ぶそんなファイルは無い → 404

サーバーは、正しく答えています。 dist/ の中に tasks/3 というファイルはありません。 「無い」と言うのが、サーバーの正しい仕事です。 ルーティングの表(<Route path="/tasks/:id">)は、index.html が読み込む JavaScript の中に書いてあります。 その JavaScript は、index.html が返ってきて初めて動きます。 index.html が返らなければ、React は起動すらしていません。

順番で書くと、こうです。

リロード
 └─ ブラウザ:「/tasks/3 をください」
     └─ サーバー: dist/tasks/3 を探す → 無い → 404
         └─ React は1行も動いていない
             └─ ルーティングの表を読む機会が、そもそも無い

「React のルーティングが壊れている」のではありません。 React にたどり着く前に終わっています。

npm run preview では見つからない

ここが、この罠のいやらしいところです。

Ctrl+C で止めて、Vite の preview で試してください。

bash
$ cd ~/react-demo
$ npm run preview -- --host 0.0.0.0

http://192.168.226.50:4173/tasks/3 を開くと — 動きます。 404 になりません。

npm run preview は、この後やる「フォールバック」を最初から内蔵しているからです。npm run dev も同じです。 つまり、開発中も preview も、この問題を隠してくれます。 本番に置いた瞬間に、初めて出ます。

ビルドツールの回で「npm run dev で動くのに npm run preview で壊れる、はよくあります」と書きました。 その1段上があった、ということです。

preview で動いた = 本番で動く、ではありません。 preview が確かめてくれるのは「ビルドしたJSが正しく動くか」までで、「配るサーバーの設定が正しいか」は確かめていません。

Ctrl+C で preview を止めてください。


⑨ 直す — 「見つからなければ index.html を返す」

直し方は、React 側ではありません。配るサーバー側です。

dist/ の中に無いURLを要求されたら、404 を返さずに index.html を返す。

これで何が起きるか。

ブラウザ:「/tasks/3 をください」
 └─ サーバー: 無い → でも index.html を返す(200 OK)
     └─ ブラウザ: HTML を読む → JS を読む → React 起動
         └─ React:「いまのURLは /tasks/3 だな」→ TaskDetailPage を出す

アドレスバーは /tasks/3 のままです。 React は起動したあとで、自分でURLを見て、正しい画面を選びます。

この「見つからなければ index.html」を、フォールバックと呼びます。

手を動かして直す

python3 -m http.server には、この設定がありません。 15行ほど書けば作れるので、書きます。

VMの中で、~/react-demo/spa-server.py を新規作成します。

import http.server
import os
import socketserver

PORT = 8000
ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "dist")


class SpaHandler(http.server.SimpleHTTPRequestHandler):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, directory=ROOT, **kwargs)

    def do_GET(self):
        if not os.path.exists(self.translate_path(self.path)):
            self.path = "/index.html"
        return super().do_GET()


socketserver.TCPServer.allow_reuse_address = True

with socketserver.TCPServer(("0.0.0.0", PORT), SpaHandler) as httpd:
    print("http://0.0.0.0:" + str(PORT) + "/ で dist を配っています (Ctrl+C で停止)")
    httpd.serve_forever()

やっていることは、真ん中の4行だけです。

    def do_GET(self):
        if not os.path.exists(self.translate_path(self.path)):
            self.path = "/index.html"
        return super().do_GET()

「要求されたパスに、実際のファイルが無ければ、/index.html を要求されたことにする」。それだけです。

動かします。 dist/ の中ではなく、~/react-demo/ で打ちます。

bash
$ cd ~/react-demo
$ python3 spa-server.py
http://0.0.0.0:8000/ で dist を配っています (Ctrl+C で停止)

ブラウザで http://192.168.226.50:8000/tasks/3 を、直接開いてください。

「ゴミを出す」の詳細画面が出ます。

[スクリーンショット: 06_フォールバック後.png] /tasks/3 に直接アクセスして詳細画面が出ているところを撮ってください。アドレスバーの /tasks/3 が読める形で。

ターミナルのログも見てください。 さっき 404 だった行が、200 に変わっています。

192.168.226.60 - - [05/Sep/2026 14:31:10] "GET /tasks/3 HTTP/1.1" 200 -

/zzz も試してください。 「ページが見つかりません」の画面が出ます。

ここが、初心者が必ず引っかかる点です。 /zzz の HTTP の返事は、404 ではなく 200(成功)です。 サーバーは index.html を「正しく」返しているからです。 画面には「ページが見つかりません」と出ているのに、200。 開発者ツールの Network タブで確かめられます。 これは SPA の避けがたい弱点です。検索エンジンには「そのページは存在する」と見えます。 本気で直すには、サーバー側でHTMLを組み立てる仕組み(SSR)が要ります。この記事の範囲を超えるので、「そういう限界がある」とだけ覚えてください。

Ctrl+C で止めてください。

本番では、nginx の1行で済む

Python で書いたのは、仕組みを見るためです。実際の本番では、第6段階の nginx が、これを1行でやります。

location / {
    root /var/www/react-demo;
    try_files $uri $uri/ /index.html;
}

try_files の読み方は、そのまま「順に試す」です。

順番試すもの
1$uri — 要求されたパスのファイル(/assets/index-Cw8tRn5X.js など)
2$uri/ — 同じ名前のディレクトリ
3/index.html — どれも無ければ、これを返す

さっき Python で書いた if not os.path.exists(...) と、まったく同じことです。書く場所と量が違うだけです。

1と2を先に試すのが重要です。 いきなり全部 index.html にすると、JS も CSS も画像も index.html になります。 その症状は「真っ白な画面 + Console に Uncaught SyntaxError: Unexpected token '<'」です。JavaScript のつもりで HTML を読まされている、という意味です。

他の直し方

やり方内容使うとき
サーバー側のフォールバック上のとおり。本命サーバーの設定を触れるとき
HashRouter に変えるURL が /#/tasks/3 になる。# より後ろはサーバーに送られないので、要求されるのは常に /。設定が一切要らないサーバーの設定を触れないとき(社内の共有フォルダに置くだけ、など)
ホスティングサービスの設定ファイルNetlify なら _redirects、Vercel なら vercel.json で同じことを指定するそのサービスを使うとき

HashRouter は、main.jsx の BrowserRouter を差し替えるだけで試せます。

import { HashRouter } from 'react-router-dom'

URL が http://192.168.226.50:8000/#/tasks/3 のように、# 付きになります。 見た目が悪く、検索エンジンにも扱いにくいので、選べるなら BrowserRouter + フォールバックです。試したら戻してください。

なぜ # だと大丈夫なのか。 # から後ろは「フラグメント」と呼ばれ、HTTP の要求に含まれません。 ブラウザの中だけで完結します。 サーバーから見れば、いつでも / を要求されているだけです。だから 404 になりようがありません。


⑩ もう1つの「動くのに壊れている」

フォールバックを入れて安心したところで、もう1つあります。

/tasks/3 を直接開いた画面を、よく見てください。

動いてはいます。 ですが、この記事の最初に自分で追加したタスクは、どこにもありません。 initialTasks の3件だけです。

URL は共有できるようになりました。 データは、まだ共有できていません。 tasks は useReducer の中、つまりブラウザのメモリにしかありません。 リロードすれば初期値に戻り、他人のブラウザにはそもそも存在しません。

これは、ルーティングでは解けません。 前回の表の、この行です。

種類持ち主使う道具
サーバーの状態(実体はキャッシュ)サーバーTanStack Query / SWR

/tasks/3 を開いたら、APIから3番を取ってくる。 そうして初めて、URL が本当に共有できるものになります。

やるべきことは、はっきりしています。

  1. サーバーがタスクを保存する
  2. REST API が /api/tasks/3 で1件返す
  3. TaskDetailPage が、useParams() で得た id を使って fetch する

3の入り口が、今日できました。 useParams() が返す id は、そのまま API のURLに埋める材料です。

// この先、こうなります(今日は書きません)
const { id } = useParams();
// fetch(`/api/tasks/${id}`) → JSON を受け取って表示する

「URL から id を取り出す」ところまでが、今日の仕事です。


つまずいたところ

useNavigate() may be used only in the context of a <Router> component → main.jsx の <BrowserRouter> が抜けています。 <Link> も useParams も、<BrowserRouter> の内側でしか使えません。

Failed to resolve import "react-router-dom" → npm install react-router-dom を打っていないか、別のディレクトリで打っています。 cd ~/react-demo してから打ち直してください。npm ls react-router-dom で確かめられます。

詳細画面が、必ず「そのタスクはありません」になる → t.id === id で比べています。 useParams() が返すのは文字列です。String(t.id) === id にしてください。 ④で書いたとおりです。

Cannot read properties of undefined (reading 'title')(詳細画面で) → if (!task) を書いていません。 /tasks/999 のような、存在しない id が来たときに落ちます。

<Route> を書いたのに、画面が真っ白 → <Route> を <Routes> で囲んでいますか。 <Routes> の直接の子は <Route> だけです。間に <div> を挟むと動きません。

詳細画面に移ると、ヘッダーまで消える → <Header /> を <Routes> の中に入れています。 どの画面でも出したいものは、<Routes> の外に置きます。

「詳細」を押すと、追加したタスクが全部消える → <Link to=...> ではなく <a href=...> になっています。 ⑤のとおりです。

リロードすると 404(python3 -m http.server で配っているとき) → 正常です。 ⑧の症状そのものです。⑨の spa-server.py で配り直してください。

spa-server.py を動かしたが dist が見つからない、と出る → npm run build をしていないか、~/react-demo/ 以外の場所に置いています。 spa-server.py は dist/ と同じ階層(~/react-demo/)に置いてください。

OSError: [Errno 98] Address already in use → さっきの python3 -m http.server が、まだ動いています。 そのターミナルで Ctrl+C を押すか、pkill -f http.server で止めてください。プロセスの回でやった話です。

画面が真っ白で、Console に Uncaught SyntaxError: Unexpected token '<' → フォールバックが効きすぎています。 JS や CSS まで index.html を返しています。 「実在するファイルは、そのまま返す」を先に書いてください(nginx なら try_files $uri $uri/ /index.html; の $uri の部分)。

ホストのブラウザから 8000番に繋がらない → sudo ufw allow 8000/tcp の忘れか、--bind 0.0.0.0 の付け忘れです。①に戻ってください。

アドレスバーに ?filter=done が出ない → setSearchParams ではなく useState を使っています。 ⑥のとおりです。


後片づけ

開けたポートを閉じます。

bash
$ sudo ufw delete allow 5173/tcp
$ sudo ufw delete allow 8000/tcp
$ sudo ufw status

ビルドの成果物は消して構いません。

bash
$ rm -rf ~/react-demo/dist

ビルドツールの回で書いたとおり、dist/ は「毎回作り直せる、捨てていいもの」です。spa-server.py は、この先も使うので残してください。

最終的なファイル構成は、こうなっています。

bash
$ ls -R ~/react-demo/src
/home/user/react-demo/src:
App.css  App.jsx  assets  components  contexts  index.css  main.jsx  pages  tasksReducer.js

/home/user/react-demo/src/components:
Board.jsx  Header.jsx  TaskForm.jsx  TaskItem.jsx  TaskList.jsx  TaskMeta.jsx  TaskSummary.jsx

/home/user/react-demo/src/contexts:
UserContext.js

/home/user/react-demo/src/pages:
NotFoundPage.jsx  TaskDetailPage.jsx  TaskListPage.jsx

全部やり直したいときは:

bash
$ rm -rf ~/react-demo

~/vite-demo/(Vanilla)と ~/web/(素のHTML)も、まだ消さないでください。


まとめ

  • 画面が1枚でも、ルーティングは必要になる。 「いま何を見ているか」を useState に持つと、戻るボタン・共有・ブックマークが全部使えなくなる
  • ルーターがやっているのは1つだけ。 URL を状態として扱い、その値で出すコンポーネントを切り替える
  • <BrowserRouter> は、Context で「いまのURL」を配っているだけ。 前回の Provider と同じ形
  • <Routes> の外に置いたものは、画面が変わっても消えない。 ヘッダーや共通のボタンはそこに置く
  • 状態は App に残したまま。 ルーティングを入れても、状態の置き場所の考え方は1つも変わらない
  • useParams() が返す値は、必ず文字列。 t.id === id は永久に false。 String(t.id) === id にする
  • URL は、ユーザーが自由に書き換えられる入力欄。 「そんな id は無い」を必ず書く
  • 「見つかりません画面」と「404」は別物。 前者は React が出す画面で、HTTP としては 200
  • <a href> はページを丸ごと読み込み直す。 React の状態が全部消える。 アプリ内の移動は必ず <Link>
  • <Link> は <a> として表示し、クリックを preventDefault() して、History API で URL だけ書き換えている
  • 絞り込みや並び順は URL に置く。 戻るボタンも共有も、ブラウザがただでやってくれる
  • 入力途中の文字やメニューの開閉は useState のまま。 秘密の情報は絶対に URL に置かない
  • 画面のURL /tasks/3 と、APIのURL /api/tasks/3 は別物。 似せるのは読みやすさのためで、一致させる義務はない
  • ビルドすると HTML は1枚しか出ない。 dist/ に tasks/3 というファイルは存在しない
  • /tasks/3 を直接開くと 404 になるのは、サーバーが正しく答えているから。 React はまだ1行も動いていない
  • リンクで行けるのにリロードで死ぬのは、<Link> がサーバーに何も聞いていないから
  • 直すのはサーバー側。 「見つからなければ index.html を返す」(nginx なら try_files $uri $uri/ /index.html;)
  • 実在するファイルを先に試すこと。 全部 index.html にすると、JS まで HTML になって真っ白になる
  • npm run dev も npm run preview も、この罠を隠す。 フォールバックを内蔵しているから。 preview で動いた = 本番で動く、ではない
  • URL が共有できるようになっても、データはまだ共有できていない。 それはサーバーの仕事

参考リンク


次に読む

この記事は 【第4段階】フロントエンド の 4 / 15 本目です。

記事
← 前の記事状態管理はライブラリの話ではない — Contextまで
→ 次の記事className でテストしない — Vitestで書くReactのテスト

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

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

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

Frontend›Routing
  • React Router
  • SPA のURL設計
  • ホスティング時のフォールバック

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

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

コメント

コメントする

目次