受講者用_ダッシュボードテスト自動化講座

>100 Views

November 14, 26

スライド概要

profile-image

はじめまして、yukikoと申します。 IT教育支援や、DX推進が可能です。 ◆ スキル LPIC レベル2 AI / Python Splunk BI(データ可視化・分析) ◆ その他 新卒・未経験の学生向けに、エンジニア転職を応援する資料を趣味で作成しています。 もしよろしければご活用ください。

シェア

またはPlayer版

埋め込む »CMSなどでJSが使えない場合

ダウンロード

関連スライド

各ページのテキスト
1.

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

2.

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

3.

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

4.

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

5.

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

6.

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

7.

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

8.

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

9.

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

10.

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

11.

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

12.

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

13.
[beta]
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

14.

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

15.
[beta]
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

16.

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

17.

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

18.
[beta]
橋渡し | 成功体験

最初のテストを、赤から緑にする
1

2

3

赤:失敗を見る

緑:最小で通す

整える

先にテストを書き、まず失敗するこ
とを確認する

テストが通る最小のコードを書く

テストが緑のまま、読みやすく直す

tests/unit/format.test.js

it('3桁区切りで ¥ を付ける', () => {
expect(formatYen(993300)).toBe('¥993,300');
});
// 実行:npx vitest run tests/unit
うさうさ研修工房 | ダッシュボードテスト自動化講座

18

19.

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

20.
[beta]
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

21.
[beta]
Chapter 5 | ユニットテスト

it.each でケースを表にする
tests/unit/format.test.js

•

同じ形のテストは表にまとめる

it.each([[NaN], [Infinity], [null],
[undefined], ['100']])(
'数値でない値(%s)は — にする', (v) => {
expect(formatYen(v)).toBe('—');
});

•

ケースを足すのが1行で済む

•

失敗したとき、どの値か名前で分かる

うさうさ研修工房 | ダッシュボードテスト自動化講座

21

22.
[beta]
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

23.
[beta]
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

24.

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

25.
[beta]
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

26.

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

27.

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

28.
[beta]
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

29.

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

30.

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

31.

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

32.

付録 | 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

33.

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

34.

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