---
title: 受講者用_ダッシュボードテスト自動化講座
tags: 
author: [Yukiko](https://image.docswell.com/user/yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/VJP3XP1XE8.jpg?width=480
description: 受講者用_ダッシュボードテスト自動化講座 by Yukiko
published: November 14, 26
canonical: https://image.docswell.com/s/yukiko_it/KPR1RG-2026-11-14-194502
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/VJP3XP1XE8.jpg)

うさうさ研修工房 ｜ Udemy講座 受講者用
実務で使える！ダッシュボードの
テスト自動化
HTML/CSS/JS ｜ Vitest・Playwright・CI ｜ Windows / VSCode 対応


# Page. 2

![Page Image](https://bcdn.docswell.com/page/2EV4L2Y3JQ.jpg)

この講座で作るもの
コードを変えても、安心して出せる
コードを変更
自動テスト
CI
安心してリリース
機能追加・修正
74件が数秒〜十数秒
push のたびに実行
壊れたらすぐ分かる
数字・表示・操作・見た目の4つの壊れ方を、自動で見張る仕組みを作る
題材：売上KPIダッシュボード（ビルド不要の素のHTML/CSS/JS）
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/57G1XR9YEL.jpg)

はじめに
対象・到達目標・前提
対象
到達目標
前提
社内ツール・ダッシュボードを作
る
守るべき所と、守る層を選べる
HTML/CSS/JSの基礎（ES
Modules）
フロントエンド／DXエンジニア
ユニット・DOM・E2Eのテスト
を書ける
テストを「後回し」にしがちな人
CIで回し続ける仕組みを作れる
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
Windows PC・VSCode
Node.js 22（LTS）が入っている
こと
3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/4EQD8VW6JP.jpg)

全体ロードマップ
スロープ設計：知識 → 橋渡し → 実践
前半｜知識編
1
2
3
4
なぜ自動化か
環境と題材
テストしやすい設計
データと設計
壊れ方と守る層
リポジトリを動かす
純粋関数・分離
境界値・日付の罠
橋渡し：最初のテストを書いて、赤から緑にする
後半｜実践編
5
6
7
8
ユニットテスト
DOMテスト
E2Eテスト
品質を回し続ける
Vitest
jsdom
Playwright
回帰・a11y・CI
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/KJ4Z2MKM71.jpg)

PART 1
前半｜知識編
壊れ方・環境・設計・テストデータを押さえる（Chapter 1〜4）


# Page. 6

![Page Image](https://bcdn.docswell.com/page/LE1RM8XYEG.jpg)

Chapter 1 ｜ なぜ自動化か
ダッシュボードの5つの壊れ方
壊れ方
例
起きること
数字
集計ミス・丸め・日付のずれ
誤った数字で意思決定してしまう
表示
整形・空状態・0件の平均
「平均0円」など誤解を招く表示
操作
フィルタ・並べ替えが効かない
画面は出るが使えない
通信
CSV取得の失敗・不正な行
画面が真っ白／数字が静かにずれる
見た目
スマホで横にはみ出す・読めない色
使われなくなる
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/GEW13ZN172.jpg)

Chapter 1 ｜ なぜ自動化か
何を、どの層で守るか
層
守るもの
速さ
本題材の件数
ユニット（Vitest）
数字・整形・集計
ミリ秒
49件
DOM（jsdom）
表示・操作・異常系
数百ミリ秒
13件
E2E（Playwright）
通信・実ブラウザ・見た目
数秒
12件
•
速い層を厚く、遅い層は薄く（壊れると痛い所だけ）
•
同じ不具合を複数の層で守らない（保守が重くなる）
•
迷ったら「一番速い層で書けないか」を先に考える
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/47ZPV13XE3.jpg)

Chapter 2 ｜ 環境と題材
最小セットアップ・チェックリスト
ツール
用途
確認コマンド
Node.js 22（LTS）
テスト実行の土台
node -v
npm
パッケージ管理
npm -v
VSCode
編集・ターミナル
code --version
Git
CI・履歴管理
git --version
Chromium
E2E 用ブラウザ
npx playwright install chromium
※ 講師の確認環境：Node.js 22 / Vitest 5.1 / jsdom 31 / Playwright 1.65（Linux）。Windowsでの差は各自で確認する
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/YJ6M5LXP7V.jpg)

Chapter 2 ｜ 環境と題材
リポジトリを動かしてみよう
PowerShell
•
画面：http://localhost:4173
npm install
npx playwright install chromium
•
js/：計算と描画のコード
•
tests/unit・dom・e2e：層ごとのテスト
•
data/sales.csv：売上データ
•
tools/：結果をNotionへ記録する変換ツ
ール
npm run serve
npm test
npm run test:e2e
# 画面を確認
# ユニット＋DOM
# Playwright
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/GJ5ZY1XPE4.jpg)

Chapter 2 ｜ 題材アプリ
期待値を先に決めておく
KPI
期待値
確認方法
売上合計
¥993,300
別の方法（Python）で独立に計算
件数
15件
不正な1行は除外
平均単価
¥66,220
売上 ÷ 件数
数量合計
36個
•
CSVには不正な行を1行入れてある（2026-02-30・金額 abc）
•
画面は止まらず「読み込めなかった行：1件」と警告する
•
期待値を別の方法で出しておくと、テストの正しさ自体を疑える
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/9E2RG1XZJR.jpg)

Chapter 3 ｜ テストしやすい設計
同じ機能でも、設計で難しさが変わる
テストしにくい書き方
テストしやすい書き方
・DOM取得→計算→表示が1つの関数に混在
・グローバルの fetch / document を直接使う
・計算は「入力→出力」の純粋関数
・描画は薄く、計算は持たない
・テストにブラウザが必須で、遅く不安定
・依存（fetch・document）は引数で渡す
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/D7YDVZ8N7M.jpg)

Chapter 3 ｜ テストしやすい設計
責務を4つに分ける
data.js
metrics.js
render.js
app.js
CSV検証
絞込・集計
DOM/SVG描画
組み立て
•
format / data / metrics は純粋関数 → ブラウザ不要、数ミリ秒でテストできる
•
render は「受け取った値を表示するだけ」。計算を持たせない
•
app は部品をつなぐ。外部依存はここで差し替え可能にする
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/VEN6M3QVE8.jpg)

Chapter 3 ｜ テストしやすい設計
依存は引数で受け取る
js/app.js
•
本番は標準の fetch を使う
export async function initDashboard({
document,
fetchFn = globalThis.fetch,
csvUrl = &#039;data/sales.csv&#039;,
} = {}) {
const res = await fetchFn(csvUrl);
if (!res.ok) throw new Error(
`HTTP ${res.status}`);
...
}
•
テストでは「偽の fetch」を渡す
•
成功・500エラー・通信断を、サーバー
無しで再現できる
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
13


# Page. 14

