「テストを書いた」と言うとき、たいてい単体テストのことだけを指しています。 このサイトでも、Vitest の回も node –test の回も、部品ひとつを確かめる話でした。
ところが実務で「テスト工程」と言われたら、単体・結合・総合・受入の4つがあり、それぞれ「誰が」「何を根拠に」「何を合格とするか」が違います。 ここを分けずにいると、「全部テストしました」と言ったのに本番で落ちる、という一番まずい形になります。
この記事は、前回書いた要件定義書と設計書を根拠にして、4つのテストを実際に1本ずつ作る回です。
対象レベル: 中級 / 区分: 必修
この記事でわかること
- 4つのテストが「何を根拠にするか」で分かれていること
- テストケースの書き方——手順ではなく、条件と期待結果を書く
- 境界値と同値分割で、ケースを減らしながら漏れを減らすやり方
- デグレを、わざと起こして検出できるようにすること
- エビデンスが何のために要るのか(そして、何なら省けるのか)
この記事でやること
- 4つのテストを、V字の左と対応づける
- 境界値でテストケースを作る(山場①)
- 単体・結合・総合・受入を1本ずつ、実際に走らせる
- わざとデグレを起こして、どのテストが気づくか見る(山場②)
- 合否の記録を、自動で残す形にする
先に知る言葉
この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| テストケース | 「この条件のとき、こうなる」を1つ書いたもの。手順書ではない |
| 同値分割 | 同じ結果になる入力をひとまとめにして、代表を1つだけ試す |
| 境界値 | その塊の境目。バグはここに集まる |
| デグレ | 直したつもりが、動いていた別の場所を壊すこと |
| エビデンス | 「確かに合格した」と後から示せる記録 |
① 4つのテストは「根拠」で分かれている
| テスト | 根拠にする文書 | 確かめること | 落ちたとき直す場所 |
|---|---|---|---|
| 単体 | 詳細設計 | 部品1つが、決めたとおりに動く | その部品 |
| 結合 | 基本設計 | 部品どうしが繋がる(API・DB・画面) | 繋ぎ方・インタフェース |
| 総合 | 基本設計+非機能要件 | システム全体が、条件下で成立する | 構成・設定・性能 |
| 受入 | 要件定義 | 使う人が、目的を達せられる | 要件の解釈 |
「単体テストが全部通ったから品質は大丈夫」が成り立たない理由が、この表にあります。 単体テストが根拠にしているのは詳細設計だけです。設計そのものが要件とずれていたら、単体テストは全部通ります。
② 境界値でケースを作る
前回の要件から1つ選びます。
FR-01 利用者は、ひとことを投稿できる
(本文は 1 文字以上 140 文字以内)
全部の文字数を試すことはできません。 そこで、結果が同じになる範囲でまとめます(同値分割)。
0文字 1〜140文字 141文字〜
┌────────┬──────────────────┬──────────┐
│ エラー │ 成功 │ エラー │
└────────┴──────────────────┴──────────┘
↑ ↑ ↑ ↑
0 1 140 141 ← ここだけ試す(境界値)
3つの塊があるので、代表3つ+境目4つ。 実際に書くのは、重複を除いた5ケースです。
cat > docs/testcases.md <<'EOF'
# テストケース(FR-01 投稿)
| ID | 区分 | 条件 | 期待結果 |
|----|------|------|----------|
| TC-001 | 単体 | 本文 0 文字 | 400 / メッセージ「本文を入力してください」 |
| TC-002 | 単体 | 本文 1 文字 | 201 / 保存される |
| TC-003 | 単体 | 本文 140 文字 | 201 / 保存される |
| TC-004 | 単体 | 本文 141 文字 | 400 / メッセージ「140文字以内で入力してください」 |
| TC-005 | 単体 | 本文が空白のみ(全角空白 3 文字) | 400(空白だけは 0 文字と同じ扱い) |
EOF
TC-005 が、この5つの中で一番よくバグります。 「1文字以上」を
length > 0で実装すると、全角空白だけの投稿が通ります。境界は文字数だけではなく、「何を1文字と数えるか」にもあります。 文字コードの回で見た「文字数が数えられない」問題が、そのままここに出ます。
テストケースは手順書ではない
✗ 1. ブラウザを開く 2. ログインする 3. 投稿欄に入力する 4. ボタンを押す
✓ 条件: 本文 141 文字 / 期待結果: 400 と「140文字以内で入力してください」
手順を書くと、画面が変わるたびに全ケースが腐ります。 条件と期待結果だけにしておけば、実行方法(画面から・curl から・自動テストから)が変わっても、ケースは生き残ります。
③ 単体テスト —— 部品1つを、詳細設計どおりに
cd ~/hitokoto
cat > test/validate.test.js <<'EOF'
import { test } from "node:test";
import assert from "node:assert/strict";
import { validateBody } from "../src/validate.js";
// TC-001〜TC-005(docs/testcases.md)
const cases = [
["TC-001", "", false],
["TC-002", "a", true ],
["TC-003", "あ".repeat(140), true ],
["TC-004", "あ".repeat(141), false],
["TC-005", " ", false],
];
for (const [id, body, ok] of cases) {
test(`${id}: ${JSON.stringify(body).slice(0, 12)}`, () => {
assert.equal(validateBody(body).ok, ok);
});
}
EOF
node --test test/
✔ TC-001: ""
✔ TC-002: "a"
✔ TC-003: "ああああああ…
✖ TC-005: " "
...
# fail 1
TC-005 が落ちました。 予想どおりです。trim() を足して直します。テストケースをテスト名に書いておくと、落ちたときにどの条件かがすぐ分かります。
④ 結合テスト —— 部品どうしが繋がるか
単体テストは validateBody しか見ていません。API から DB まで通したときに繋がるかは、別の話です。
cat > test/api.test.js <<'EOF'
import { test, before, after } from "node:test";
import assert from "node:assert/strict";
import { startServer } from "../src/server.js";
let base;
before(async () => { base = await startServer({ port: 0 }); });
after(async () => { await base.close(); });
test("IT-001: POST /api/posts → GET /api/posts に出てくる", async () => {
const r1 = await fetch(`${base.url}/api/posts`, {
method: "POST",
headers: { "Content-Type": "application/json", Cookie: base.testCookie },
body: JSON.stringify({ body: "結合テストの投稿" }),
});
assert.equal(r1.status, 201);
const r2 = await fetch(`${base.url}/api/posts`);
const list = await r2.json();
assert.ok(list.some((p) => p.body === "結合テストの投稿"));
});
test("IT-002: 未ログインでは投稿できない(FR-04)", async () => {
const r = await fetch(`${base.url}/api/posts`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ body: "だめなはず" }),
});
assert.equal(r.status, 401);
});
EOF
node --test test/
結合テストで初めて見つかるのは、たいてい次の3つです。
| よく出る食い違い | 単体では見つからない理由 |
|---|---|
項目名の綴り(body と text) | 片方ずつは正しく動く |
| 日付の形式(ISO 8601 とローカル表記) | それぞれの中では一貫している |
| NULL の扱い(空文字か NULL か) | DB とアプリで解釈が違う |
⑤ 総合テスト —— 非機能を確かめる
ここが飛ばされやすい工程です。 機能は全部動いているので、やらなくても「完成」に見えます。前回書いた非機能要件を根拠に測ります。
# NFR-01: 1万件で一覧が 1 秒以内
node scripts/seed.js 10000
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts
2.418
落ちました。 索引が効いていません。詳細設計に「posts(created_at DESC) の索引を張る(NFR-01 のため)」と書いてあったのに、実装で入れ忘れています。
mysql -u app -p appdb -e "CREATE INDEX idx_posts_created ON posts(created_at DESC);"
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts
0.061
これは単体テストでも結合テストでも絶対に見つかりません。 どちらもデータが数件しか無いからです。非機能は、その条件を作らないと落ちない——だから工程として分かれています。
可用性の要件(NFR-02・NFR-03)も、ここで確かめます。
# バックアップから復元できるか(RTO/RPO の確認)
mysqldump -u root -p appdb > /tmp/backup.sql
mysql -u root -p -e "DROP DATABASE appdb; CREATE DATABASE appdb;"
time mysql -u root -p appdb < /tmp/backup.sql
curl -s http://localhost:3000/api/posts | head -c 80
「バックアップを取っている」ではなく「戻せた」まで確かめます。 デプロイの回でも同じことを書きましたが、復元を1回もやっていないバックアップは、無いのと同じです。
⑥ 受入テスト —— 要件定義を根拠に
受入テストだけは、作った人ではなく使う人が、要件の言葉で確かめます。 実装の言葉を1つも使わないのが目印です。
| ID | 要件 | 確かめること | 結果 |
|----|------|--------------|------|
| UAT-01 | FR-01 | ひとことを投稿すると、一覧の先頭に出る | ✅ |
| UAT-02 | FR-03 | 他人の投稿には削除ボタンが出ない | ✅ |
| UAT-03 | FR-04 | ログアウト状態では投稿欄が出ない | ✅ |
| UAT-04 | NFR-02 | 壊してから、手順書だけで 24 時間以内に戻せる | ✅ |
UAT-04 のように「手順書だけで」と条件を付けると、属人性が測れます。 書いた本人が記憶で復旧できても、それは合格ではありません。
⑦ わざとデグレを起こす
テストが本当に役に立つかは、「壊したときに落ちるか」でしか分かりません。 一度わざと壊します。
# 一覧の並びを、うっかり昇順に変えてしまう(よくある事故)
sed -i 's/ORDER BY p.created_at DESC/ORDER BY p.created_at ASC/' src/posts.js
node --test test/
# pass 7
# fail 0
全部通ってしまいました。 FR-02「新しい順に見られる」を確かめるケースが1つも無いからです。要件はあるのにテストが無い——前回の check_trace.sh が探していたのは、まさにこれです。
cat >> test/api.test.js <<'EOF'
test("IT-003: 一覧は新しい順(FR-02)", async () => {
const list = await (await fetch(`${base.url}/api/posts`)).json();
const times = list.map((p) => new Date(p.created_at).getTime());
assert.deepEqual(times, [...times].sort((a, b) => b - a));
});
EOF
node --test test/ # 今度は落ちる
sed -i 's/ORDER BY p.created_at ASC/ORDER BY p.created_at DESC/' src/posts.js
node --test test/ # 直すと通る
「直したら通った」だけでは足りません。 「壊したら落ちた」を先に見る——このサイトで検査を足すときに毎回やっていることを、テスト工程でもそのままやります。落ちないテストは、あっても無くても同じです。
⑧ 記録(エビデンス)を、自動で残す
エビデンスは「あとから、やったと示すため」に要ります。 画面のスクリーンショットを全ケースぶん撮るのは現実的ではないので、機械が出す記録を残します。
mkdir -p docs/evidence
node --test --test-reporter=tap test/ > "docs/evidence/$(date +%Y%m%d_%H%M)_unit.tap" 2>&1
curl -s -o /dev/null -w "%{time_total}\n" http://localhost:3000/api/posts \
> "docs/evidence/$(date +%Y%m%d_%H%M)_nfr01.txt"
ls docs/evidence/
| 残す | 残さない |
|---|---|
| 実行日時・実行したコマンド・出力 | 手順どおりに操作した画面の連続写真 |
| 失敗した記録(直した経緯とセット) | 成功だけを選んで並べたもの |
| 環境(版・件数・設定) | —— |
失敗の記録を消さないでください。 「一度落ちて、直して、通った」という履歴のほうが、最初から緑の記録より価値があります。
完成の判定
| # | 確かめること | 合格の形 |
|---|---|---|
| 1 | 境界値のケースがある | 0 / 1 / 140 / 141 / 空白のみ |
| 2 | 結合で繋がりを見ている | POST したものが GET に出る |
| 3 | 非機能を測っている | 1万件で 1 秒以内という数字が出ている |
| 4 | 受入が要件の言葉で書けている | 実装用語が 1 つも出てこない |
| 5 | 壊したら落ちる | 並び順を変えると IT-003 が失敗する |
つまずいたところ
単体テストが全部通るのに、本番で落ちる
単体テストの根拠は詳細設計だけです。 設計自体が要件とずれていたら、全部通ります。上の工程のテストを飛ばしていないか、V字の対応表で確かめてください。
結合テストが不安定になる
テストどうしがデータを共有しています。各テストの前に、そのテストが使うデータを作るのが確実です。Docker で CI を回した回と同じで、使い捨てにできる状態を作るのが根本の解です。
ケースが増えすぎて、実行に時間がかかる
同値分割ができていません。同じ結果になる入力をまとめて、境目だけ試します。 1〜140 文字を全部試す必要はありません。
受入テストで、いまさら仕様の食い違いが出る
これは工程の問題ではなく、要件定義の問題です。 受入テストで見つかるのは仕様の解釈違いで、テストが遅かったのではなく、要件が曖昧だったということです。次の案件では、要件に「確かめ方」を書く欄を足してください。
後片づけ
cd ~/hitokoto
node scripts/seed.js --clean # 1万件の投入データを消す
mysql -u app -p appdb -e "SELECT COUNT(*) FROM posts;"
よくある質問
- 単体テストと結合テストの境界がよく分かりません
- 外部に触れるかどうかで切るのが実務的です。関数を呼んで戻り値を見るだけなら単体、データベースやネットワークやファイルに触れるなら結合と考えると、判断がぶれません。呼び出す相手を偽物に差し替えているかどうか、と言い換えても構いません。厳密な定義は現場ごとに違うので、チームの中で一貫していることのほうが大事です。
- 総合テストは個人開発でも必要ですか
- 必要です。ただし規模は小さくて構いません。データを本番想定の件数まで増やして応答時間を測ること、バックアップから実際に復元してみることの2つだけでも、単体テストでは絶対に見つからない問題が見つかります。個人開発で一番よく起きるのは、データが増えた瞬間に遅くなる問題と、バックアップが復元できない問題です。
- エビデンスはどこまで残せばよいですか
- 実行したコマンドと、その出力と、実行日時と環境が残っていれば足ります。画面の写真は、機械の出力では示せないもの(表示崩れや操作性)に限ってください。全ケースの画面を撮る運用は作業量が大きいわりに、あとから読み返されることがほとんどありません。何のために残すかを決めてから、必要な形式を選んでください。
- テストケースは実装前と実装後、どちらで書きますか
- 実装前です。実装を見てから書くと、実装がそうなっているという理由でケースを作ってしまい、設計とのずれを見つけられなくなります。テスト駆動開発が先に失敗するテストを書くのと同じ理屈で、根拠にする文書を見ながら書けば、実装を見なくてもケースは作れます。
- デグレを防ぐには、どのテストを増やすべきですか
- 結合テストを増やすのが費用対効果として高くなります。デグレの多くは部品の中ではなく、部品どうしの前提のずれで起きるからです。ただし増やす前に、この記事でやったように一度わざと壊して、いまあるテストが気づくかを確かめてください。落ちないテストをいくら増やしても、デグレは止まりません。
まとめ — 理解できたこと
- 4つのテストは「根拠にする文書」で分かれている。 粒度でも規模でもない
- 単体テストが全部通っても、設計が要件とずれていれば意味がない
- テストケースは手順ではなく、条件と期待結果。 手順を書くと画面が変わるたびに腐る
- 境界値にバグが集まる。 0 / 1 / 上限 / 上限+1 / 空白だけ
- 非機能は条件を作らないと落ちない。 だから工程として分かれている
- 「壊したら落ちる」を先に見る。 落ちないテストは、あっても無くても同じ
参考リンク
- IPA — ソフトウェア開発におけるテスト工程の定義
- Node.js 公式 —
node --testとレポーター
次に読む
この記事は 【第8段階】深掘り の 23 / 30 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | 要件定義と基本設計・詳細設計 — V字モデルの対応表 |
| → 次の記事 | 運用設計で決める6項目 — 手順書に判定基準を書く |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント