Reactのテスト — 実装を直すたびに落ちる

Reactの振る舞いをテスト。ボタンのあるブラウザ画面とポインター、テストのチェックリスト。

実装を直すたびにテストが落ちるのは、実装の詳細をテストしているからです。壊れにくいテストの書き方に変えます。

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

これは深掘りです。本線の順路ではありません。 本線のフロントエンドのテストの回でテストを2本書いた人が、「書いたのはいいが、アプリを直すたびにテストが落ちるようになった」ところで止まったときに読む記事です。飛ばしても本線は進みます。

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

テストを書き始めて、2週間でこうなりました。

 Test Files  3 failed | 1 passed (4)
      Tests  7 failed | 2 passed (9)

アプリは壊れていません。 ブラウザで開けば、いつもどおり動きます。この日にやったのは、<div> を <section> に変えたのと、クラス名を task-item から todo-row に直したことだけでした。

それでテストが7本落ちました。

このとき、私は「テストは面倒だ」と思いました。思ってから、直しました。直したら、また次の日に落ちました。 3回目で、テストのファイルを消しました。

いま振り返ると、消したのは正しかったです。 あのテストは、残しても価値が無かったからです。

「実装を直すたびに落ちるテスト」は、テストの書き方が間違っています。 落ちているのはアプリの不具合ではなく、テストが「アプリの中身の形」を覚えてしまっているからです。

そして、この状態は本当に危険です。 テストが1本も無い状態より悪いことがあります。

テストが無い壊れやすいテストがある
直すのにかかる時間0毎回かかる
不具合を見つける力無いほとんど無い(落ちるのはいつも無関係な理由)
人の気持ち「そのうち書こう」「テストは邪魔だ」

「テストは邪魔だ」まで行くと、もう二度と書かなくなります。

この記事は、その原因を1つずつ潰します。 本線では「クラス名でテストしない」というところまで書きました。ここでは、その先にある「では何を見ればいいのか」を、優先順位と、通信の扱いと、書かないものの決め方までやります。

似たタイトルの記事があります。役割が違います。 この記事は落ちにくいテストへの直し方を扱います。VitestでReactのテストを書く|要素の取得方法とテストの分け方 はテストをまだ1本も書いていない場合の最初の1本を扱います。

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

目次

この記事でわかること

  • テストが見てよいのは「利用者から見えるもの」だけだということ。state の中身も、クラス名も、コンポーネントの分け方も、利用者には見えていない
  • 要素の探し方には決められた優先順位があること。getByRole が最初で、getByTestId は最後の手段であり、getByTestId を使いたくなったときは、たいていアプリ側が間違っている
  • getBy / queryBy / findBy は用途が違うこと。「無いこと」を確かめられるのは queryBy だけで、getBy は探した時点で失敗する
  • 通信を fetch の差し替えでごまかすと、URLを間違えていてもテストが通ること。MSW を使うと、ネットワークの層で止められるので、URLの間違いはテストが落ちて教えてくれる
  • カバレッジは目標にしてはいけない数字であること。100%にしても、確かめていない振る舞いはいくらでも残る

この記事でやること

  1. ~/reactlab/ を新しく作り、ポート5187で起動する(本線の ~/react-demo/ は触りません)
  2. Vitest + React Testing Library + jsdom を入れ、vite.config.js と src/setupTests.js を全文で用意する
  3. 同じ画面に対して、悪いテストと良いテストを両方書き、クラス名だけを変えてどちらが落ちるかを見る
  4. userEvent で入力とクリックをテストし、findBy と waitFor で非同期を待つ
  5. fetch を差し替えたテストを1本書いてから、MSW に置き換え、URLをわざと間違えて両者の差を見る

先に知る言葉

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

言葉意味
クエリReact Testing Library で要素を探す関数。getByRole getByText など
ロール(role)その要素が何であるか。ボタン・見出し・入力欄・リスト項目など。HTMLのタグに最初から付いている
アクセシブルな名前その要素が、読み上げソフトから何と呼ばれるか。ボタンなら普通は書いてある文字、入力欄なら結びついたラベルの文字
モック / スタブ本物の代わりに置く偽物。テストの都合で、返ってくる値を自分で決められるようにする
MSW(Mock Service Worker)通信そのものを横取りして、偽の応答を返すライブラリ。アプリ側のコードは1行も変えない
リクエストハンドラMSW で 「このURLにこう来たら、こう返す」を1つ書いたもの
フレーキーテスト同じコードなのに、通ったり落ちたりするテスト。原因はたいてい「待ち方」
actReact が 「状態の更新が終わるまで待つ」ための囲い。テスト中にこの外で更新が起きると警告が出る
カバレッジテストを走らせたときに、コードの何行が実行されたかの割合。「確かめた」割合ではない

① 原則を先に決める — 実装ではなく、振る舞いをテストする

道具を入れる前に、ここを決めます。 ここを飛ばすと、設定は正しいのに無価値なテストが量産されます。

原則は1つだけです。

テストが見てよいのは、利用者から見えるものだけ。

「利用者から見えるもの」とは、具体的にこれです。

見てよい見てはいけない
画面に出ている文字useState に入っている値
押せるボタンと、その名前クラス名・id・data- 属性(最後の手段を除く)
入力欄と、そのラベルコンポーネントをどう分割したか
押したあと、表示がどう変わったかどの関数が何回呼ばれたか(自分のコードの中の話)
失敗したときに出るメッセージuseEffect を何回通ったか

右側は、全部「あとで変える可能性があるもの」です。 そして変えても、利用者は何も困りません。 困らない変更でテストが落ちるなら、そのテストは落ちる意味がありません。

悪い例と良い例を、並べて見る

同じことを確かめている、2つのテストです。 題材は「入力して追加ボタンを押すと、一覧に1件増える」です。

❌ 悪い例1 — クラス名や id で要素を探す

// ❌ これは書いてはいけない
const { container } = render(<TaskBox />);

const input = container.querySelector("#task-title");
fireEvent.change(input, { target: { value: "牛乳を買う" } });
fireEvent.click(container.querySelector(".add-button"));

expect(container.querySelectorAll("li.task-item")).toHaveLength(1);

❌ 悪い例2 — state の中身を直接見る

