
【現場の実践録】Playwright × Cucumberで作る、保守が辛くないE2Eテスト運用術
こんにちは!株式会社Lif 技術部のターキーです。
今回、フロントエンドの品質担保に欠かせない「E2E(エンドツーエンド)テスト」について現場の知見を共有したいと思います。
突然ですが、皆さんはE2Eテストに対してこんな「辛い」イメージを持っていませんか?
「たまに失敗するけど、再実行すると成功する(不安定で気まぐれなテスト)」
「テストコードを見ても、元々どういう仕様を満たしたかったのか解読できない」
「UIをちょっと変えただけでテストが壊れ、修正に追われる…」
私たちも長年この課題に頭を悩ませてきました。現在業務で活用している「Playwright × Cucumber」という組み合わせを導入したことで、これらの辛さにどう立ち向かえるようになったのか、現場のリアルな所感をお届けします。
なぜ「Playwright × Cucumber」なのか?
結論から言うと、この2つを組み合わせることで「不安定なエラーの削減」と「テストが壊れたときの復旧のしやすさ(保守性)」を両立できるからです。
Playwright:とにかく速くて、動作が安定している
Microsoftが開発しているPlaywrightは、モダンなE2Eテストツールです。最大の魅力は「オートウェイト(自動待機)機能」。 従来のツールでありがちだった「とりあえず sleep(3000) で3秒待つ」といった強引なコードに頼らなくても、Playwrightは要素が操作可能になるまで賢く自動待機してくれます。もちろん実務では明示的に待機処理やタイムアウトを設定する場面もありますが、基本的にはフレームワーク側が状態を監視してくれるため、実行タイミングによる謎のエラーに悩まされることが格段に減りました。
Cucumber:UIが壊れても「テストの目的」は壊れない
CucumberはBDD(振る舞い駆動開発)をサポートするツールで、テストシナリオを「自然言語(日本語)」で書くことができます。 ここが最大のポイントです。UIの変更によってテストが落ちる問題自体は無くなりません。しかし、テストの「目的(どう動くべきか)」と「UIの操作手順」を切り離すことで、修正が圧倒的に楽になるのです。
実際にどう動くのか?(簡単なコード例)
百聞は一見に如かず。実際にどんな風にテストを書くのか見てみましょう。
1. シナリオファイル(.feature) まずはCucumberの「Gherkin(ガーキン)記法」を使って、日本語でシナリオを書きます。エンジニアでなくても読めますよね。
Gherkin
機能: ログイン機能
ユーザーは正しい認証情報を使ってシステムにログインできること
シナリオ: 正しい認証情報でログインできる
前提 ログインページにアクセスしている
もし 正しい認証情報でログインする
ならば マイページが表示される2. ステップ定義(TypeScript + Playwright) 次に、上記の日本語1行1行に対して、「裏側でブラウザをどう動かすか」をPlaywrightで実装します。
TypeScript
import { Given, When, Then } from '@cucumber/cucumber';
import { expect, page } from './fixtures'; // Playwrightのpageオブジェクト
// (中略:アクセス処理など)
When('ユーザー名 {string} とパスワード {string} を入力してログインボタンを押す', async (username, password) => {
await page.getByLabel('ユーザー名').fill(username);
await page.getByLabel('パスワード').fill(password);
await page.getByRole('button', { name: 'ログイン' }).click();
});
もしデザイン変更でログインボタンのDOM構造が変わってテストが落ちたとしても、直すのはこのステップ定義(TypeScript)の中だけです。「ログインできること」という日本語のシナリオ(.feature)は一切書き換える必要がないため、テストコードが持つドキュメントとしての価値が保たれ続けます。
現場に導入してみてわかったメリット・デメリット
実際に業務のプロジェクトに導入してみて、見えてきたリアルな所感です。
よかったこと(メリット)
シナリオファイルの内容が直感的に理解しやすい
テストの操作手順や確認項目が日本語で書かれているため、テストコードの内部を追いかけなくても、どんな前提でどんな操作を行っているのかがひと目でわかります。エンジニアだけでなく、PdMやQAメンバーなどチーム全体でテストの目的を簡単に共有できるようになりました。どのシナリオが落ちているか、ログを見てすぐに特定できる
通常のテストツールだと、CI上でテストが失敗した際に「何行目のどの要素のクリックで落ちたか」をスタックトレースから解読する必要があります。しかしCucumberを挟んでいると、実行ログに「どの日本語のシナリオの、どのステップ(例:『ならば マイページに遷移し〜』)で失敗したか」が明確に出力されます。これにより、エラー原因の特定や復旧までの初動が圧倒的に早くなりました。
苦労したこと・現場のリアル(デメリット)
UI変更でテストはやっぱり落ちる
魔法のツールではないので、UIが大きく変わればテストは落ちます。ただし、前述の通り「修正箇所が局所化される」ことと、Playwrightの強力なセレクタを使うことで、壊れにくいテストを書く工夫はしやすくなりました。「良いシナリオ」を書くのには慣れが必要
シナリオに「ボタンを左クリックする」といったUIの詳細な操作を書きすぎると、Cucumberの恩恵が薄れます。あくまで「ビジネス上の目的」を記述するようにチーム内で規約を設ける必要がありました。
まとめ
「Playwright × Cucumber」の導入は、E2Eテストの辛さをゼロにしてくれる魔法ではありませんが、それぞれのツールの強みを活かすことで、テスト運用の課題を大きく改善してくれます。
改めて、この構成のメリットを整理します。
Playwrightによるメリット(実行の安定性と調査のしやすさ)
強力なオートウェイト機能により、「要素が見つからなくて落ちる」といった不安定なテストが激減する。
Trace Viewerなどのデバッグ機能が優秀で、テストが失敗した際の「どこで落ちたか」の調査が高速化される。
Cucumberによるメリット(仕様の可読性と保守性の向上)
テストシナリオが自然言語(日本語)で書かれるため、コードを読めないPdMやQAメンバーとも「どんなテストを行っているか」を簡単に共有でき、仕様の認識合わせがスムーズになる。
UIが変更されてテストが壊れても、修正するのは「ステップ定義(操作手順)」だけで済み、「テストの目的(仕様)」は壊れずにドキュメントとして保たれる。
あえてCucumberを組み合わせる理由(どんなチームに向いているか?)
正直なところ、「ステップ定義だけ直せる」「失敗箇所を追いやすい」といった保守性のメリットは、Playwright単体でもPage Object Model(POM)などを適切に設計すればある程度は実現可能です。 Cucumberを挟むということは、間に「ステップ定義」という抽象化レイヤーが一つ増えるため、コードの管理コストや初期の学習コストが上がるという明確なデメリットもあります。
それでも私たちがCucumberを導入したのは、「エンジニア以外のメンバーも巻き込んで品質を担保したい」という背景があったからです。
事実、私たちの現場では、QAメンバーが自ら「Playwright × Cucumber」でE2Eテストを回し、シナリオの手直しまで行っています。 Cucumberという共通言語を挟んだことで、これまでエンジニアのブラックボックスになりがちだった自動テストの運用を、QAメンバーが自走できるようになったのは非常に大きな成果です。
初期の学習コストや環境構築の手間はありますが、それを補って余りある保守性の高さと安心感をもたらしてくれます。E2Eテストの運用に悩んでいる方は、ぜひ一度この組み合わせを試してみてください!
Lifでは一緒にスキルアップを目指すメンバーを大募集中です。
是非興味あれば、問い合わせいただけますと幸いです。