Playwright
Chromium/Firefox/WebKitを1つのAPIで自動操作するE2Eテストフレームワーク
分野「開発基盤・CI/CD」：コードの変更を、壊さずに本番へ届ける仕組み。 分野の役割とつながりは分野の解説へ。
別名：playwright-test、pw
できること
- ブラウザ操作を自動テストする ：画面の動作を自動で検証したい
- Web ページからデータを取得する ：サイトの情報を定期的に集めたい
- HTTP API を呼び出す ：外部サービスからデータを取りたい
Playwright ができないこと
- Node.js の 22.x / 24.x / 26.x 系以外（EOL済みの旧LTSなど）での動作保証
- Windows 10、macOS 13以前、公式非対応のLinuxディストリビューションでのサポート
- Playwrightを更新した後、ブラウザバイナリを再インストールせずに同じ検証結果を維持すること（バージョンごとにブラウザが固定される）
- 実機のiOS/Android端末上でのネイティブアプリテスト（あくまでデスクトップブラウザエンジンによるモバイルエミュレーション）
- CI環境でブラウザバイナリをキャッシュして大幅に高速化すること（インストール時間とキャッシュ復元時間がほぼ同等）
制約
先頭の行が、このツールで最も先に当たる制約。値はすべて出典の一次情報で確認したもの。
| 項目 | 値 | 影響 | 出典 | 検証日 |
|---|---|---|---|---|
| 対応Node.jsバージョン （主要制約） | 最新の 22.x, 24.x, 26.x 系のいずれか | 古いNode.js（18.x以前など）やサポート対象外の中間バージョンでは動作保証されず、CI環境のNodeイメージを合わせる必要がある | playwright.dev | |
| 対応OS | Windows 11以降/Windows Server 2019以降、macOS 14（Sonoma）以降、Linuxは Debian 12/13・Ubuntu 22.04/24.04/26.04（x86-64またはarm64） | 古いOSやディストリビューションは公式サポート外となり、ブラウザバイナリが正しく動かないことがある | playwright.dev | |
| 対応ブラウザエンジン | Chromium・Firefox・WebKitの3種（chrome/msedgeなどのチャネル切り替えも可能） | Playwright専用にビルドされたブラウザで検証するため、利用者の手元のChrome/Edgeの実バージョンとは完全には一致しないことがある | playwright.dev | |
| ブラウザバイナリのインストール容量 | Chromium約281MB、Firefox約187MB、WebKit約180MB（初回 playwright install 時にダウンロード） | CI環境ではディスク・ネットワーク帯域を消費し、キャッシュしてもダウンロード時間との差が小さいため高速化効果が薄い | playwright.dev | |
| CI実行時の推奨ワーカー数 | 1（公式推奨。安定性と再現性を優先するため） | 並列実行は強力な自己ホストCI環境がある場合のみ推奨され、幅広い並列化にはジョブ自体を分割するシャーディングが必要になる | playwright.dev |
典型的な落とし穴
- Playwrightを更新した後にブラウザバイナリを再インストールしないと、バージョン不整合でテストが失敗する
- CI用イメージのNode.jsバージョンを対応外のまま放置し、原因不明の失敗に遭遇する
- ブラウザバイナリをCIキャッシュに乗せても、インストール時間とほぼ変わらずキャッシュ管理コストだけが増える
コスト
- 課金モデル
- 無料
- 跳ねる条件
Apache License 2.0のOSSで無償。費用が発生するのはCI実行環境（クラウドランナーの実行時間や自己ホストのマシン代）側であり、Playwright自体に課金要素はない
- 出典
- github.com 検証
代替手段と差分
| 代替 | 何が違うか |
|---|---|
| Python | PythonはHTTPクライアントやHTMLパーサーを自分で組み合わせて軽量にスクレイピングでき、静的なページならブラウザ起動が不要な分高速。PlaywrightはJavaScriptレンダリングが必要な動的サイトやブラウザ操作そのものの検証（E2Eテスト）に対応できるが、実ブラウザを起動する分リソースを消費する |
選定判断
ブラウザ経由のE2Eテストや、JavaScript実行が必要な動的サイトのスクレイピングでは第一候補。静的HTMLの取得だけならブラウザ起動が不要な軽量ライブラリのほうが高速。CI環境のNode.jsバージョンやOSが対応範囲外の場合は、先にランナー環境を合わせる必要がある
Playwrightは1つのAPIでChromium・Firefox・WebKitの3エンジンを同じコードから操作できる点が特徴で、テストランナー（Playwright Test）・トレースビューア・自動待機（auto-wait）などE2Eテストに必要な機能一式を内蔵する。ブラウザの実体を操作するため、HTTPリクエストのみで完結する軽量なスクレイピングよりも動的サイトへの対応力が高い。
利用者が最初に当たるのはNode.jsのバージョン要件とOS要件で、CI環境のイメージがこれに合っていないとインストール自体が失敗する。次に当たるのがブラウザバイナリの容量で、更新のたびに数百MB単位のダウンロードが発生し、キャッシュしても時間短縮効果が薄いことは事前に知っておく必要がある。