// ❌ これも書いてはいけない
const { result } = renderHook(() => useTasks());

act(() => {
  result.current.add("牛乳を買う");
});

expect(result.current.tasks).toEqual([{ id: 1, title: "牛乳を買う" }]);

✅ 良い例 — 利用者と同じ手順で触る

// ✅ こう書く
const user = userEvent.setup();
render(<TaskBox />);

await user.type(screen.getByLabelText("やること"), "牛乳を買う");
await user.click(screen.getByRole("button", { name: "追加" }));

expect(screen.getByRole("listitem")).toHaveTextContent("牛乳を買う");

3つとも、いまは通ります。 差が出るのは、アプリを直したときです。

アプリにやった変更利用者は困るか悪い例1悪い例2良い例
クラス名を task-item → todo-row に変えた困らない落ちる通る通る
id="task-title" を消して、ラベルで結んだ困らない落ちる通る通る
useState を useReducer に書き換えた困らない通る落ちる通る
tasks に done: false を足した困らない通る落ちる通る
useTasks を TaskBox の中に戻した困らない通る動かなくなる通る
追加ボタンが動かなくなった困る落ちる落ちる落ちる

最後の行だけが、テストに落ちてほしい行です。 良い例は、最後の行でだけ落ちます。

悪い例2について、1つ補足があります。 renderHook そのものが悪いわけではありません。 カスタムフックの回でやったとおり、そのフック自体が公開する道具である場合(useToggle のように、他人が呼ぶことを前提に作ったもの)、renderHook でテストするのは正しいやり方です。 やってはいけないのは、「コンポーネントの中身を覗くための抜け道」として使うことです。useTasks が TaskBox の内部事情でしかないなら、それはコンポーネント越しに触るべきです。この記事が扱うのは、そちら(コンポーネントのテスト)です。

なぜ、こんな当たり前のことを間違えるのか

理由ははっきりしています。悪い書き方のほうが、書きやすいからです。

container.querySelector(".add-button") は、確実に見つかります。 一方 getByRole("button", { name: "追加" }) は、アプリ側が <div onClick> でボタンを作っていると見つかりません。

見つからないと、人は「テストの書き方が悪い」と思います。 ですが、それは逆です。

getByRole("button") で見つからないボタンは、キーボードでも押せず、読み上げソフトからも「ボタン」だと分かりません。 テストが書きにくいのは、テストのせいではなく、アプリのせいです。 これはアクセシビリティの回でやった話と、まったく同じものです。

テストは、アクセシビリティの点検も兼ねています。 これがこの記事で一番大事な1行です。


② 準備 — reactlab を作り、道具を入れる

プロジェクトを作る

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

この一覧が出れば成功です。

すでに ~/reactlab/ がある場合(この深掘りシリーズの別の回で作っている場合)は、作り直さずにそのまま使って構いません。 npm create vite は飛ばして、cd ~/reactlab && npm install だけ実行してください。

ポートを開ける

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

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

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

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

sudo と ufw についてはLinuxのファイアウォールの回にあります。閉じ方は後片づけに書きました。

道具を入れる

bash
$ cd ~/reactlab
$ npm install -D vitest jsdom @testing-library/react @testing-library/dom @testing-library/jest-dom @testing-library/user-event

6つ入りました。1つずつ、何なのかを書きます。

入れたもの役割
vitestテストランナー本体。 テストのファイルを探して、実行して、結果をまとめる
jsdomNode.js の中に、DOM だけを真似して作る。 これが無いと document is not defined で落ちます
@testing-library/reactReact を描画して、クエリで触れるようにする
@testing-library/domクエリの本体。 上のものが中で使っているのに、自動では入りません
@testing-library/jest-domtoBeInTheDocument() のような、DOM向けの判定を expect に足す
@testing-library/user-event人の操作をなぞる(クリック・入力・タブ移動)

-D は「開発のときだけ要るもの」という印です。利用者に配る dist/ には1バイトも入りません(ビルドツールの回)。

入ったか確かめます。

bash
$ npx vitest --version
vitest/3.2.4 linux-x64 node-v22.14.0

数字は違って構いません。 3 系が入っていれば、この記事のとおりに進みます。

vite.config.js(全文を置き換え)

bash
$ nano ~/reactlab/vite.config.js

丸ごと、これに置き換えてください。

import { defineConfig } from "vitest/config";
import react from "@vitejs/plugin-react";

export default defineConfig({
  plugins: [react()],
  server: {
    host: "0.0.0.0",
    port: 5187,
  },
  test: {
    environment: "jsdom",
    globals: true,
    setupFiles: "./src/setupTests.js",
  },
});
書いたもの意味
from "vitest/config"test: を書けるようにする版の defineConfig。 中身は Vite のものと同じ
server:npm run dev のときの待ち受け設定。 毎回 --host --port を打たなくてよくなります
environment: "jsdom"テストの間だけ、Node の中に偽物のDOMを用意する
globals: truetest や expect を import せずに使えるようにする
setupFiles各テストファイルの前に、必ず読み込むファイル

plugins: [react()] を消さないでください。 JSXを変換しているのはこれです(JSXの回)。テストのときも同じプラグインが使われます。 テスト用に変換の設定をもう一度書かずに済むのが、Vitest を選ぶ唯一にして最大の理由です。

globals: true は手抜きではありません。 React Testing Library は、afterEach が使える環境なら、1本終わるたびに自動で描画を片づけます。 false のままだと前のテストの描画が残り、「同じ要素が2つ見つかりました」という意味の分からない失敗が出ます。

src/setupTests.js(新規)

bash
$ nano ~/reactlab/src/setupTests.js
import "@testing-library/jest-dom/vitest";

いまは1行です。 ⑤で MSW を入れるときに、ここへ追記します。

ファイル名に .test. を入れないでください。 Vitest がテストとして拾うのは *.test.js / *.test.jsx(や .spec.)という名前だけです。setup.test.js にすると、中身が空のテストファイルとして実行され、怒られます。

package.json の scripts

bash
$ nano ~/reactlab/package.json

"scripts" の中を、こうします。

  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "lint": "eslint .",
    "preview": "vite preview",
    "test": "vitest run",
    "test:watch": "vitest"
  },

足したのは下の2行だけです。

