Playwrightのworkersを増やすとどこまで速くなるか
Playwright の E2E テストの実行時間を短くしたいときは、テストを並列で動かす worker プロセスの数(workers)を増やす方法があります。論理CPUが4つの検証環境で workers を1から12まで変えて測ったところ、ページの表示や処理を待つ時間が中心のテストは、CPU の数を超えて12まで増やしても速くなりました。一方、CPU を使う計算が中心のテストは、workers を CPU の数と同じ4にしたときがいちばん速く、それより増やすと遅くなりました。
また、1つのファイルにテストをまとめて書いている場合は、workers を増やしただけでは並列になりません。fullyParallel の設定が必要です。
検証環境は Ubuntu 24.04、論理CPU 4つ、Node.js 22.23.4、@playwright/test 1.63.0 です。テストは TypeScript で書き、ブラウザは Chromium(ヘッドレス)だけで動かしました。テストするページは page.setContent() でその場に作り、サーバーには接続していません。CI のサービス上での実行、--shard で複数のマシンに分ける方法、CPU の数が違うマシン、Firefox と WebKit は試していません。
測るために用意した2種類のテスト
workers の効き方は、テストが何に時間を使っているかで変わります。そこで、性質の違うテストを2種類、それぞれ4ファイル×3件の12件ずつ用意しました。
1つめは、待ち時間が中心のテストです。「保存」を押すと2秒後に「保存しました」と出るページを開き、その表示を待ちます。サーバーの応答や画面の切り替えを待つ、よくある E2E テストに近い形です。
// tests/pages.ts
export const waitPage = `
<button id="save">保存</button>
<p id="status"></p>
<script>
document.querySelector('#save').addEventListener('click', () => {
setTimeout(() => {
document.querySelector('#status').textContent = '保存しました';
}, 2000);
});
</script>
`;
// tests/wait/a.spec.ts(b〜d.spec.ts はテストの名前だけが違う)
import { test, expect } from '@playwright/test';
import { waitPage } from '../pages';
for (const n of [1, 2, 3]) {
test(`保存を待つ a-${n}`, async ({ page }) => {
await page.setContent(waitPage);
await page.getByRole('button', { name: '保存' }).click();
await expect(page.locator('#status')).toHaveText('保存しました');
});
}
2つめは、計算が中心のテストです。ページの中で1億5千万回のループを回し、CPU を使い続けます。重いページの描画やスクリプトの実行で、ブラウザが CPU を使う場面の代わりです。
// tests/pages.ts(続き)
export const heavyCalc = (n: number) => {
let x = 0;
for (let i = 0; i < n; i++) x = (x + Math.sqrt(i)) % 1000;
return x;
};
// tests/cpu/a.spec.ts(b〜d.spec.ts はテストの名前だけが違う)
import { test, expect } from '@playwright/test';
import { heavyCalc } from '../pages';
for (const n of [1, 2, 3]) {
test(`計算する a-${n}`, async ({ page }) => {
const result = await page.evaluate(heavyCalc, 150_000_000);
expect(typeof result).toBe('number');
});
}
設定ファイルは、テストの場所とブラウザを決めただけです。
// playwright.config.ts
import { defineConfig } from '@playwright/test';
export default defineConfig({
testDir: './tests',
reporter: 'dot',
use: { browserName: 'chromium' },
});
workers の数はコマンドラインの --workers で変え、ファイルの中のテストも並列に動かす --fully-parallel を付けました(理由は後の節で説明します)。workers の数ごとに3回ずつ動かし、出力の最後に出る全体の時間(12 passed (8.4s) のかっこの中)を記録しました。
npx playwright test tests/wait --fully-parallel --workers=4
測った結果
3回の中央値を表にしました。かっこの中は3回の値です。
| workers | 待ち時間が中心のテスト | 計算が中心のテスト |
|---|---|---|
| 1 | 29.9秒(29.8 / 29.9 / 29.9) | 28.8秒(25.8 / 28.8 / 28.9) |
| 2 | 15.4秒(15.4 / 15.4 / 15.5) | 15.1秒(15.3 / 15.1 / 14.3) |
| 4 | 8.4秒(8.4 / 8.4 / 8.4) | 7.4秒(7.3 / 7.4 / 7.4) |
| 6 | 6.5秒(6.4 / 6.5 / 6.6) | 7.9秒(7.9 / 7.8 / 8.0) |
| 8 | 7.0秒(6.9 / 7.1 / 7.0) | 8.5秒(8.2 / 8.7 / 8.5) |
| 12 | 5.6秒(5.6 / 5.6 / 5.8) | 9.3秒(9.1 / 9.3 / 9.5) |

