変更した行だけを見る品質ゲート

テストが2441個あってカバレッジ9.5% ── 全体の数字を諦め、変更した行だけを見る品質ゲートに切り替えた

はじめに テストカバレッジのゲートを3つのサイトに入れた記録です。 同じドメインで連携する3つのNext.jsサイト(利用者向け / 提供者向け / 社内管理画面)を運用しています。カバレッジを測る設定は、利用者向けでは5月、社内管理画面では6月から入っていました。ただし閾値もCI連携もなく「測れるが誰も追っていない」状態でした。提供者向けでは、計測とゲートを同じ日に入れています。 半期の計画でカバレッジ向上に取り組むことが決まり、まず現状を測るところから始めました。 実測したところ、社内管理画面は テストが2441個あって、カバレッジ9.5% でした。この数字を前にして「まず全体80%を目指そう」と言っても、誰も動きません。 そこで全体の数字を目標にするのをやめ、「変更した行」だけを見るゲートに切り替えました。 この記事で得られること テスト数とカバレッジが比例しない理由と、計測対象の決め方 全体のカバレッジをゲートにすると何がうまくいかないか(未使用コードを消すと率が下がる問題) 変更した行のカバレッジをゲートにする設計と、全体の数字をこれ以上下がったら止める「下限」として使う考え方 外部のカバレッジサービスを使わず、CI内で完結させる実装 計測から外すファイルを決めないと数字が実態とずれる話 既存コードの多いリポジトリで、止めずにゲートを入れる段階の踏み方 1. 3サイトのカバレッジ実測値 まず現状を測りました。CIと同じ環境変数で、全テストが通る状態での実測値です。 Lines Statements Functions Branches テスト規模 社内管理画面 9.5% 9.5% 7.1% 8.4% 176ファイル / 2441テスト 利用者向け 26.8% 26.3% 20.0% 24.2% 70ファイル / 908テスト 提供者向け 34.3% 34.5% 28.9% 32.1% 45ファイル / 625テスト 目を引くのは社内管理画面です。テストが一番多いのに、カバレッジが一番低くなっています。 テストの数とカバレッジが比例しない理由 原因はテストの置き場所が偏っていたことでした。導入時のコミットで測り直し、テストと計測対象の行を突き合わせると、こうなっていました。 1 2 3 4 5 6 7 8 2441テストの内訳 入力チェックの定義(zodのスキーマ)のテスト 1358 自動生成されたAPIクライアントのテスト 195(自動生成コードは計測対象外) その他 888 計測対象 18981行の内訳 入力チェックの定義 143行 74.1%がテストで実行された 画面のコンポーネント 13910行 4.4%がテストで実行された テストの半分以上が入力チェックの定義に集まっていました。定義は1つが数行にまとまるので、計測対象の行数では143行、全体の1%もありません。一方、計測対象の7割以上を占める画面のコンポーネントは、ほとんどテストで実行されていませんでした。 ...

2026年11月16日 · 読了時間: 5分 · 福士宗介
frontend testing

QA フェーズを起点に、Next.js のテスト基盤をゼロから設計した話 — Playwright × Vitest × Sentry

QAフェーズへの移行を機に、後回しにしていたテスト基盤を一気に整備した記録です。 同じドメインで連携する3つのNext.jsサイト(利用者向け/提供者向け/社内管理画面)を並行開発し、リリース前のQAに突入したものの、モンキーテストで予想を超えるバグが多発しました。 修正のたびに3サイト全画面を手動で再確認することになり、1サイクルあたり30分〜1時間かかりました。本来テストシナリオ作成に充てるはずだった1週間がバグ修正で埋まりました。 そこでE2Eテスト(Playwright)・コンポーネントテスト(Vitest)・本番エラー監視(Sentry)を 半日で一気に導入 しました。 この記事では、Next.js App Router + TanStack Query + MSW という構成で、ツール選定から実装・CI統合までの過程を解説します。あわせて、SSR / Turbopack固有のハマりポイントと、AIでテストを量産する際の落とし穴も共有します。 この記事で得られること Next.js App Routerで Playwright + MSW を動かすためのSSR対応パターン MSW ハンドラーを E2E と Vitest で共有する設計(モックの二重管理を防ぐ) E2E / Vitest / 手動テストの 仕分け基準(テストピラミッドの設計) Sentryを Next.js 16 + Turbopack で動かす際のハマりポイントと解決策 Sentryの 3層防御マスキング設計(SDKフック / Server-side Scrubber / Generative AI機能停止) ソースマップを Sentry にアップロードしない という運用選択肢とそのトレードオフ AIでテストを量産する際の「成功するテストしか作らない」問題と対策 動作確認環境 種別 バージョン OS macOS 15.x Node.js 24.x パッケージマネージャー pnpm 10.x Next.js 16.x(Turbopack) React 19.x @playwright/test 1.58.x vitest 4.x msw 2.x @sentry/nextjs 10.x @tanstack/react-query 5.x 1. 背景: 手動テストだけでは回らなくなった瞬間 3つのNext.jsサイト(利用者向けサイト/提供者向けサイト/社内管理画面)を約10名のチームで半年かけて並行開発しました。 ...

2026年5月12日 · 読了時間: 12分 · 福士宗介