![Page Image](https://bcdn.docswell.com/page/Y79LN9DVJ3.jpg)

Chapter 3 ｜ テストしやすい設計
data-testid で「探しやすく」する
index.html
•
&lt;p data-testid=&quot;kpi-revenue&quot;&gt;—&lt;/p&gt;
&lt;select data-testid=&quot;filter-dept&quot;&gt;...&lt;/select&gt;
&lt;tbody data-testid=&quot;table-body&quot;&gt;&lt;/tbody&gt;
&lt;p data-testid=&quot;error-banner&quot; hidden&gt;&lt;/p&gt;
見た目やクラス名を変えても、テストが
壊れない
•
意味のある名前を付ける（kpi-revenue
など）
•
ボタン・見出しは getByRole で探せる
ので、data-testid は必要な所だけ
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
14


# Page. 15

![Page Image](https://bcdn.docswell.com/page/G78XK934ED.jpg)

Chapter 4 ｜ データと設計
テストデータは小さく・固定・意図が読める
tests/unit/metrics.test.js
•
const rec = (date, dept, amount,
quantity = 1, product = &#039;P&#039;) =&gt;
({ date, dept, product, amount, quantity });
月末・月初の日付を入れておく（境界値
）
•
数字は暗算できる大きさに
•
本物のCSVに依存しない
const DATA = [
rec(&#039;2026-01-31&#039;, &#039;EC&#039;, 4200, 4),
rec(&#039;2026-02-01&#039;, &#039;営業&#039;, 100000),
rec(&#039;2026-02-14&#039;, &#039;EC&#039;, 14700, 3),
rec(&#039;2026-02-28&#039;, &#039;店舗&#039;, 10000, 2),
rec(&#039;2026-03-01&#039;, &#039;EC&#039;, 5000),
];
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
15


# Page. 16

![Page Image](https://bcdn.docswell.com/page/L7L8ZWVVJR.jpg)

Chapter 4 ｜ データと設計
境界値と同値分割で、ケースを絞る
ケース
入力
期待
開始日ちょうど
from = 2026-02-01
含む
終了日ちょうど
to = 2026-02-28
含む
開始日の前日
from = 2026-02-02 のとき 02-01
含まない
終了日の翌日
to = 2026-02-27 のとき 02-28
含まない
0件
calcKpi([])
平均単価は null
金額が空欄
amount = &#039;&#039;
エラー行として除外
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
16


# Page. 17

![Page Image](https://bcdn.docswell.com/page/4EM6V9GN7W.jpg)

Chapter 4 ｜ データと設計
日付の罠：タイムゾーン
js/metrics.js
•
日本時間で通っても安心できない
// NG：実行環境のタイムゾーンで月が変わる
const d = new Date(&#039;2026-02-01&#039;); // UTC 0:00
d.getMonth() + 1 // 米国西海岸では 1月
•
npm run test:tz で米国時間でも実行す
る
•
実際に書き換えると、東京は全件通過・
米国時間は失敗した
// OK：日付は文字列のまま扱う
r.date.slice(0, 7) // &#039;2026-02&#039;
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
17


# Page. 18

![Page Image](https://bcdn.docswell.com/page/PERP2GZ479.jpg)

橋渡し ｜ 成功体験
最初のテストを、赤から緑にする
1
2
3
赤：失敗を見る
緑：最小で通す
整える
先にテストを書き、まず失敗するこ
とを確認する
テストが通る最小のコードを書く
テストが緑のまま、読みやすく直す
tests/unit/format.test.js
it(&#039;3桁区切りで ¥ を付ける&#039;, () =&gt; {
expect(formatYen(993300)).toBe(&#039;¥993,300&#039;);
});
// 実行：npx vitest run tests/unit
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
18


# Page. 19

![Page Image](https://bcdn.docswell.com/page/P7X3DX9ZEX.jpg)

PART 2
後半｜実践編
ユニット・DOM・E2E・品質の仕組み（Chapter 5〜8）


# Page. 20

![Page Image](https://bcdn.docswell.com/page/37KYXWPVED.jpg)

Chapter 5 ｜ ユニットテスト
境界値と「0件」を書く
tests/unit/metrics.test.js
it(&#039;期間は両端を含む&#039;, () =&gt; {
const r = filterRecords(DATA,
{ from: &#039;2026-02-01&#039;, to: &#039;2026-02-28&#039; });
expect(r.map((x) =&gt; x.date)).toEqual(
[&#039;2026-02-01&#039;, &#039;2026-02-14&#039;, &#039;2026-02-28&#039;]);
});
•
Number(&#039;&#039;) は 0 になる罠 → 空欄を0円
として集計してしまう
•
平均は 0 ではなく null にして、表示は
「—」
•
元の配列を変更しないことも確認する
it(&#039;0件のとき平均単価は null&#039;, () =&gt; {
expect(calcKpi([]).avgOrder).toBeNull();
});
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
20


# Page. 21

![Page Image](https://bcdn.docswell.com/page/LJ39514QJ5.jpg)

Chapter 5 ｜ ユニットテスト
it.each でケースを表にする
tests/unit/format.test.js
•
同じ形のテストは表にまとめる
it.each([[NaN], [Infinity], [null],
[undefined], [&#039;100&#039;]])(
&#039;数値でない値（%s）は — にする&#039;, (v) =&gt; {
expect(formatYen(v)).toBe(&#039;—&#039;);
});
•
ケースを足すのが1行で済む
•
失敗したとき、どの値か名前で分かる
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
21


# Page. 22

![Page Image](https://bcdn.docswell.com/page/8JDGDXQWJG.jpg)

Chapter 6 ｜ DOMテスト
jsdomで画面を用意する
tests/dom/dashboard.dom.test.js
•
本物の index.html を使う
// @vitest-environment jsdom
const html = readFileSync(
join(process.cwd(), &#039;index.html&#039;), &#039;utf-8&#039;);
const body = html.match(
/&lt;body&gt;([\s\S]*)&lt;\/body&gt;/)[1]
.replace(/&lt;script[\s\S]*?&lt;\/script&gt;/g, &#039;&#039;);
•
script は実行せず、fetch を偽物に差
し替える
•
ブラウザ無しで、速く動く
const okFetch = (text) =&gt; async () =&gt;
({ ok: true, status: 200,
text: async () =&gt; text });
beforeEach(() =&gt; {
document.body.innerHTML = body;
});
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
22


# Page. 23

![Page Image](https://bcdn.docswell.com/page/VEP3XPLX78.jpg)

Chapter 6 ｜ DOMテスト
操作して、結果を確認する
tests/dom/dashboard.dom.test.js
await initDashboard({ document,
fetchFn: okFetch(CSV) });
const user = userEvent.setup();
await user.selectOptions(
tid(&#039;filter-dept&#039;), &#039;EC&#039;);
•
ユーザーと同じ操作（選ぶ・クリック）
で書く
•
KPI・明細・グラフが連動して変わるこ
とを確認
•
異常系：500エラー・通信断・ヘッダー
だけのCSV
expect(tid(&#039;kpi-revenue&#039;).textContent)
.toBe(&#039;¥42,000&#039;);
expect(rows()).toHaveLength(5);
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
23


# Page. 24

![Page Image](https://bcdn.docswell.com/page/27V4L2Q3EQ.jpg)

Chapter 7 ｜ E2Eテスト
Playwrightの基本：探す・待つ
tests/e2e/dashboard.spec.js
•
expect は条件を満たすまで自動で待つ
await page.goto(&#039;/&#039;);
await expect(page.getByTestId(&#039;row&#039;))
.toHaveCount(15);
•
固定の sleep は使わない
•
ユーザーに見える手がかり（role・text
）で探す
await page.getByTestId(&#039;filter-dept&#039;)
.selectOption(&#039;EC&#039;);
await expect(page.getByTestId(&#039;kpi-revenue&#039;))
.toHaveText(&#039;¥42,000&#039;);
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
24


# Page. 25

![Page Image](https://bcdn.docswell.com/page/5JG1XRWY7L.jpg)

Chapter 7 ｜ E2Eテスト
通信をモックして異常系を再現
tests/e2e/dashboard.spec.js
await page.route(&#039;**/data/sales.csv&#039;, (route) =&gt;
route.fulfill({ status: 500, body: &#039;error&#039; }));
await page.goto(&#039;/&#039;);
await expect(page.getByTestId(&#039;error-banner&#039;))
.toContainText(&#039;500&#039;);
•
データを小さな固定CSVに差し替えて、
本番データに依存しない
•
500エラーと通信断を、いつでも再現で
きる
// ネットワーク切断は
route.abort(&#039;failed&#039;)
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
25


# Page. 26

![Page Image](https://bcdn.docswell.com/page/47QD8V36EP.jpg)

Chapter 7 ｜ E2Eテスト
グラフ（SVG）の中身を検証する
tests/e2e/dashboard.spec.js
•
canvas は中身を直接検証できない
const bars = page.getByTestId(&#039;bar&#039;);
await expect(bars).toHaveCount(3);
await expect(bars.nth(1))
.toHaveAttribute(&#039;data-value&#039;, &#039;401000&#039;);
•
本題材は SVG。data-value と aria-label
で値を確認
•
canvas のときは、グラフに渡すデータ
を作る関数をテストし、見た目はスクリ
ーンショットで守る
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
26


# Page. 27

![Page Image](https://bcdn.docswell.com/page/KE4Z2M1MJ1.jpg)

Chapter 7 ｜ E2Eテスト
不安定なテスト（フレーク）の対策
原因
対策
固定の sleep
状態を待つ（toHaveCount / toHaveText）
本番データへの依存
page.route で小さな固定データにモック
言語・タイムゾーンの違い
設定で locale=ja-JP・timezoneId=Asia/Tokyo に固定
並び順の揺れ
同額は名前順で固定。並べ替えは安定ソート
CIだけ落ちる
retries を1回だけ許可し、失敗時はトレースを保存
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
27


# Page. 28

![Page Image](https://bcdn.docswell.com/page/L71RM8GY7G.jpg)

Chapter 8 ｜ 品質を回し続ける
ビジュアル回帰（スクリーンショット比較）
tests/e2e/dashboard.spec.js
await expect(page).toHaveScreenshot(
&#039;dashboard.png&#039;,
{ fullPage: true, maxDiffPixelRatio: 0.01 });
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
•
初回は基準画像を作るため、1件失敗す
る（正常）
•
2回目から基準画像と比較する
•
意図した変更は --update-snapshots で
更新
•
基準画像はOS別。CI（Linux）用はCI上
で作る
28


# Page. 29

![Page Image](https://bcdn.docswell.com/page/G7W13ZK1J2.jpg)

Chapter 8 ｜ 品質を回し続ける
アクセシビリティ検査で、実際に見つかった指摘
axe による自動検査
const results = await new AxeBuilder({ page })
.analyze();
expect(results.violations).toEqual([]);
検出
修正
aria-prohibited-attr：棒グラフの rect に、役割（role
）の無いまま aria-label を付けていた
グラフ全体を role=&quot;group&quot;、棒を role=&quot;img&quot; にして
、aria-label が有効になるようにした
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
29


# Page. 30

![Page Image](https://bcdn.docswell.com/page/4JZPV1ZX73.jpg)

Chapter 8 ｜ 品質を回し続ける
CIで、毎回自動で回す
push
npm test
test:tz
E2E
コードを送る
ユニット＋DOM
別タイムゾーン
実ブラウザ
•
速い層を先に回して、早く失敗を知る
•
失敗時はレポートとスクリーンショット差分を保存
•
設定は .github/workflows/test.yml（GitHub Actions）
•
※ 講座の確認環境ではCIの実行は未確認。各自の環境で確認する
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
30


# Page. 31

![Page Image](https://bcdn.docswell.com/page/YE6M5LZPJV.jpg)

Chapter 8 ｜ 品質を回し続ける
壊してみる演習：テストは本当に守っている？
#
壊し方
失敗するテスト
1
終了日を含めない（&gt; を &gt;= に）
期間の境界値テスト
2
0件の平均単価を 0 にする
ユニット＋DOM
3
月の判定をローカル時間の Date に変える
test:tz（米国時間でだけ失敗）
4
空欄の金額を受け入れる
空欄金額のテスト
5
件数表示を +1 する
DOM・E2E
講師の環境では、5種類すべてのバグをテストが検出した（Linuxで確認）
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
31


# Page. 32

![Page Image](https://bcdn.docswell.com/page/GE5ZY1WP74.jpg)

付録 ｜ Notionへの記録
テスト結果をNotionに自動で溜める
PowerShell
npm run test:json
python tools/normalize_results.py \
results.vitest.json --label Vitest
python tools/normalize_results.py \
results.json --label Playwright
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
•
Vitest・Playwrightの結果を、共通JSON
にそろえる
•
あとは Claude Code の Notion MCP で
登録
•
前の講座（Notion MCP）と接続する
32


# Page. 33

![Page Image](https://bcdn.docswell.com/page/972RG1QZER.jpg)

確認テストと効果測定
学んだ確認と、導入効果の測り方
確認テスト（例）
効果測定の指標
Q1. 日本時間で通るテストが米国時間で失敗するのは
なぜ？
・リリース前の手動確認の時間
Q2. canvas のグラフをどう守る？
・修正から検知までの時間
Q3. 固定の sleep をなぜ避ける？
・CIの失敗を直すまでの時間
うさうさ研修工房 ｜ ダッシュボードテスト自動化講座
・本番での不具合の件数
33


# Page. 34

![Page Image](https://bcdn.docswell.com/page/DJYDVZWNJM.jpg)

まとめ
壊れても、すぐ気づける仕組みを
① 守る層を選ぶ ② 純粋関数で設計する ③ 壊してテストを試す ｜ 次の一歩：自分のダッシ
ュボードに5本のテストを足そう


