>100 Views
November 14, 26
スライド概要
はじめまして、yukikoと申します。 IT教育支援や、DX推進が可能です。 ◆ スキル LPIC レベル2 AI / Python Splunk BI(データ可視化・分析) ◆ その他 新卒・未経験の学生向けに、エンジニア転職を応援する資料を趣味で作成しています。 もしよろしければご活用ください。
うさうさ研修工房 | Udemy講座 受講者用 実務で使える!ダッシュボードの テスト自動化 HTML/CSS/JS | Vitest・Playwright・CI | Windows / VSCode 対応
この講座で作るもの コードを変えても、安心して出せる コードを変更 自動テスト CI 安心してリリース 機能追加・修正 74件が数秒〜十数秒 push のたびに実行 壊れたらすぐ分かる 数字・表示・操作・見た目の4つの壊れ方を、自動で見張る仕組みを作る 題材:売上KPIダッシュボード(ビルド不要の素のHTML/CSS/JS) うさうさ研修工房 | ダッシュボードテスト自動化講座 2
はじめに 対象・到達目標・前提 対象 到達目標 前提 社内ツール・ダッシュボードを作 る 守るべき所と、守る層を選べる HTML/CSS/JSの基礎(ES Modules) フロントエンド/DXエンジニア ユニット・DOM・E2Eのテスト を書ける テストを「後回し」にしがちな人 CIで回し続ける仕組みを作れる うさうさ研修工房 | ダッシュボードテスト自動化講座 Windows PC・VSCode Node.js 22(LTS)が入っている こと 3
全体ロードマップ スロープ設計:知識 → 橋渡し → 実践 前半|知識編 1 2 3 4 なぜ自動化か 環境と題材 テストしやすい設計 データと設計 壊れ方と守る層 リポジトリを動かす 純粋関数・分離 境界値・日付の罠 橋渡し:最初のテストを書いて、赤から緑にする 後半|実践編 5 6 7 8 ユニットテスト DOMテスト E2Eテスト 品質を回し続ける Vitest jsdom Playwright 回帰・a11y・CI うさうさ研修工房 | ダッシュボードテスト自動化講座 4
PART 1 前半|知識編 壊れ方・環境・設計・テストデータを押さえる(Chapter 1〜4)
Chapter 1 | なぜ自動化か ダッシュボードの5つの壊れ方 壊れ方 例 起きること 数字 集計ミス・丸め・日付のずれ 誤った数字で意思決定してしまう 表示 整形・空状態・0件の平均 「平均0円」など誤解を招く表示 操作 フィルタ・並べ替えが効かない 画面は出るが使えない 通信 CSV取得の失敗・不正な行 画面が真っ白/数字が静かにずれる 見た目 スマホで横にはみ出す・読めない色 使われなくなる うさうさ研修工房 | ダッシュボードテスト自動化講座 6
Chapter 1 | なぜ自動化か 何を、どの層で守るか 層 守るもの 速さ 本題材の件数 ユニット(Vitest) 数字・整形・集計 ミリ秒 49件 DOM(jsdom) 表示・操作・異常系 数百ミリ秒 13件 E2E(Playwright) 通信・実ブラウザ・見た目 数秒 12件 • 速い層を厚く、遅い層は薄く(壊れると痛い所だけ) • 同じ不具合を複数の層で守らない(保守が重くなる) • 迷ったら「一番速い層で書けないか」を先に考える うさうさ研修工房 | ダッシュボードテスト自動化講座 7
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
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
Chapter 2 | 題材アプリ 期待値を先に決めておく KPI 期待値 確認方法 売上合計 ¥993,300 別の方法(Python)で独立に計算 件数 15件 不正な1行は除外 平均単価 ¥66,220 売上 ÷ 件数 数量合計 36個 • CSVには不正な行を1行入れてある(2026-02-30・金額 abc) • 画面は止まらず「読み込めなかった行:1件」と警告する • 期待値を別の方法で出しておくと、テストの正しさ自体を疑える うさうさ研修工房 | ダッシュボードテスト自動化講座 10
Chapter 3 | テストしやすい設計 同じ機能でも、設計で難しさが変わる テストしにくい書き方 テストしやすい書き方 ・DOM取得→計算→表示が1つの関数に混在 ・グローバルの fetch / document を直接使う ・計算は「入力→出力」の純粋関数 ・描画は薄く、計算は持たない ・テストにブラウザが必須で、遅く不安定 ・依存(fetch・document)は引数で渡す うさうさ研修工房 | ダッシュボードテスト自動化講座 11
Chapter 3 | テストしやすい設計 責務を4つに分ける data.js metrics.js render.js app.js CSV検証 絞込・集計 DOM/SVG描画 組み立て • format / data / metrics は純粋関数 → ブラウザ不要、数ミリ秒でテストできる • render は「受け取った値を表示するだけ」。計算を持たせない • app は部品をつなぐ。外部依存はここで差し替え可能にする うさうさ研修工房 | ダッシュボードテスト自動化講座 12
Chapter 3 | テストしやすい設計
依存は引数で受け取る
js/app.js
•
本番は標準の fetch を使う
export async function initDashboard({
document,
fetchFn = globalThis.fetch,
csvUrl = 'data/sales.csv',
} = {}) {
const res = await fetchFn(csvUrl);
if (!res.ok) throw new Error(
`HTTP ${res.status}`);
...
}
•
テストでは「偽の fetch」を渡す
•
成功・500エラー・通信断を、サーバー
無しで再現できる
うさうさ研修工房 | ダッシュボードテスト自動化講座
13
Chapter 3 | テストしやすい設計 data-testid で「探しやすく」する index.html • <p data-testid="kpi-revenue">—</p> <select data-testid="filter-dept">...</select> <tbody data-testid="table-body"></tbody> <p data-testid="error-banner" hidden></p> 見た目やクラス名を変えても、テストが 壊れない • 意味のある名前を付ける(kpi-revenue など) • ボタン・見出しは getByRole で探せる ので、data-testid は必要な所だけ うさうさ研修工房 | ダッシュボードテスト自動化講座 14
Chapter 4 | データと設計
テストデータは小さく・固定・意図が読める
tests/unit/metrics.test.js
•
const rec = (date, dept, amount,
quantity = 1, product = 'P') =>
({ date, dept, product, amount, quantity });
月末・月初の日付を入れておく(境界値
)
•
数字は暗算できる大きさに
•
本物のCSVに依存しない
const DATA = [
rec('2026-01-31', 'EC', 4200, 4),
rec('2026-02-01', '営業', 100000),
rec('2026-02-14', 'EC', 14700, 3),
rec('2026-02-28', '店舗', 10000, 2),
rec('2026-03-01', 'EC', 5000),
];
うさうさ研修工房 | ダッシュボードテスト自動化講座
15
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 = '' エラー行として除外 うさうさ研修工房 | ダッシュボードテスト自動化講座 16
Chapter 4 | データと設計 日付の罠:タイムゾーン js/metrics.js • 日本時間で通っても安心できない // NG:実行環境のタイムゾーンで月が変わる const d = new Date('2026-02-01'); // UTC 0:00 d.getMonth() + 1 // 米国西海岸では 1月 • npm run test:tz で米国時間でも実行す る • 実際に書き換えると、東京は全件通過・ 米国時間は失敗した // OK:日付は文字列のまま扱う r.date.slice(0, 7) // '2026-02' うさうさ研修工房 | ダッシュボードテスト自動化講座 17
橋渡し | 成功体験
最初のテストを、赤から緑にする
1
2
3
赤:失敗を見る
緑:最小で通す
整える
先にテストを書き、まず失敗するこ
とを確認する
テストが通る最小のコードを書く
テストが緑のまま、読みやすく直す
tests/unit/format.test.js
it('3桁区切りで ¥ を付ける', () => {
expect(formatYen(993300)).toBe('¥993,300');
});
// 実行:npx vitest run tests/unit
うさうさ研修工房 | ダッシュボードテスト自動化講座
18
PART 2 後半|実践編 ユニット・DOM・E2E・品質の仕組み(Chapter 5〜8)
Chapter 5 | ユニットテスト
境界値と「0件」を書く
tests/unit/metrics.test.js
it('期間は両端を含む', () => {
const r = filterRecords(DATA,
{ from: '2026-02-01', to: '2026-02-28' });
expect(r.map((x) => x.date)).toEqual(
['2026-02-01', '2026-02-14', '2026-02-28']);
});
•
Number('') は 0 になる罠 → 空欄を0円
として集計してしまう
•
平均は 0 ではなく null にして、表示は
「—」
•
元の配列を変更しないことも確認する
it('0件のとき平均単価は null', () => {
expect(calcKpi([]).avgOrder).toBeNull();
});
うさうさ研修工房 | ダッシュボードテスト自動化講座
20
Chapter 5 | ユニットテスト
it.each でケースを表にする
tests/unit/format.test.js
•
同じ形のテストは表にまとめる
it.each([[NaN], [Infinity], [null],
[undefined], ['100']])(
'数値でない値(%s)は — にする', (v) => {
expect(formatYen(v)).toBe('—');
});
•
ケースを足すのが1行で済む
•
失敗したとき、どの値か名前で分かる
うさうさ研修工房 | ダッシュボードテスト自動化講座
21
Chapter 6 | DOMテスト
jsdomで画面を用意する
tests/dom/dashboard.dom.test.js
•
本物の index.html を使う
// @vitest-environment jsdom
const html = readFileSync(
join(process.cwd(), 'index.html'), 'utf-8');
const body = html.match(
/<body>([\s\S]*)<\/body>/)[1]
.replace(/<script[\s\S]*?<\/script>/g, '');
•
script は実行せず、fetch を偽物に差
し替える
•
ブラウザ無しで、速く動く
const okFetch = (text) => async () =>
({ ok: true, status: 200,
text: async () => text });
beforeEach(() => {
document.body.innerHTML = body;
});
うさうさ研修工房 | ダッシュボードテスト自動化講座
22
Chapter 6 | DOMテスト
操作して、結果を確認する
tests/dom/dashboard.dom.test.js
await initDashboard({ document,
fetchFn: okFetch(CSV) });
const user = userEvent.setup();
await user.selectOptions(
tid('filter-dept'), 'EC');
•
ユーザーと同じ操作(選ぶ・クリック)
で書く
•
KPI・明細・グラフが連動して変わるこ
とを確認
•
異常系:500エラー・通信断・ヘッダー
だけのCSV
expect(tid('kpi-revenue').textContent)
.toBe('¥42,000');
expect(rows()).toHaveLength(5);
うさうさ研修工房 | ダッシュボードテスト自動化講座
23
Chapter 7 | E2Eテスト Playwrightの基本:探す・待つ tests/e2e/dashboard.spec.js • expect は条件を満たすまで自動で待つ await page.goto('/'); await expect(page.getByTestId('row')) .toHaveCount(15); • 固定の sleep は使わない • ユーザーに見える手がかり(role・text )で探す await page.getByTestId('filter-dept') .selectOption('EC'); await expect(page.getByTestId('kpi-revenue')) .toHaveText('¥42,000'); うさうさ研修工房 | ダッシュボードテスト自動化講座 24
Chapter 7 | E2Eテスト
通信をモックして異常系を再現
tests/e2e/dashboard.spec.js
await page.route('**/data/sales.csv', (route) =>
route.fulfill({ status: 500, body: 'error' }));
await page.goto('/');
await expect(page.getByTestId('error-banner'))
.toContainText('500');
•
データを小さな固定CSVに差し替えて、
本番データに依存しない
•
500エラーと通信断を、いつでも再現で
きる
// ネットワーク切断は
route.abort('failed')
うさうさ研修工房 | ダッシュボードテスト自動化講座
25
Chapter 7 | E2Eテスト グラフ(SVG)の中身を検証する tests/e2e/dashboard.spec.js • canvas は中身を直接検証できない const bars = page.getByTestId('bar'); await expect(bars).toHaveCount(3); await expect(bars.nth(1)) .toHaveAttribute('data-value', '401000'); • 本題材は SVG。data-value と aria-label で値を確認 • canvas のときは、グラフに渡すデータ を作る関数をテストし、見た目はスクリ ーンショットで守る うさうさ研修工房 | ダッシュボードテスト自動化講座 26
Chapter 7 | E2Eテスト 不安定なテスト(フレーク)の対策 原因 対策 固定の sleep 状態を待つ(toHaveCount / toHaveText) 本番データへの依存 page.route で小さな固定データにモック 言語・タイムゾーンの違い 設定で locale=ja-JP・timezoneId=Asia/Tokyo に固定 並び順の揺れ 同額は名前順で固定。並べ替えは安定ソート CIだけ落ちる retries を1回だけ許可し、失敗時はトレースを保存 うさうさ研修工房 | ダッシュボードテスト自動化講座 27
Chapter 8 | 品質を回し続ける
ビジュアル回帰(スクリーンショット比較)
tests/e2e/dashboard.spec.js
await expect(page).toHaveScreenshot(
'dashboard.png',
{ fullPage: true, maxDiffPixelRatio: 0.01 });
うさうさ研修工房 | ダッシュボードテスト自動化講座
•
初回は基準画像を作るため、1件失敗す
る(正常)
•
2回目から基準画像と比較する
•
意図した変更は --update-snapshots で
更新
•
基準画像はOS別。CI(Linux)用はCI上
で作る
28
Chapter 8 | 品質を回し続ける アクセシビリティ検査で、実際に見つかった指摘 axe による自動検査 const results = await new AxeBuilder({ page }) .analyze(); expect(results.violations).toEqual([]); 検出 修正 aria-prohibited-attr:棒グラフの rect に、役割(role )の無いまま aria-label を付けていた グラフ全体を role="group"、棒を role="img" にして 、aria-label が有効になるようにした うさうさ研修工房 | ダッシュボードテスト自動化講座 29
Chapter 8 | 品質を回し続ける CIで、毎回自動で回す push npm test test:tz E2E コードを送る ユニット+DOM 別タイムゾーン 実ブラウザ • 速い層を先に回して、早く失敗を知る • 失敗時はレポートとスクリーンショット差分を保存 • 設定は .github/workflows/test.yml(GitHub Actions) • ※ 講座の確認環境ではCIの実行は未確認。各自の環境で確認する うさうさ研修工房 | ダッシュボードテスト自動化講座 30
Chapter 8 | 品質を回し続ける 壊してみる演習:テストは本当に守っている? # 壊し方 失敗するテスト 1 終了日を含めない(> を >= に) 期間の境界値テスト 2 0件の平均単価を 0 にする ユニット+DOM 3 月の判定をローカル時間の Date に変える test:tz(米国時間でだけ失敗) 4 空欄の金額を受け入れる 空欄金額のテスト 5 件数表示を +1 する DOM・E2E 講師の環境では、5種類すべてのバグをテストが検出した(Linuxで確認) うさうさ研修工房 | ダッシュボードテスト自動化講座 31
付録 | 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
確認テストと効果測定 学んだ確認と、導入効果の測り方 確認テスト(例) 効果測定の指標 Q1. 日本時間で通るテストが米国時間で失敗するのは なぜ? ・リリース前の手動確認の時間 Q2. canvas のグラフをどう守る? ・修正から検知までの時間 Q3. 固定の sleep をなぜ避ける? ・CIの失敗を直すまでの時間 うさうさ研修工房 | ダッシュボードテスト自動化講座 ・本番での不具合の件数 33
まとめ 壊れても、すぐ気づける仕組みを ① 守る層を選ぶ ② 純粋関数で設計する ③ 壊してテストを試す | 次の一歩:自分のダッシ ュボードに5本のテストを足そう