実装を直すたびにテストが落ちるのは、実装の詳細をテストしているからです。壊れにくいテストの書き方に変えます。
これは深掘りです。本線の順路ではありません。 本線のフロントエンドのテストの回でテストを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%にしても、確かめていない振る舞いはいくらでも残る
この記事でやること
~/reactlab/を新しく作り、ポート5187で起動する(本線の~/react-demo/は触りません)- Vitest + React Testing Library + jsdom を入れ、
vite.config.jsとsrc/setupTests.jsを全文で用意する - 同じ画面に対して、悪いテストと良いテストを両方書き、クラス名だけを変えてどちらが落ちるかを見る
userEventで入力とクリックをテストし、findByとwaitForで非同期を待つfetchを差し替えたテストを1本書いてから、MSW に置き換え、URLをわざと間違えて両者の差を見る
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| クエリ | React Testing Library で要素を探す関数。getByRole getByText など |
| ロール(role) | その要素が何であるか。ボタン・見出し・入力欄・リスト項目など。HTMLのタグに最初から付いている |
| アクセシブルな名前 | その要素が、読み上げソフトから何と呼ばれるか。ボタンなら普通は書いてある文字、入力欄なら結びついたラベルの文字 |
| モック / スタブ | 本物の代わりに置く偽物。テストの都合で、返ってくる値を自分で決められるようにする |
| MSW(Mock Service Worker) | 通信そのものを横取りして、偽の応答を返すライブラリ。アプリ側のコードは1行も変えない |
| リクエストハンドラ | MSW で 「このURLにこう来たら、こう返す」を1つ書いたもの |
| フレーキーテスト | 同じコードなのに、通ったり落ちたりするテスト。原因はたいてい「待ち方」 |
act | React が 「状態の更新が終わるまで待つ」ための囲い。テスト中にこの外で更新が起きると警告が出る |
| カバレッジ | テストを走らせたときに、コードの何行が実行されたかの割合。「確かめた」割合ではない |
① 原則を先に決める — 実装ではなく、振る舞いをテストする
道具を入れる前に、ここを決めます。 ここを飛ばすと、設定は正しいのに無価値なテストが量産されます。
原則は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の中で、ホームディレクトリに戻って作ります。
質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。
eslint.config.js index.html package.json public README.md src vite.config.js
この一覧が出れば成功です。
すでに
~/reactlab/がある場合(この深掘りシリーズの別の回で作っている場合)は、作り直さずにそのまま使って構いません。npm create viteは飛ばして、cd ~/reactlab && npm installだけ実行してください。
ポートを開ける
本線が 5173番を使っています。 ぶつからないように、この記事は 5187番でやります。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5187/tcp ALLOW Anywhere
5187/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。
sudoとufwについてはLinuxのファイアウォールの回にあります。閉じ方は後片づけに書きました。
道具を入れる
6つ入りました。1つずつ、何なのかを書きます。
| 入れたもの | 役割 |
|---|---|
vitest | テストランナー本体。 テストのファイルを探して、実行して、結果をまとめる |
jsdom | Node.js の中に、DOM だけを真似して作る。 これが無いと document is not defined で落ちます |
@testing-library/react | React を描画して、クエリで触れるようにする |
@testing-library/dom | クエリの本体。 上のものが中で使っているのに、自動では入りません |
@testing-library/jest-dom | toBeInTheDocument() のような、DOM向けの判定を expect に足す |
@testing-library/user-event | 人の操作をなぞる(クリック・入力・タブ移動) |
-D は「開発のときだけ要るもの」という印です。利用者に配る dist/ には1バイトも入りません(ビルドツールの回)。
入ったか確かめます。
vitest/3.2.4 linux-x64 node-v22.14.0
数字は違って構いません。 3 系が入っていれば、この記事のとおりに進みます。
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: true | test や expect を import せずに使えるようにする |
setupFiles | 各テストファイルの前に、必ず読み込むファイル |
plugins: [react()]を消さないでください。 JSXを変換しているのはこれです(JSXの回)。テストのときも同じプラグインが使われます。 テスト用に変換の設定をもう一度書かずに済むのが、Vitest を選ぶ唯一にして最大の理由です。
globals: trueは手抜きではありません。 React Testing Library は、afterEachが使える環境なら、1本終わるたびに自動で描画を片づけます。falseのままだと前のテストの描画が残り、「同じ要素が2つ見つかりました」という意味の分からない失敗が出ます。
src/setupTests.js(新規)
import "@testing-library/jest-dom/vitest";
いまは1行です。 ⑤で MSW を入れるときに、ここへ追記します。
ファイル名に
.test.を入れないでください。 Vitest がテストとして拾うのは*.test.js/*.test.jsx(や.spec.)という名前だけです。setup.test.jsにすると、中身が空のテストファイルとして実行され、怒られます。
package.json の scripts
"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回走って、結果を返して、終わります。
起動して、画面が出ることを確かめる
server: を書いたので、オプションは要りません。 ホストの Windows のブラウザで http://192.168.226.50:5187/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。
[スクリーンショット: 01_reactlab起動.png] ホストのブラウザで :5187 を開き、Vite + React の初期画面が出ているところを撮ってください。アドレスバーのポート番号が 5187 になっているのが見える形で。
止め方: ターミナルで Ctrl+C。テストを走らせている間は、止めておいて構いません。 テストはブラウザもサーバーも使いません。
③ テストする画面を作る
テストの前に、テストされる側が要ります。 ①で見た TaskBox を、実際に作ります。
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 から呼びます。
import TaskBox from "./components/TaskBox.jsx";
export default function App() {
return (
<main>
<h1>reactlab</h1>
<TaskBox />
</main>
);
}
ブラウザで :5187 を開き、入力して「追加」を押してみてください。 一覧に増えれば、準備完了です。この時点では、まだテストは1本もありません。
④ 要素の探し方には、優先順位がある
ここが、この記事で一番効く節です。
React Testing Library には、要素の探し方が20種類近くあります。 そしてどれを使っても、たいてい見つかります。 だから初心者は、「見つかった方法」を使ってしまいます。
公式が優先順位を明記しているのは、そのためです。
優先順位(上から順に試す)
| 順位 | クエリ | 何で探すか | 使ってよい場面 |
|---|---|---|---|
| 1 | getByRole | 役割 + アクセシブルな名前 | 原則これ。 ボタン・見出し・リンク・入力欄・リスト項目 |
| 2 | getByLabelText | 結びついたラベルの文字 | フォームの入力欄。ラベルは利用者も見ている |
| 3 | getByPlaceholderText | プレースホルダ | ラベルが無いときの妥協。プレースホルダはラベルの代わりにならない |
| 4 | getByText | 画面に出ている文字そのもの | 押せない文字(説明文・エラーメッセージ・空のときの案内) |
| 5 | getByDisplayValue | 入力欄にいま入っている値 | 編集画面で、初期値を確かめたいとき |
| 最後の手段 | getByTestId | data-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つ | 複数 | |
|---|---|---|
| 無いと失敗 | getByRole | getAllByRole |
| 無くてもよい | queryByRole | queryAllByRole |
| 待つ | findByRole | findAllByRole |
一番やる間違いは、これです。
// ❌ 「無いこと」を 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本目 — 追加すると、一覧に出る
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();
});
走らせます。
✓ 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本目 — ボタンを押したら、表示が変わる
「増える」以外の、いちばん基本の形です。 開閉するパネルを作ります。
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>
);
}
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" に変えて保存してください。
Test Files 2 passed (2)
Tests 3 passed (3)
1本も落ちません。 クラス名は、テストがどこにも書いていないからです。
次に、本当の不具合を入れます。 handleSubmit の中の setTasks(...) の行を、コメントアウトしてください。
// setTasks([...tasks, { id: seq, title }]);
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 を差し替える
まず、通信する画面を作ります。
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 を差し替えたテストが、これです。
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);
});
通ります。 通りますが、問題があります。
fetch の差し替えには、3つの問題がある
UserList.jsx のURLを、わざと間違えてください。
fetch("/api/userz")
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 を使っている前提が要る |
| MSW | HTTPのリクエスト | 何を使っていても関係ない(fetch / axios / TanStack Query) |
入れます。
リクエストハンドラを書きます。「このURLにこう来たら、こう返す」を並べたファイルです。
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と書くとそのアドレスを基準に解決されるため、環境によって一致したりしなかったりします。*を頭に置くと、ホスト名が何であっても一致します。 これで悩んだ話は「つまずいたところ」に書きました。
テストのときだけ動かすサーバー役を作ります。
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() | 全部終わったら、横取りをやめる |
テストを書きます。
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で書いたファイルは、もう要りません。消します。
✓ 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 に変えてください。
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本のほうが価値があります。
カバレッジを目標にしない
カバレッジは、こう測れます。
% 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。
確認: 何も出なければ、止まっています。
ポートを閉じる
確認: 5187/tcp の行が消えていれば成功です。5173番は、本線で使うので残してあります。
テストが緑の状態で終える
壊したまま終えると、次に開いたときに「何かが壊れている」と勘違いします。
確認: Tests 5 passed が出れば、④と⑥で入れた細工は全部戻っています。 落ちる場合は、UserList.jsx の URL(/api/users)と、TaskBox.jsx の setTasks の行を確認してください。
プロジェクトをどうするか
~/reactlab/ は、消しても消さなくても構いません。
残す場合、node_modules が数百MBあります。中身は package.json から復元できます。
戻すときは cd ~/reactlab && npm install だけです(npmの回)。
丸ごと消す場合。
~/react-demo/ は絶対に消さないでください。 本線がその続きで進みます。
確認: 本線のファイル一覧が出れば、無事です。
まとめ
- 「実装を直すたびに落ちるテスト」は、テストの書き方が間違っている。 見てよいのは、利用者から見えるものだけ
- state の中身も、クラス名も、コンポーネントの分け方も、利用者には見えていない。 それらを見たテストは、困っていない変更で落ちる
- 要素の探し方には優先順位がある。
getByRole→getByLabelText→getByText→getByTestId getByTestIdは最後の手段。 使いたくなった時点で、たいていアプリ側が間違っている(<div onClick>、結ばれていないラベル、空のalt)getByは無いと失敗、queryByはnullを返す、findByは待つ。 「無いこと」を確かめられるのはqueryByだけfireEventではなくuserEvent。fireEventは押せないボタンでも押せてしまうし、1文字ずつ打たないsetTimeoutで待たない。 時間ではなく状態を待つ。要素ならfindBy、それ以外はwaitForactの警告を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 はここまで深く知らなくても先に進めます。 それでも、ここまでの回を書いている間に「調べても分からない」が「たぶんここだろう」に変わったのが、いちばんの収穫でした。深掘りは、本線を止めないための保険です。 詰まった回だけ戻ってきてください。
参考リンク
- roadmap.sh — React — Testing の項目がどこに置かれているか
- Testing Library — About Queries(優先順位の公式な根拠) — この記事の④は、ここに書かれている順番そのものです
- Testing Library — React Testing Library —
renderとscreenの一次情報 - Testing Library — user-event —
fireEventとの違いも書かれています - Testing Library — Async Methods —
findByとwaitForの仕様 - Vitest — Getting Started —
vitestとvitest runの違いもここに - Vitest — Configuring Vitest —
environmentglobalssetupFilesの一覧 - MSW — 公式ドキュメント — ハンドラの書き方
- MSW — Node.js での統合 —
setupServerとonUnhandledRequest - React 公式 — act — 警告の意味と、正しい使いどころ
- Kent C. Dodds — Testing Implementation Details — ①の原則の出どころ
- Kent C. Dodds — Stop Mocking Fetch — ⑥で
fetchの差し替えをやめた理由
次に読む
この記事は 【深掘り】React の 18 / 24 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- 振る舞いをテストする / 要素の探し方の優先順位
- MSW でネットワークをモックする
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント