Playwright の HTML レポート自動表示はヘッドレス環境でハングする

Codespaces で npx playwright test を実行したら、テスト完了後にプロセスがハングした。ブラウザで HTML レポートを開こうとして止まっていた。

playwright.config.ts で reporter を "html" に設定していると、テスト後に自動でブラウザを開こうとする。ヘッドレス環境ではこれが失敗してハングする。

// NG: ヘッドレス環境でハングする
reporter: "html",
 
// OK: 自動オープンを無効化
reporter: [["html", { open: "never" }]],

環境変数 PLAYWRIGHT_HTML_OPEN=never でも回避できるが、config に書いておく方が確実だ。レポートを見たいときは npx playwright show-report で明示的に開ける。