Playwrightの初回実行でブラウザのダウンロードが始まる

結論

Playwrightを初めて実行すると、テスト用ブラウザのダウンロードが始まることがあります。進捗表示がしばらく変わらなくても、ダウンロード中の場合があります。

対象

この記事は、通常ルームでPlaywrightを使ったe2eテストを実行する利用者に向けたヘルプです。

よくある状況

playwright や test:e2e を初めて実行したとき、ブラウザのダウンロードが始まります。ネットワークやキャッシュの状態により、完了まで時間がかかる場合があります。

プロジェクトによっては、テスト実行前に次のような準備コマンドが必要です。

npx playwright install

実際のコマンドは、プロジェクトのREADMEやセットアップ手順に従ってください。

待つべきか判断する

進捗がすぐ変わらなくても、ダウンロードや展開が進んでいることがあります。まずは数分待ち、ネットワークエラーや容量不足のエラーが出ていないか確認してください。

再実行が必要になる場合

ルームやコンテナを作り直した場合、ブラウザのキャッシュが消え、再ダウンロードが必要になることがあります。

同じエラーが続く場合は、プロジェクトの推奨Node.jsバージョン、パッケージのインストール状況、ネットワーク接続を確認してください。