test が vitest ではなく vitest run になっているのが、ここで一番間違えやすいところです。 vitest は走り終わったあとも終了せず、ファイルの変更を待ち続けます(watch モード)。手元では便利ですが、CIで実行すると永遠に終わりません。 vitest run は、1回走って、結果を返して、終わります。

起動して、画面が出ることを確かめる

bash
$ cd ~/reactlab
$ npm run dev

server: を書いたので、オプションは要りません。 ホストの Windows のブラウザで http://192.168.226.50:5187/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。

[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5187 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5187 になっているのが見える形で。

止め方: ターミナルで Ctrl+C。テストを走らせている間は、止めておいて構いません。 テストはブラウザもサーバーも使いません。


③ テストする画面を作る

テストの前に、テストされる側が要ります。 ①で見た TaskBox を、実際に作ります。

bash
$ mkdir -p ~/reactlab/src/components
$ nano ~/reactlab/src/components/TaskBox.jsx
import { useState } from "react";

export default function TaskBox() {
  const [text, setText] = useState("");
  const [tasks, setTasks] = useState([]);
  const [seq, setSeq] = useState(1);

  function handleSubmit(e) {
    e.preventDefault();
    const title = text.trim();
    if (title === "") return;
    setTasks([...tasks, { id: seq, title }]);
    setSeq(seq + 1);
    setText("");
  }

  return (
    <section>
      <h2>やることリスト</h2>

      <form onSubmit={handleSubmit}>
        <label htmlFor="task-title">やること</label>
        <input
          id="task-title"
          className="task-input"
          value={text}
          onChange={(e) => setText(e.target.value)}
        />
        <button type="submit" className="add-button">
          追加
        </button>
      </form>

      {tasks.length === 0 ? (
        <p>まだ何もありません</p>
      ) : (
        <ul aria-label="やること一覧">
          {tasks.map((task) => (
            <li key={task.id} className="task-item">
              {task.title}
            </li>
          ))}
        </ul>
      )}
    </section>
  );
}

3つだけ、意図を書いておきます。

  • <label htmlFor="task-title"> と <input id="task-title"> が結ばれています。 これがあるから getByLabelText("やること") で探せます。結んでいないと探せません
  • key に配列の添字を使っていません。 理由はkeyの回にあります
  • className をわざと付けてあります。 ④でこれを変えて、テストが落ちるかどうかを見るために置いています

src/App.jsx から呼びます。

bash
$ nano ~/reactlab/src/App.jsx
import TaskBox from "./components/TaskBox.jsx";

export default function App() {
  return (
    <main>
      <h1>reactlab</h1>
      <TaskBox />
    </main>
  );
}

ブラウザで :5187 を開き、入力して「追加」を押してみてください。 一覧に増えれば、準備完了です。この時点では、まだテストは1本もありません。


④ 要素の探し方には、優先順位がある

ここが、この記事で一番効く節です。

React Testing Library には、要素の探し方が20種類近くあります。 そしてどれを使っても、たいてい見つかります。 だから初心者は、「見つかった方法」を使ってしまいます。

公式が優先順位を明記しているのは、そのためです。

優先順位(上から順に試す)

順位クエリ何で探すか使ってよい場面
1getByRole役割 + アクセシブルな名前原則これ。 ボタン・見出し・リンク・入力欄・リスト項目
2getByLabelText結びついたラベルの文字フォームの入力欄。ラベルは利用者も見ている
3getByPlaceholderTextプレースホルダラベルが無いときの妥協。プレースホルダはラベルの代わりにならない
4getByText画面に出ている文字そのもの押せない文字(説明文・エラーメッセージ・空のときの案内)
5getByDisplayValue入力欄にいま入っている値編集画面で、初期値を確かめたいとき
最後の手段getByTestIddata-testid 属性上のどれでも取れないときだけ

この順番には、はっきりした理由があります。

上に行くほど「利用者と読み上げソフトが見ているもの」に近く、下に行くほど「開発者の都合」に近い。

getByRole が1位なのは、それがHTMLの回の回収だからです。「タグは意味を与えるもの」と書きました。<button> には role="button" が、<li> には listitem が、<h2> には heading が、何も書かなくても付いています。

screen.getByRole("button", { name: "追加" });
screen.getByRole("heading", { name: "やることリスト" });
screen.getByRole("list", { name: "やること一覧" });
screen.getByRole("listitem");

name: はクラス名でも変数名でもありません。 アクセシブルな名前(読み上げソフトがその要素をどう呼ぶか)です。

要素アクセシブルな名前になるもの
<button>追加</button>中の文字「追加」
<input id="x"> + <label for="x">やること</label>ラベルの文字「やること」
<ul aria-label="やること一覧">aria-label の文字
<button><img alt="削除" /></button>画像の alt「削除」
<button><img /></button>無い。 だから name: で探せません=読み上げソフトからも「ボタン」としか分かりません

getByTestId は最後の手段

data-testid は、こう書きます。

<div data-testid="task-row">…</div>
screen.getByTestId("task-row");

確実に取れます。クラス名を変えても落ちません。 だから「これでいいのでは」と思います。

ですが、これは①の原則を破っています。

data-testid は、利用者に見えません。 見えないものを目印にしたテストは、「利用者から見た振る舞い」を確かめていません。 data-testid を消し忘れて本番に出しても誰も気づかないのが、その証拠です。

さらに悪いことがあります。

getByTestId を使いたくなった状況本当の原因
ボタンが getByRole("button") で見つからない<div onClick> でボタンを作っている(キーボードで押せない)
入力欄が getByLabelText で見つからないラベルが結ばれていない(読み上げソフトが何の欄か言えない)
画像ボタンに名前が無いalt が空(何のボタンか分からない)
同じ文字のボタンが3つあって特定できない利用者も区別できない(aria-label で区別を付けるべき)

4つとも、テストの問題ではなくアプリの問題です。 getByTestId を貼ると、問題が見えなくなるだけで、解決していません。

では、いつ使ってよいのか。

  • 役割も名前も持ちようがない要素(グラフの描画領域、装飾のコンテナ)
  • 文字が動的すぎて特定できない(日時、ランダムなID)
  • どうしても急ぐとき。 ただし // TODO: role で取れるように直す を必ず添える

getBy / queryBy / findBy の使い分け

同じ「探す」でも、前置きが3種類あります。ここは必ず一度混乱します。

前置き見つからなかったら待つか返り値使う場面
getBy...その場で失敗にする待たない要素あるはずのものを探す(ほとんどこれ)
queryBy...null を返す(失敗にしない)待たない要素 or null「無いこと」を確かめるときだけ
findBy...しばらく待って、それでも無ければ失敗待つ(既定1秒)Promise通信のあとなど、遅れて出るもの

さらに、All が付くと複数形になります。

1つ複数
無いと失敗getByRolegetAllByRole
無くてもよいqueryByRolequeryAllByRole
待つfindByRolefindAllByRole

一番やる間違いは、これです。

// ❌ 「無いこと」を getBy で確かめようとした
expect(screen.getByText("まだ何もありません")).not.toBeInTheDocument();

このテストは、絶対に成功しません。 getByText は、見つからなかった時点で失敗するからです。expect の行にすら到達しません。

// ✅ 無いことは queryBy で確かめる
expect(screen.queryByText("まだ何もありません")).not.toBeInTheDocument();

もう1つの間違いは、findBy の await 忘れです。

// ❌ await が無い
expect(screen.findByText("さとう")).toBeInTheDocument();

findBy は Promise を返します。 Promise はいつでも「存在する」ので、この expect は通ってしまいます。 何も確かめていないのに緑になる、いちばん質の悪い失敗です(非同期の回)。


⑤ 操作をテストする

1本目 — 追加すると、一覧に出る

bash
$ nano ~/reactlab/src/components/TaskBox.test.jsx
import { test, expect } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import TaskBox from "./TaskBox.jsx";

test("入力して追加を押すと、一覧に出る", async () => {
  const user = userEvent.setup();
  render(<TaskBox />);

  // 最初は空の案内が出ている
  expect(screen.getByText("まだ何もありません")).toBeInTheDocument();

  await user.type(screen.getByLabelText("やること"), "牛乳を買う");
  await user.click(screen.getByRole("button", { name: "追加" }));

  // 一覧に1件出て、案内は消えた
  expect(screen.getByRole("listitem")).toHaveTextContent("牛乳を買う");
  expect(screen.queryByText("まだ何もありません")).not.toBeInTheDocument();
});

test("空のまま押しても、増えない", async () => {
  const user = userEvent.setup();
  render(<TaskBox />);

  await user.click(screen.getByRole("button", { name: "追加" }));

  expect(screen.queryAllByRole("listitem")).toHaveLength(0);
  expect(screen.getByText("まだ何もありません")).toBeInTheDocument();
});

走らせます。

bash
$ cd ~/reactlab
$ npm test
 ✓ src/components/TaskBox.test.jsx (2 tests) 187ms

 Test Files  1 passed (1)
      Tests  2 passed (2)

2 passed が出れば成功です。

[スクリーンショット: 02_テスト成功.png] Test Files 1 passed / Tests 2 passed が見えているところを撮ってください。

fireEvent ではなく userEvent を使う

クリックを起こす方法は2つあります。 本線でも触れましたが、なぜそうなのかを、ここで具体的に見ます。

何をするか
fireEvent.click(要素)click イベントを1つ、直接ぶつける
userEvent.click(要素)人がやることを順番になぞる(pointerdown → mousedown → focus → pointerup → mouseup → click)

差が出るのは、こういうときです。

<button disabled>追加</button>
結果
fireEvent.click(button)イベントは発火する。 押せないボタンを「押せた」ことにできてしまう
userEvent.click(button)何も起きない。 本物のブラウザと同じ

入力欄でも同じです。

fireEvent.change(input, { target: { value: "牛乳を買う" } });

これは「一瞬で全文字が入った」という、人間には起こせない出来事です。 1文字ごとの onChange は1回しか走りません。 フォームの回でやった「1文字打つごとに再描画される」話は、このテストでは再現しません。

await user.type(input, "牛乳を買う");

user.type は、1文字ずつ打ちます。 keydown → keypress → input → keyup を、文字の数だけ繰り返します。入力途中でしか起きない不具合は、こちらでしか捕まりません。

userEvent は必ず await してください。 忘れると、入力が終わる前に次の行へ進みます。 そして、userEvent.setup() は render() より前に呼びます。 後だと、内部の準備が間に合わずに pointer-events 関連の分かりにくいエラーになることがあります。

2本目 — ボタンを押したら、表示が変わる

「増える」以外の、いちばん基本の形です。 開閉するパネルを作ります。

bash
$ nano ~/reactlab/src/components/Details.jsx
import { useState } from "react";

export default function Details() {
  const [open, setOpen] = useState(false);

  return (
    <section>
      <button type="button" onClick={() => setOpen(!open)}>
        {open ? "詳細を閉じる" : "詳細を開く"}
      </button>
      {open && <p>ここに詳細が入ります。</p>}
    </section>
  );
}
bash
$ nano ~/reactlab/src/components/Details.test.jsx
import { test, expect } from "vitest";
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import Details from "./Details.jsx";

test("ボタンを押すと詳細が出て、もう一度押すと消える", async () => {
  const user = userEvent.setup();
  render(<Details />);

  // 閉じている
  expect(screen.queryByText("ここに詳細が入ります。")).not.toBeInTheDocument();

  await user.click(screen.getByRole("button", { name: "詳細を開く" }));

  // 開いた。ボタンの名前も変わっている
  expect(screen.getByText("ここに詳細が入ります。")).toBeInTheDocument();
  expect(screen.getByRole("button", { name: "詳細を閉じる" })).toBeInTheDocument();

  await user.click(screen.getByRole("button", { name: "詳細を閉じる" }));

  expect(screen.queryByText("ここに詳細が入ります。")).not.toBeInTheDocument();
});

このテストが良い形なのは、open という state を1度も見ていないところです。 open を useReducer にしても、名前を isOpen に変えても、このテストは通り続けます。

App.jsx に足して、ブラウザでも動かしておいてください。

import TaskBox from "./components/TaskBox.jsx";
import Details from "./components/Details.jsx";

export default function App() {
  return (
    <main>
      <h1>reactlab</h1>
      <TaskBox />
      <Details />
    </main>
  );
}

実際に、クラス名を変えて確かめる

①の表が本当かどうか、ここで確かめます。

TaskBox.jsx の className="task-item" を、className="todo-row" に変えて保存してください。

bash
$ npm test
 Test Files  2 passed (2)
      Tests  3 passed (3)

1本も落ちません。 クラス名は、テストがどこにも書いていないからです。

次に、本当の不具合を入れます。 handleSubmit の中の setTasks(...) の行を、コメントアウトしてください。

    // setTasks([...tasks, { id: seq, title }]);
bash
$ npm test
 FAIL  src/components/TaskBox.test.jsx > 入力して追加を押すと、一覧に出る

Unable to find an accessible element with the role "listitem"

Here are the accessible roles:

  heading:
  Name "やることリスト":
  <h2 />
  ...

落ちました。 落ちてほしいときにだけ落ちるのが、良いテストです。

失敗の出力は、下から読まないでください。 Testing Library の失敗は、上の2行がすべてです。 Unable to find an accessible element with the role "listitem" = 「listitem が1つも無い」。そのあとに続く長い一覧は、「代わりに、こういう役割の要素ならありました」という親切です。getByTestId を使っていると、この一覧が出ません。 ここでも差が出ます。

[スクリーンショット: 03_役割で見つからない失敗.png] Unable to find an accessible element with the role "listitem" と、その下の役割一覧が写っているところを撮ってください。

コメントアウトを戻して、npm test が緑に戻ることを確認してください。

非同期の待ち方 — findBy と waitFor

ここまでのテストは、押した瞬間に表示が変わりました。 通信やタイマーが挟まると、そうはいきません。

絶対にやってはいけないのが、これです。

// ❌ 絶対にやってはいけない
await user.click(button);
await new Promise((r) => setTimeout(r, 1000));
expect(screen.getByText("さとう")).toBeInTheDocument();

理由は3つあります。

問題中身
遅い必ず1秒待ちます。 10ミリ秒で終わっていても待ちます。テスト100本で100秒
不安定になるCIのマシンが混んでいて1.1秒かかった日だけ落ちます。 これがフレーキーテストです
直し方が「数字を増やす」になる落ちるたびに 1000 → 2000 → 3000 と増えていきます。 誰も理由を説明できなくなります

正しいのは、「時間」ではなく「状態」を待つことです。

// ✅ 出るまで待つ(既定で最大1秒、50ミリ秒ごとに確認)
expect(await screen.findByText("さとう")).toBeInTheDocument();

findBy は「getBy + 出るまで待つ」です。 出た瞬間に次へ進むので、速くて、安定します。

では waitFor は何なのか。

使う場面
findBy...待つ対象が「画面の要素」のとき。原則こちら
waitFor(() => ...)待つ対象が要素ではないとき(関数が呼ばれた、要素が消えた、など)
// 要素が「消える」のを待つ
await waitFor(() => {
  expect(screen.queryByText("読み込み中…")).not.toBeInTheDocument();
});

waitFor の中に、副作用を書かないでください。 waitFor の中身は、条件が満たされるまで何度も実行されます。 クリックを中に書くと、何回も押されます。

// ❌ 中でクリックしている
await waitFor(async () => {
  await user.click(button);
  expect(screen.getByText("完了")).toBeInTheDocument();
});

中に置いてよいのは expect だけです。

act の警告についても、ここで書いておきます。

Warning: An update to UserList inside a test was not wrapped in act(...)

これが出たら、意味は1つです。

テストが終わったあとに、状態の更新が起きた。

原因はほぼ、await の忘れです。 通信の結果を待たずにテストを終わらせると、そのあとに setState が走ります。 act() で囲んで消そうとしないでください。 await screen.findBy... を足すのが正しい直し方です。


⑥ 通信をどうするか

テストの中で、本物のAPIを叩いてはいけません。

理由中身
サーバーが要るCIには無い。起動を待つ仕組みも要る
結果が毎回変わる昨日のデータが残っていると落ちる
遅い1本あたり数百ミリ秒〜数秒
本物を壊す「削除」のテストで、本物のデータが消える

では、どうやって偽物を用意するか。方法は2つあります。

方法A — fetch を差し替える

まず、通信する画面を作ります。

bash
$ nano ~/reactlab/src/components/UserList.jsx
import { useEffect, useState } from "react";

export default function UserList() {
  const [users, setUsers] = useState(null);
  const [error, setError] = useState(null);

  useEffect(() => {
    let cancelled = false;

    fetch("/api/users")
      .then((res) => {
        if (!res.ok) throw new Error("HTTP " + res.status);
        return res.json();
      })
      .then((data) => {
        if (!cancelled) setUsers(data);
      })
      .catch(() => {
        if (!cancelled) setError(true);
      });

    return () => {
      cancelled = true;
    };
  }, []);

  if (error) return <p role="alert">読み込みに失敗しました</p>;
  if (users === null) return <p>読み込み中…</p>;

  return (
    <ul aria-label="利用者一覧">
      {users.map((u) => (
        <li key={u.id}>{u.name}</li>
      ))}
    </ul>
  );
}

cancelled の後片づけと、useEffect を使うかどうかの判断はuseEffectの回とデータ取得の回にあります。この記事では、取得のコードそのものは主題ではありません。

fetch を差し替えたテストが、これです。

bash
$ nano ~/reactlab/src/components/UserList.fetchmock.test.jsx
import { test, expect, vi, afterEach } from "vitest";
import { render, screen } from "@testing-library/react";
import UserList from "./UserList.jsx";

afterEach(() => {
  vi.unstubAllGlobals();
});

test("取得できたら、名前が並ぶ(fetchを差し替える版)", async () => {
  vi.stubGlobal(
    "fetch",
    vi.fn(() =>
      Promise.resolve({
        ok: true,
        json: () =>
          Promise.resolve([
            { id: 1, name: "さとう" },
            { id: 2, name: "すずき" },
          ]),
      })
    )
  );

  render(<UserList />);

  expect(screen.getByText("読み込み中…")).toBeInTheDocument();
  expect(await screen.findByText("さとう")).toBeInTheDocument();
  expect(screen.getAllByRole("listitem")).toHaveLength(2);
});
bash
$ npm test

通ります。 通りますが、問題があります。

fetch の差し替えには、3つの問題がある

UserList.jsx のURLを、わざと間違えてください。

    fetch("/api/userz")
bash
$ npm test
 Test Files  3 passed (3)
      Tests  4 passed (4)

URLを間違えたのに、テストは全部通ります。 差し替えた偽の fetch は、URLを見ていないからです。/api/userz でも /こんにちは でも、同じ配列を返します。

これが1つ目の問題です。並べます。

問題中身
URLもメソッドも検査されない/api/userz に投げていても通る。 本番で初めて404になる
応答の形を自分で手書きしている{ ok: true, json: () => ... } は本物の Response ではありません。 res.headers や res.status を使い始めた瞬間に、偽物を書き足すことになります
実装に依存しているfetch を axios に替えたら、テストが全滅します。 データ取得の回でやった TanStack Query を入れたときも同じです。アプリの振る舞いは1ミリも変わっていないのに

3つ目が、①の原則そのものです。 「fetch という関数を使っていること」は実装の詳細で、利用者には見えません。

URLを /api/users に戻してください。

方法B — MSW でネットワーク層をモックする

MSW(Mock Service Worker)は、fetch を差し替えません。 もっと下、「通信そのもの」を横取りします。

どこを偽物にするかアプリ側のコード
fetch の差し替えfetch という関数fetch を使っている前提が要る
MSWHTTPのリクエスト何を使っていても関係ない(fetch / axios / TanStack Query)

入れます。

bash
$ cd ~/reactlab
$ npm install -D msw

リクエストハンドラを書きます。「このURLにこう来たら、こう返す」を並べたファイルです。

bash
$ mkdir -p ~/reactlab/src/mocks
$ nano ~/reactlab/src/mocks/handlers.js
import { http, HttpResponse } from "msw";

export const handlers = [
  http.get("*/api/users", () => {
    return HttpResponse.json([
      { id: 1, name: "さとう" },
      { id: 2, name: "すずき" },
    ]);
  }),
];

"*/api/users" の先頭の * を消さないでください。 テストは jsdom の中で動いていて、そこでの「いま居るページ」は http://localhost:3000/ のような架空のアドレスです。/api/users と書くとそのアドレスを基準に解決されるため、環境によって一致したりしなかったりします。* を頭に置くと、ホスト名が何であっても一致します。 これで悩んだ話は「つまずいたところ」に書きました。

テストのときだけ動かすサーバー役を作ります。

bash
$ nano ~/reactlab/src/mocks/server.js
import { setupServer } from "msw/node";
import { handlers } from "./handlers.js";

export const server = setupServer(...handlers);

src/setupTests.js を、こう書き換えます(全文)。

import "@testing-library/jest-dom/vitest";
import { beforeAll, afterEach, afterAll } from "vitest";
import { server } from "./mocks/server.js";

beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
afterEach(() => server.resetHandlers());
afterAll(() => server.close());

この4行が、それぞれ何をしているか。

行意味
server.listen(...)全部のテストが始まる前に、横取りを開始する
onUnhandledRequest: "error"ハンドラの無いURLへ通信したら、テストを失敗させる。 これが方法Aとの決定的な差です
server.resetHandlers()1本ごとに、そのテストだけで足したハンドラを消す。 隣のテストに漏れない
server.close()全部終わったら、横取りをやめる

テストを書きます。

bash
$ nano ~/reactlab/src/components/UserList.test.jsx
import { test, expect } from "vitest";
import { render, screen } from "@testing-library/react";
import { http, HttpResponse } from "msw";
import { server } from "../mocks/server.js";
import UserList from "./UserList.jsx";

test("取得できたら、名前が並ぶ", async () => {
  render(<UserList />);

  expect(screen.getByText("読み込み中…")).toBeInTheDocument();

  expect(await screen.findByText("さとう")).toBeInTheDocument();
  expect(screen.getAllByRole("listitem")).toHaveLength(2);
});

test("500 が返ったら、失敗の表示になる", async () => {
  server.use(
    http.get("*/api/users", () => new HttpResponse(null, { status: 500 }))
  );

  render(<UserList />);

  expect(await screen.findByRole("alert")).toHaveTextContent(
    "読み込みに失敗しました"
  );
});

方法Aで書いたファイルは、もう要りません。消します。

bash
$ rm ~/reactlab/src/components/UserList.fetchmock.test.jsx
$ npm test
 ✓ src/components/Details.test.jsx (1 test) 96ms
 ✓ src/components/TaskBox.test.jsx (2 tests) 191ms
 ✓ src/components/UserList.test.jsx (2 tests) 118ms

 Test Files  3 passed (3)
      Tests  5 passed (5)

[スクリーンショット: 04_MSWのテスト成功.png] Test Files 3 passed / Tests 5 passed が見えているところを撮ってください。

同じ間違いを、もう一度やってみる

UserList.jsx のURLを、また /api/userz に変えてください。

bash
$ npm test
 FAIL  src/components/UserList.test.jsx > 取得できたら、名前が並ぶ

[MSW] Error: intercepted a request without a matching request handler:

  • GET http://localhost:3000/api/userz

今度は落ちます。 URLの間違いを、テストが見つけました。 方法Aでは絶対に見つけられなかったものです。 onUnhandledRequest: "error" を書いた甲斐が、ここに出ます。

URLを /api/users に戻し、npm test が緑に戻ることを確認してください。

2つ目の利点もあります。 server.use(...) の1行で、そのテストだけ応答を変えられます。 エラー画面・空っぽの一覧・遅い応答を、アプリのコードを1行も触らずに作れます。

// 空の配列を返させる
server.use(http.get("*/api/users", () => HttpResponse.json([])));

どちらを選ぶか

状況選ぶもの
テストが1〜2本しかない。通信も1箇所だけfetch の差し替えでよい。 MSW を入れる手間のほうが大きい
通信するコンポーネントが3つ以上あるMSW。 偽の応答を1箇所にまとめられる
URLやメソッドの間違いを捕まえたいMSW 一択
axios や TanStack Query を使っている / 将来使うかもしれないMSW。 取得の道具を替えてもテストは無傷
エラー・空・遅延を作り分けたいMSW(server.use で1行)
通信ではなく、時計やランダムを偽物にしたいMSW ではない。 vi.useFakeTimers() などを使う

私の結論はこうです。

最初の1本は fetch の差し替えで構いません。2本目を書くときに MSW にします。 なぜなら、2本目で必ず「偽の Response」をコピペすることになるからです。コピペが始まったら、道具が合っていない合図です。


⑦ 何をテストして、何をしないか

道具が揃うと、次は「全部テストしたくなる」段階が来ます。ここで止まってください。

テストは資産ではありません。 テストもコードなので、書けば書くほど、直す対象が増えます。

書く書かない
利用者が実際にやる操作(入力して押す、開いて閉じる)CSSの見た目(色・余白・並び)
条件で表示が変わるところ(空のとき / 読み込み中 / エラー)props をそのまま表示しているだけの部品
一度壊れた場所(不具合を直したら、必ず1本足す)ライブラリの動作(React が再描画するか、など)
入力の検証(空欄では追加できない、など)useState の値そのもの
通信の失敗時の表示「押したら関数が呼ばれた」だけの確認(何も起きていない)
計算やデータ加工の関数(純粋なもの。いちばん安い)1週間後に消すかもしれない画面

特に強調したいのが、この行です。

一度壊れた場所には、必ずテストを1本足す。 どこにテストを書けばいいか分からないとき、これが唯一の確実な答えです。 実際に壊れたということは、そこが壊れやすいという実測データです。想像で選んだ100本より、実際に落ちた1本のほうが価値があります。

カバレッジを目標にしない

カバレッジは、こう測れます。

bash
$ cd ~/reactlab
$ npm install -D @vitest/coverage-v8
$ npx vitest run --coverage
 % Coverage report from v8
----------------|---------|----------|---------|---------|
File            | % Stmts | % Branch | % Funcs | % Lines |
----------------|---------|----------|---------|---------|
All files       |   88.23 |    83.33 |     100 |   88.23 |
 TaskBox.jsx    |   94.11 |      100 |     100 |   94.11 |
 UserList.jsx   |   85.71 |    66.66 |     100 |   85.71 |
----------------|---------|----------|---------|---------|

数字は違って構いません。 問題は、この数字が何を意味しているかです。

カバレッジが測っているのは「テスト中に実行された行の割合」であって、「確かめた振る舞いの割合」ではありません。

証明は簡単です。この1行だけで、カバレッジは上がります。

test("落ちない", () => {
  render(<TaskBox />);
});

expect が1つもありません。何も確かめていません。 それでも TaskBox.jsx のほとんどの行は実行されるので、カバレッジは上がります。

使い方良し悪し
「カバレッジ80%を目標にする」駄目。 上の「何も確かめないテスト」が量産される
「0%のファイルを探す道具」として見る良い。 一度も触られていない画面は、実際に危ない
「この分岐、通っていないな」と気づく道具良い。 特にエラー処理の分岐

目標にせず、地図として見る。 これだけです。


⑧ Playwright との住み分け

「じゃあ E2E は要らないのでは」と思ったなら、それは違います。 見つけられるものが、はっきり違います。

本線のE2Eの回で Playwright をやりました。この記事のテストとの差は、これです。

この記事(Vitest + RTL)Playwright(E2E)
ブラウザ無い。 jsdom が Node の中に DOM を真似る本物の Chromium が起動する
CSSほぼ効かない。 レイアウトを計算していない効く。 重なりも display: none も本物
サーバー呼ばない(MSW が横取りする)本物を叩く。 DBまで届く
Cookie・セッション無い本物のブラウザが本物のCookieを持つ
速さ数百ミリ秒数秒〜数十秒
書く量多くてよい(数十〜数百本)少なく保つ(数本〜十数本)
落ちたときの原因だいたいアプリの中アプリ / サーバー / DB / 通信 / 待ち方
見つけられるもの表示の条件分岐、入力の検証、エラー表示URLの間違い、Cookieの設定ミス、要素の重なり、サーバーが起動しない

判断は、この1行で足ります。

「1つの画面の中で完結する話」はこの記事のテスト。「複数のシステムをまたぐ話」は Playwright。

具体的には、こうなります。

確かめたいことどちらで書くか
空欄のまま押しても増えないこの記事(Playwright だと20倍遅く、同じ結論)
通信が失敗したらエラーが出るこの記事(MSW で500を返すだけ)
ログインしてから、タスクを追加して、再読み込みしても残っているPlaywright
ボタンが他の要素の下に隠れて押せないPlaywright(jsdom は重なりを知らないので、クリックは成功してしまう)
APIのURLが本番で合っているPlaywright(MSW で捕まるのは「ハンドラと違う」ことまで)

両方書きます。 ただし 比率は「この記事のテストが大多数、E2Eはごく少数」です。E2Eを増やすと、CIの時間と、落ちたときに調べる時間で、開発が止まります。


⑨ CIで動かす

手元で走るテストは、いつか走らせなくなります。 GitHub Actions の回でやった仕組みに、そのまま載せます。やることは1つだけで、ワークフローの中で npm ci してから npm test を実行するだけです。npm test の中身が vitest run になっていること(②で設定しました)だけ確認してください。vitest のままだと、CIが watch モードに入って、そのジョブは時間切れまで終わりません。 ブラウザも要らず、サーバーも要らず、MSW が通信を横取りするので、CIのマシンには Node.js があれば十分です。E2E と違って追加のインストールが不要なのが、この層のテストの一番の強みです。逆に、ここで落ちたらマージしないという運用にできるのも、速いからこそです。


つまずいたところ

getByText で探した文字が、見つからなかった

画面には確かに出ているのに、Unable to find an element with the text になりました。

原因は、文字がタグで分断されていたことでした。

<p>合計は <strong>3</strong> 件です</p>

getByText("合計は 3 件です") は見つかりません。 文字が3つの要素に分かれているからです。

直し方は2つ。

// 部分一致で探す
screen.getByText(/合計は/);

// または、まとまりのある要素を取ってから中身を見る
expect(screen.getByRole("paragraph")).toHaveTextContent("合計は 3 件です");

toHaveTextContent は、中のタグを無視して文字だけを見ます。 こういうときのための判定です。

queryBy を使うべきところで getBy を使い、20分悩んだ

expect(screen.getByText("まだ何もありません")).not.toBeInTheDocument();

「not と書いているのに、なぜ落ちるのか」が分かりませんでした。expect の行に到達していないからです。getByText が、その場で例外を投げて終わっていました。

.not を書いた瞬間に queryBy に変える、と覚えました。

findBy に await を付け忘れて、何も確かめていないテストが緑になった

expect(screen.findByText("さとう")).toBeInTheDocument();

通りました。 そしてアプリを壊しても、通り続けました。

findBy は Promise を返します。 Promise はオブジェクトなので、toBeInTheDocument に渡されるのは Promise です。判定が意味を成していませんでした。

findBy と userEvent は、必ず await。 ESLint の testing-library 用ルールを入れると、これは機械が指摘してくれます(ESLintの回)。

MSW のハンドラが、一致しなかった

http.get("/api/users", ...) と書いたのに、intercepted a request without a matching request handler が出ました。

テストが動いている「いま居るページ」のアドレスが、想像と違ったからです。jsdom の中では http://localhost:3000/ のような架空のアドレスが使われていて、相対パスはそれを基準に解決されます。 そこが噛み合わないと、書いたパスは正しいのに一致しません。

http.get("*/api/users", ...) と、頭に * を置いて解決しました。 「URLが間違っている」ではなく「基準が違う」という種類の失敗で、エラーメッセージだけからは分かりませんでした。出力に GET http://localhost:3000/api/users と実際に投げたアドレスが書いてあるので、まずそこを読むべきでした。

act の警告を、act() で囲んで消した

Warning: An update to UserList inside a test was not wrapped in act(...)

警告なので、テストは通っていました。 気持ち悪いので、render を act() で囲んで消しました。

これは間違いです。 警告は「テストが終わったあとに状態が更新された」という意味で、つまり通信の結果を待たずにテストを終えていました。 act() で囲むのは、警告だけ消して、待っていないことは変えていないやり方です。

await screen.findByText(...) を1行足したら、警告も消え、テストの意味も出ました。

「テストを書くのが遅い」と思ったが、遅かったのは書き方だった

1本書くのに30分かかっていました。 中身を見ると、container.querySelector でうまく取れず、セレクタを試行錯誤していた時間でした。

getByRole に切り替えたら、5分になりました。 getByRole で取れないときは、アプリ側を直す。 そのほうが結局速い、というのが実感です。

data-testid を貼りまくったあとで、全部剥がした

取れないたびに data-testid を足していたら、30個になりました。

そのあとアクセシビリティの回をやって、<div onClick> を <button> に直したら、data-testid の8割が不要になりました。 テストが書きにくかったのは、アプリがキーボードで操作できなかったからでした。


後片づけ

開発サーバーを止める

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

bash
$ ss -ltnp | grep 5187

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

ポートを閉じる

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

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

テストが緑の状態で終える

壊したまま終えると、次に開いたときに「何かが壊れている」と勘違いします。

bash
$ cd ~/reactlab
$ npm test

確認: Tests 5 passed が出れば、④と⑥で入れた細工は全部戻っています。 落ちる場合は、UserList.jsx の URL(/api/users)と、TaskBox.jsx の setTasks の行を確認してください。

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

~/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

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


まとめ

  • 「実装を直すたびに落ちるテスト」は、テストの書き方が間違っている。 見てよいのは、利用者から見えるものだけ
  • state の中身も、クラス名も、コンポーネントの分け方も、利用者には見えていない。 それらを見たテストは、困っていない変更で落ちる
  • 要素の探し方には優先順位がある。 getByRole → getByLabelText → getByText → getByTestId
  • getByTestId は最後の手段。 使いたくなった時点で、たいていアプリ側が間違っている(<div onClick>、結ばれていないラベル、空の alt)
  • getBy は無いと失敗、queryBy は null を返す、findBy は待つ。 「無いこと」を確かめられるのは queryBy だけ
  • fireEvent ではなく userEvent。 fireEvent は押せないボタンでも押せてしまうし、1文字ずつ打たない
  • setTimeout で待たない。 時間ではなく状態を待つ。要素なら findBy、それ以外は waitFor
  • act の警告を act() で消さない。 ほぼ確実に await の忘れで、待っていないことは何も変わっていない
  • fetch を差し替えると、URLを間違えていてもテストが通る。 MSW はネットワークの層で横取りするので、onUnhandledRequest: "error" が間違いを落としてくれる
  • カバレッジを目標にしない。 expect が1つも無いテストでもカバレッジは上がる。 「0%のファイルを探す地図」として使う
  • 1つの画面で完結する話はこの層、複数のシステムをまたぐ話は Playwright。 比率は、この層が大多数
  • どこに書けばいいか分からないときは、一度壊れた場所に1本足す。 想像で選んだ100本より確実

そして、いちばん残ったのはこれです。

getByRole で要素が見つからないとき、直すべきなのはテストではなくアプリだった。

テストが書きにくい画面は、キーボードでも操作しにくく、読み上げソフトからも読みにくい画面でした。 テストは、アプリの品質を測る道具であると同時に、アクセシビリティの点検表でもありました。これに気づいてから、テストを書く時間が半分になりました。

React深掘りシリーズの、ここまで

このシリーズは、JSXがただの関数呼び出しだったところから始めて、props と state、再描画の仕組み、useState と useReducer、key、useEffect、useMemo と useCallback、useRef、Context、フォーム、カスタムフック、データ取得と進んで、この回まで来ました。 全部を通して一貫していたのは、「なんとなく動いた」を1つずつ潰して、なぜそう動くのかを自分の手で確かめるという一点だけでした。本線に戻れば、React はここまで深く知らなくても先に進めます。 それでも、ここまでの回を書いている間に「調べても分からない」が「たぶんここだろう」に変わったのが、いちばんの収穫でした。深掘りは、本線を止めないための保険です。 詰まった回だけ戻ってきてください。


参考リンク


次に読む

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

記事
← 前の記事状態管理ライブラリ — 入れる前に大半は要らなかった
→ 次の記事ReactとTypeScript — anyを1つで型検査が消える

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

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

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

Frontend›React — Testing
  • 振る舞いをテストする / 要素の探し方の優先順位
  • MSW でネットワークをモックする

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

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

コメント

コメントする

目次