Share
Embed
安心して変更できるWebフロントエンドの作り方
フロントエンドカンファレンス福岡2026の登壇資料です。
https://frontend-conf.fukuoka.jp/2026/?hl=ja
Hiroyuki ANAI
September 14, 2026
Transcript
47 slides
-
自己紹介 穴井宏幸(@pirosikick) 株式会社LayerX ソフトウェアエンジニア バクラク勤怠の開発をメインに、WebフロントエンドのEnablingを少々 経歴 2009 ~ 2018年 ヤフー株式会社
2016~2018年? JavaScript黒帯 2018 ~ 2020年 サイボウズ株式会社 フロントエンドエキスパート 2020 ~ 2025年 スタートアップCTO 2025年8月 株式会社LayerX 執筆 © LayerX Inc. 2018年「React入門」(翔泳社、共著) Web + DB Press 「どんとこい!フロントエンド開発」(連載、共著)、 「フロントエンド脱レガシー」(特集記事、共著) 2 -
本編に入る前に用語の整理 本編に登場する「Integration Test」「Unit Test」は、Testing Trophyの定義です Unit Test アプリケーション内で最も小さく分離されたコード単位(関数、純粋なロジック、ユーティリティなど)が、 単体で正しく動作するかを評価するテスト Integration
Test 複数のユニットやモジュール(UIコンポーネント、状態管理 ... etc)が 組み合わさって機能する一連の流れを評価するテスト 個人的には、Storybookの play 関数をよく使うが、 vitestのbrowser modeやtesting-library + jsdom/happy-domなどを使ったテストのイメージ (ヘッドレスでブラウザを使うテストは、Integration Testなのか、という話もあるが、そこは許して) © LayerX Inc. 4 -
Testing Trophyの詳しい情報は、本家の記事をご覧ください The Testing Trophy and Testing Classifications(Kent C. Dodds)
https://kentcdodds.com/blog/the-testing-trophy-and-testing-classifications Testing Trophyの図(穴井手書き) © LayerX Inc. 5 -
なぜ? Why 1. 自動テストがないと安心して変更できない 「自動テストがない」は変更できない定番の理由 「テストが全く無い」みたいな状態はほぼ見なくなった 「Webサイト」から「Webアプリケーション」が主流になり、テストを書く重要性が高まった テストのツールチェーンの成熟。自動テストのハードルが下がった。 書籍等、啓蒙やノウハウの普及 ...
etc 最近は「何を選ぶか」「どれくらい書くのか」「どのタイミングで書くのか」などが話の 中心なのかも © LayerX Inc. 8 -
なぜ? Why 2. なるべく上位に自動テストを追加する方が効果が高い 上位 = 依存側、下位 = 非依存側 AがBに依存している場合、Aが上位
※注意: この定義が一般的かは分からない 効果が高い = 安心して変更できる範囲が広い © LayerX Inc. 9 -
Why 2. なるべく上位に自動テストを追加する方が効果が高い 上位なほど、カバーする範囲が広くなる Unit TestよりIntegration Test、 Integration TestよりE2E Testの方が効果が高い
= 安心できる範囲が広い © LayerX Inc. 12 -
Why 2. なるべく上位に自動テストを追加する方が効果が高い ただし、上位なほど、実行コストが高くなる E2E Test >>> Integration Test >>
Unit Test 全てをE2E Test or Integration Testに書くと 共通処理(複数から依存されている処理)でテストケースが重複して無駄 Unit Testは、そのようなケース(共通処理)や Validationなどテストパターンが多い場合に書く、くらいでよい気がする © LayerX Inc. 13 -
なぜ? Why 3. テスト自体が生きた仕様書になる 仕様が残ってないと、 意図した挙動なのか、たまたまそうなっているのかわからず、 変更に躊躇してしまう E2E TestやIntegration Testは、ユーザーのユースケースに近い形でテストを書くので、
1つのテストケース=1つの仕様・振る舞いになりやすい テストを読めば、仕様がわかるという状態になる ドキュメントは、実装と距離があるので、乖離が起きやすい © LayerX Inc. 14 -
なぜ? Why 4. E2E Testはコストが高い テストの効果を考えるとIntegration Testより、E2E Testに分がある カバーする範囲が広い 実装に完全非依存、テストケースがほぼユーザーの振る舞いと一致
変更が安全かのフィードバックはすぐ欲しい 作成したPRやpushしたcommitに対して、CIでテストしたい E2E Testは、現実的ではない E2E Testは、実行時間が長い E2E Testは、環境構築コストが高い micro serviceだと、動的な環境構築・データの洗替が無理なケースも © LayerX Inc. 15 -
Integration Testの数の推移 バクラク勤怠のIntegration Testの数をカウント ファイル数・ケース数の推移だけ見ると順調に増えてそうに見える プロダクト全体なので、穴井以外も書いてそうでうれしい 時点 2025年8月 2026年9月 ©
LayerX Inc. ページ数 79 94(+15) Integrataion Test 2ファイル, 11ケース 18ファイル(+16), 94ケース(+83) 19 -
何が実践を阻んだか? 「早くリリースしなきゃ」という圧 圧に負けて、テストを書かずにマージしてしまった 好きな言葉は「テストを書いた方が速い」なので悔しい! 圧の原因はいくつかある 転職したばかりで早く成果を出したかった AIを使いこなしている同僚のアウトプット量に圧倒され、焦ってしまった 忙しくて余裕が無かった ... etc
※注意: あくまで自発的な焦りです! 組織・上司に圧を掛けられているわけではありません!!! © LayerX Inc. 21 -
何が実践を阻んだか? テスト容易性に当てはめて考えてみる ソフトウェアテストのやりやすさを表す特性 7つの特性から構成: 実行円滑性, 観測容易性, 制御容易性 分解容易性, 単純性, 安定性,
理解容易性 Integration Testを書けたページ・書けなかったページで 特性ごとに差異があるのかを考える © LayerX Inc. 23 -
何が実践を阻んだか? 差異がない特性 実行円滑性 = 簡単に実行できるか テストが実行しやすいかはテスト対象に関係ない モノレポ、かつ、同僚が既に整備済みだったので◎ 観測容易性 = テスト対象の状態を簡単に観測できるか
要は、AAAパターンのAssert部分 UIの変化、モックしたAPI等とのやり取りが観測対象 テスト対象によってそこまで変わらない 制御容易性 = テスト対象の動作を簡単に制御できるか 要は、AAAパターンのArrange/Act部分 モックAPI、コンポーネントのprops、clickなどの操作 ... etc テスト対象によってそこまで変わらない © LayerX Inc. 24 -
違いがある特性 単純性 = 実装がシンプルか Integration Testが書けなかったページは、実装が複雑 行数が多い、1ファイルに詰め込みがち GraphQLのQueryがでかい、複数叩いている 分岐が多い、分岐条件の要素が多い コンポーネントのpropsが多い
... etc 理解容易性 = 仕様がシンプルか Integration Testが書けなかったページは、仕様が複雑 歴史が長く、ドメインが詰まりがち UIが複雑で、表示パターンが多い ... etc © LayerX Inc. 25 -
反省 反省1: Integration Testに固執してた リファクタリングは、挙動を変えずに内部構造を整理すること コードをリファクタするには、まずIntegration Testを書かないと〜 → でもコードが複雑で、Integration Testが書けない〜
→ デッドロック!何も進まない! © LayerX Inc. 26 -
反省1: Integration Testに固執してた どうすべきだったか? Unit Testで小さく始める? 小さな改善を地道に続ける必要があり、我慢が必要 上司の名言 「東京ドームの改修をするのに、外周の草刈りから始めるようなもの」 改善案があるなら、思い切って先にコードの整理を行う
今はAIで改修ミスは起きづらいし 「挙動が変わっていないこと」は、自動テスト以外の方法でも保証可能 手動でQAを頑張る コードレビューを頑張る © LayerX Inc. 27 -
「安心して変更できるWebフロントエンドの作り方」に付け加えるなら 全ての振る舞いをIntegration Testで保護すればOK ただし、それには前提がある Integration Testが書ける程度に、実装と仕様がシンプルであること(単純性・理解容易性) 書く人がドメインを理解していること Integration Testを書くのが楽な基盤があること(圧に負けにくくする) 前提が崩れているなら、テストより先に前提を直す
リファクタ、調査、テスト基盤への投資 「テストが書けない」は怠惰ではなく、コードからのシグナル © LayerX Inc. 32 -
現状を知るために調査 テストファイル数の推移 時点 2025年8月 2026年1月 2026年4月 2026年9月 © LayerX Inc.
.tsx .test.tsx 417 632 694 799 0 8 11 57 play有 .stories.tsx 2 13 14 18 35 -
現状を知るために調査 AIが書いたファイルがどれくらいあるか 種別 .test.tsx play有 .stories.tsx 合計 計 57 18
75 AI(※ 1) 41 8 49 人間(※ 2) 16 10 26 AI比率 71.9% 44.4% 65.3% ※1 コミットやPR本文に「Generated with Claude Code」が含まれるか等で判定 ※2「人間」判定は、コミットログにAIと判定できるマーカーが無かっただけなので、 実際はもっとAI比率が高いはず © LayerX Inc. 36 -
現状を知るために調査 言えそうなこと なんとなく感じてたが、AIによって、自動テストが増えた は数字的にも正しそう 指示をしなくても勝手にUIのテストを書くようになった が、2026年4月以降に急速に増加 AIに「リポジトリ内に特別な指示はあるか?」と聞いたが「無いっぽい」 確実なことは分からないが、モデルに何か変化があったかも? .test.tsx 何も指示しない場合、AIは
.test.tsx (testing-library)でテストを書きがち © LayerX Inc. 37 -
テストコードを読んで感じたこと AI、めっちゃモックする 複雑なUIコンポーネント、だいたいモックしてる ex) モーダルコンポーネントをただprops.childrenを返すだけにする ex) リッチなセレクトボックスをただの <select> に置き換える その発想はなかったので感心したが、
同じコードがコピペしたかのように点在しちゃってるのはよくない テスト基盤として提供するのがよさそう テスト用のFakeコンポーネント react-select-event のような複雑なUIコンポーネントをテスト時に操作するヘルパー関数 ... etc © LayerX Inc. 39 -
テストコードを読んで感じたこと AI、めっちゃモックする のsetValue関数をspyしている行儀の悪いケースも 人間だとそこまでしてテストを書かないので、そういう意味ではすごい 実装にかなり依存しており、テストが壊れやすく、テストコードが複雑になりがち 外から観測できる変化で検証できないのか、 Integration Test以外の方法で動作を保証できる設計はないのか、 (ex: ロジックを切り出して、Unit
Testを書く) テストの複雑さに見合う効果があるのか ... etc react-hook-form © LayerX Inc. 40 -
おまけ: CIのコストがかなり増えた話 一方で、Testはどうコスト削減するか? Storybookのplay関数推しだったが、 より実行コストの低いツールへの乗り換えが必要? ex) testing-library + happy-dom/jsdomなど、ブラウザを使わない構成 テストケースを厳選する?どうやって?
... etc 答えはまだない お金のことまで考えると FEのテスト戦略はより複雑になるな〜というのが 最近の悩みという話でした © LayerX Inc. 46