できない.dev

Playwright のテストが「Test timeout of 30000ms exceeded」で失敗する

Test timeout of 30000ms exceeded は、テスト本体やフックが既定 30 秒の上限を超えると出る。
要素が現れない原因を切り分けて待ち方を直し、本当に重いテストだけタイムアウトを延ばせば解決する。

公開: 更新:

症状できない · exit 1
npx playwright test
…
    Error: apiRequestContext.get: Request context disposed.
    Call log:
      - → GET http://127.0.0.1:3000/
        - user-agent: Playwright/1.64.0 (x64; debian 12) node/20.20
解決後できた · exit 0
npx playwright test
Running 1 test using 1 worker

[1/1] slow.spec.js:3:1 › slow API responds
  1 passed (35.9s)

2026-10-10 に node:20(Playwright 1.64.0 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

Test timeout of 30000ms exceeded は、Playwright が各テストに割り当てる既定 30 秒の上限を、テスト本体やフックの処理が超えたときに出る。

多くは「待っている要素がいつまでも現れない」ことが根本原因だ。
まずはタイムアウトを延ばす前に、なぜ待ち続けているのかを切り分ける。

実行例

応答に 35 秒かかる API を既定のテスト timeout 30 秒のまま待つと Test timeout of 30000ms exceeded. で落ち、終了コードは 1 になった。
そのテストだけ test.setTimeout(60_000) で延ばすと、同じ npx playwright test が 35.9 秒で通って終了コードは 0 になっている。

$ npx playwright test
Running 1 test using 1 worker
 
[1/1] slow.spec.js:3:1 › slow API responds
  1) slow.spec.js:3:1 › slow API responds ──────────────────────────────────────────────────────────
 
    Test timeout of 30000ms exceeded.
 
    Error: apiRequestContext.get: Request context disposed.
    Call log:
      - → GET http://127.0.0.1:3000/
        - user-agent: Playwright/1.64.0 (x64; debian 12) node/20.20
        - accept: */*
        - accept-encoding: gzip,deflate,br
 
      2 |
      3 | test("slow API responds", async ({ request }) => {
    > 4 |   const res = await request.get("http://127.0.0.1:3000/", { timeout: 0 });
        |                             ^
      5 |   expect(await res.text()).toBe("done");
      6 | });
      7 |
        at /tmp/tmp.N6moXGimT4/app/slow.spec.js:4:29
 
    Error Context: test-results/slow-slow-API-responds/error-context.md
 
  1 failed
    slow.spec.js:3:1 › slow API responds ───────────────────────────────────────────────────────────
$ echo $?
1
$ npx playwright test
Running 1 test using 1 worker
 
[1/1] slow.spec.js:3:1 › slow API responds
  1 passed (35.9s)
$ echo $?
0

— 2026-10-10 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-10 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • Playwright 1.64.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 待ち方を直す(最優先)

固定の waitForTimeout ではなく、自動リトライするアサーションで待つ。

await expect(page.getByRole("button", { name: "保存" })).toBeVisible();
await page.getByRole("button", { name: "保存" }).click();

2. 全体のタイムアウトを上げる

恒常的に時間がかかるなら設定で底上げする。

// playwright.config.ts
export default defineConfig({
  timeout: 60_000,
});

3. 個別テストだけ延長する

特定の重いテストだけ延ばすこともできる。

test("重い処理", async ({ page }) => {
  test.setTimeout(120_000);
  // ...
});

外部要因で一部だけ遅い場合は、toBeVisible({ timeout }) のように局所的な待機で対処する。

よくある原因

  1. 要素が出現しない。
    セレクタが間違っているか描画が遅いと、click などの自動待機が 30 秒を消費する。
  2. 遷移や通信が遅い。
    ページ遷移や API 応答が遅く、テスト全体が上限を超える。
  3. フックの時間も加算されている。
    beforeEach やフィクスチャの準備時間も、テストのタイムアウトに含まれる。
  4. 本質的に重い E2E テストに、タイムアウトの延長を設定していない。