workers が1から4までは、どちらのテストも workers を倍にすると時間がほぼ半分になりました。違いが出たのは、CPU の数の4を超えてからです。
待ち時間が中心なら、CPU の数より多くても速くなる
待ち時間が中心のテストは、workers を12にしたときが5.6秒でいちばん速く、4のとき(8.4秒)より短くなりました。このテストがしているのは、setTimeout で2秒たってから出る表示を待つことだけです。計算が中心のテストと違い、CPU の数を超えた6、8、12でも、4のときより短くなりました。
ただし、増やせば増やすほど速くなるわけではありませんでした。6では6.5秒、8では7.0秒で、3回とも8のほうが少し遅くなっています(6は6.4〜6.6秒、8は6.9〜7.1秒)。
計算が中心なら、CPU の数で頭打ちになる
計算が中心のテストは、workers を4にしたときが7.4秒でいちばん速く、6で7.9秒、8で8.5秒、12で9.3秒と、増やすほど遅くなりました。
1件ずつの時間を --reporter=list で出すと、理由が見えます。workers が4のときは、どのテストも2.0〜2.2秒で終わりました。
Running 12 tests using 4 workers
✓ 2 tests/cpu/a.spec.ts:5:3 › 計算する a-1 (2.1s)
✓ 3 tests/cpu/a.spec.ts:5:3 › 計算する a-2 (2.2s)
✓ 1 tests/cpu/b.spec.ts:5:3 › 計算する b-1 (2.2s)
…(中略)
12 passed (7.4s)
12件をそれぞれ別の worker で動かした(workers が12の)ときは、1件ごとの時間が5.4〜6.6秒に延びました。
Running 12 tests using 12 workers
✓ 1 tests/cpu/a.spec.ts:5:3 › 計算する a-2 (5.4s)
✓ 4 tests/cpu/c.spec.ts:5:3 › 計算する c-3 (6.0s)
✓ 3 tests/cpu/b.spec.ts:5:3 › 計算する b-2 (6.5s)
…(中略)
12 passed (9.0s)
公式ドキュメントの並列実行の説明によると、worker はそれぞれ別の OS プロセスで、自分のブラウザを起動します。この検証環境の CPU は4つなので、workers を12にしても、1件ごとの計算に時間がかかるようになっただけでした。全体の時間は、4のときの7.4秒より長い9.0秒です。計算が中心のテストでは、workers を CPU の数より多くしても速くなりませんでした。
何も指定しないときの workers の数
--workers を付けずに動かすと、この検証環境では2つの worker で動きました。
$ npx playwright test tests/wait
Running 12 tests using 2 workers
············
12 passed (15.5s)
TestConfig の workers の説明によると、初期設定は「論理CPUの数の半分」です。論理CPUが4つなので2になりました。待ち時間が中心のテストは、この2つの worker で15.5秒でした。4つの worker で動いたときは、--fully-parallel を付けた場合で8.4秒、付けなかった場合(次の節)で8.5秒です。初期設定のままで遅いと感じたら、まず CPU の数まで増やしてみる価値があります。
数は設定ファイルの workers でも決められます。'50%' のように、論理CPUの数に対する割合でも書けます。
// playwright.config.ts
export default defineConfig({
workers: 4,
});
1つのファイルのテストは、そのままでは並列にならない
ここまでの計測では --fully-parallel を付けていました。付けないと、workers を増やしても、その数だけ worker が使われるとは限りません。
待ち時間が中心のテスト(4ファイル)を、--fully-parallel を付けずに --workers=12 で動かすと、使われた worker は4つでした。この節の出力は、Running と passed の行だけを抜き出して載せています。
Running 12 tests using 4 workers
12 passed (8.5s)
12件をすべて1つのファイル(tests/onefile/all.spec.ts)に書いた場合は、--workers=4 を付けても1つの worker で動き、30.0秒かかりました。同じテストに --fully-parallel を付けると、4つの worker で8.4秒でした。
$ npx playwright test tests/onefile --workers=4
Running 12 tests using 1 worker
12 passed (30.0s)
$ npx playwright test tests/onefile --workers=4 --fully-parallel
Running 12 tests using 4 workers
12 passed (8.4s)
公式ドキュメントの並列実行の説明にあるとおり、初期設定で並列になるのはファイル単位で、1つのファイルの中のテストは同じ worker で順に動きます。この検証でも、4ファイルに --workers=12 を指定して使われた worker は4つ、1ファイルに --workers=4 を指定して使われた worker は1つでした。
ファイルの中のテストも並列にするには、設定ファイルに fullyParallel: true を書きます。特定のファイルだけなら、そのファイルの先頭で test.describe.configure({ mode: 'parallel' }) を呼びます。
// playwright.config.ts
export default defineConfig({
fullyParallel: true,
});
並列に動くテストは別々の worker プロセスで動くので、変数などの状態を共有できません。また、beforeAll や afterAll も、テストごとにそれぞれ実行されます(公式ドキュメントの、1つのファイルのテストを並列にする節)。前のテストで作ったものを次のテストで使う書き方をしているなら、fullyParallel にする前に見直しが必要です。





