Playwright でブラウザが起動できない(Executable doesn't exist)
「Executable doesn't exist」は、npm パッケージとは別に管理されるブラウザバイナリが未取得なのが原因。
npx playwright install で取得する。
バージョン更新直後や CI のキャッシュ不整合でも起きる。
公開: 更新:
npx playwright test --reporter=line … Error: browserType.launch: Executable doesn't exist at /root/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell ╔════════════════════════════════════════════════════════════╗ ║ Looks like Playwright was just installed or updated. ║ ║ Please run the following command to download new browsers: ║
npx playwright test --reporter=line Running 1 test using 1 worker [1/1] example.spec.js:3:1 › 見出しが表示される 1 passed (478ms)
2026-09-18 に node:20(Node.js 20.20.2 / npm 10.8.2) で実際に打って取った出力。検証環境の詳細
要約
browserType.launch: Executable doesn't exist at /home/user/.cache/ms-playwright/... が出てブラウザが起動できない原因は、npm パッケージとは別に管理されるブラウザバイナリが取得されていない ことである。npx playwright install を一度実行すれば解決する。
Playwright をバージョンアップした直後や、CI でキャッシュを部分的にしか復元していない場合にも同じエラーが出る。
実行例
パッケージを入れただけの状態でテストを走らせると、Executable doesn't exist at /root/.cache/ms-playwright/... と npx playwright install を促す枠が出て終了コード 1 になる。npx playwright install chromium でキャッシュディレクトリにバイナリが並ぶとテストは通り、PLAYWRIGHT_BROWSERS_PATH を実行時だけ別の場所に向けると同じエラーに戻る。
$ npx playwright test --reporter=line
Running 1 test using 1 worker
[1/1] example.spec.js:3:1 › 見出しが表示される
1) example.spec.js:3:1 › 見出しが表示される ───────────────────────────────────────────────────────────────
Error: browserType.launch: Executable doesn't exist at /root/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated. ║
║ Please run the following command to download new browsers: ║
║ ║
║ npx playwright install ║
║ ║
║ <3 Playwright Team ║
╚════════════════════════════════════════════════════════════╝
Error Context: test-results/example-見出しが表示される/error-context.md
1 failed
example.spec.js:3:1 › 見出しが表示される ────────────────────────────────────────────────────────────────
$ echo $?
1$ npx playwright install chromium 2>&1 | grep -v '^|'
Downloading Chrome for Testing 153.0.8010.12 (playwright chromium v1243) from https://cdn.playwright.dev/builds/cft/153.0.8010.12/linux64/chrome-linux64.zip
Chrome for Testing 153.0.8010.12 (playwright chromium v1243) downloaded to /root/.cache/ms-playwright/chromium-1243
Downloading FFmpeg (playwright ffmpeg v1011) from https://cdn.playwright.dev/dbazure/download/playwright/builds/ffmpeg/1011/ffmpeg-linux.zip
FFmpeg (playwright ffmpeg v1011) downloaded to /root/.cache/ms-playwright/ffmpeg-1011
Downloading Chrome Headless Shell 153.0.8010.12 (playwright chromium-headless-shell v1243) from https://cdn.playwright.dev/builds/cft/153.0.8010.12/linux64/chrome-headless-shell-linux64.zip
Chrome Headless Shell 153.0.8010.12 (playwright chromium-headless-shell v1243) downloaded to /root/.cache/ms-playwright/chromium_headless_shell-1243$ ls /root/.cache/ms-playwright
chromium-1243
chromium_headless_shell-1243
ffmpeg-1011$ npx playwright test --reporter=line
Running 1 test using 1 worker
[1/1] example.spec.js:3:1 › 見出しが表示される
1 passed (478ms)
$ echo $?
0$ PLAYWRIGHT_BROWSERS_PATH=/opt/pw-browsers npx playwright test --reporter=line
Running 1 test using 1 worker
[1/1] example.spec.js:3:1 › 見出しが表示される
1) example.spec.js:3:1 › 見出しが表示される ───────────────────────────────────────────────────────────────
Error: browserType.launch: Executable doesn't exist at /opt/pw-browsers/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell
╔════════════════════════════════════════════════════════════╗
║ Looks like Playwright was just installed or updated. ║
║ Please run the following command to download new browsers: ║
║ ║
║ npx playwright install ║
║ ║
║ <3 Playwright Team ║
╚════════════════════════════════════════════════════════════╝
Error Context: test-results/example-見出しが表示される/error-context.md
1 failed
example.spec.js:3:1 › 見出しが表示される ────────────────────────────────────────────────────────────────
$ echo $?
1$ PLAYWRIGHT_BROWSERS_PATH=/root/.cache/ms-playwright npx playwright test --reporter=line
Running 1 test using 1 worker
[1/1] example.spec.js:3:1 › 見出しが表示される
1 passed (430ms)
$ echo $?
0— 2026-09-18 時点の出力
検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-09-18 検証(ほか 1 件)
- 検証日
- 実行環境
node:20Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 20.20.2
- npm 10.8.2
- Python 3.11.2
- Git 2.39.5
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. ブラウザをインストールする
npx playwright install
# Chromium だけで十分な場合
npx playwright install chromium取得先やリビジョンの仕組みは 公式ドキュメントの Browsers(新しいタブで開く) に詳しい。
2. バージョン更新時に再実行する
npm install -D @playwright/test@latest
npx playwright installpackage.json の更新とブラウザの再取得は 必ずセット で行う。
3. CI では --with-deps を使う
- run: npx playwright install --with-depsLinux ランナーではブラウザ本体に加えて OS の依存ライブラリも必要なため、--with-deps を付けるか、すべて同梱済みの公式 Docker イメージ(mcr.microsoft.com/playwright)を使う。
設定例は 公式の CI ガイド(新しいタブで開く) に載っている。
4. PLAYWRIGHT_BROWSERS_PATH を揃える
ブラウザの置き場所を PLAYWRIGHT_BROWSERS_PATH で変えている場合、インストール時と実行時の両方で同じ値を設定する。
片方だけ設定されていると、取得済みでも「Executable doesn't exist」になる。
よくある原因
- ブラウザをインストールしていない。
npm installは@playwright/test本体しか入れないので、Chromium などの実体は別途取得する必要がある。 - バージョンを更新したあと、ブラウザを取り直していない。
Playwright は各バージョンが特定リビジョンのブラウザ(例:chromium-1148)に紐づくため、更新すると既存バイナリでは起動できない。 - CI のキャッシュが揃っていない。
node_modulesだけ復元し、ブラウザの置き場所(Linux では~/.cache/ms-playwright)を復元していない。 - インストール時と実行時で、PLAYWRIGHT_BROWSERS_PATH の参照先ディレクトリが異なる。