Playwright テスト分離と Browser Context
この章では、Playwright のテスト分離メカニズムと Browser Context の概念を説明します。これはテストの安定性と信頼性を保証するための重要な設計です。
テスト分離とは
テスト分離とは、各テストケースが完全に独立した環境で実行され、互いに影響を与えないことです。
Playwright では、各テストは自動的に独立したBrowser Context(ブラウザコンテキスト)を取得します。
Browser Context とは
Browser Context は、いわばまったく新しいブラウザのプロファイルに相当します。。
Context を作成することは、まったく新しいブラウザウィンドウを開くようなものです。独自の Cookie、localStorage、sessionStorage を持ちますが、オーバーヘッドは非常に低い(ミリ秒単位)です。
| 概念 | たとえ | 説明 |
|---|---|---|
| Browser(ブラウザインスタンス) | ブラウザプログラムを1つ起動した状態 | オーバーヘッドが大きく、通常はテスト実行全体で1回だけ作成される |
| Browser Context(ブラウザコンテキスト) | ブラウザ内の独立したプロファイル | オーバーヘッドが小さく、テストごとに1つ作成される |
| Page(タブ) | ブラウザ内の1つのタブ | Context 内でページを開く |
各テストでは、pageとcontextすべて新しいため、あるテストが localStorage や Cookie を変更しても、他のテストには影響しません。
Context で分離される内容
各 Browser Context 間では、以下が完全に分離されます:
| 分離項目 | 説明 |
|---|---|
| Cookies | 各 Context は独立した Cookie ストレージを持ちます |
| localStorage | ローカルストレージは完全に分離されます |
| sessionStorage | セッションストレージは完全に分離されます |
| IndexedDB | ブラウザデータベースは分離されます |
| キャッシュ(Cache) | HTTP キャッシュは分離されます |
例
test('テスト A', async ({ page }) => {
await page.goto('https://www.example.com/');
// Cookie を設定(現在の Context でのみ有効)
await page.context().addCookies([{
name: 'サンプル_session',
value: 'abc123',
domain: 'www.example.com',
path: '/',
}]);
// 以降の操作でこの Cookie を使用
});
// テスト B は新しい Context を受け取るため、テスト A が設定した Cookie は存在しない
test('テスト B', async ({ page }) => {
await page.goto('https://www.example.com/');
// context().cookies() は空の配列を返す
const cookies = await page.context().cookies();
console.log(cookies); // []
});
context fixture の使用
`page` に加えて、pageテスト関数はcontext`context` fixture を使って Context レベルの操作を行うことができます。
例
// Context レベルで権限を設定
await context.grantPermissions(['geolocation']);
await context.setGeolocation({ latitude: 39.9, longitude: 116.4 });
// Context レベルでネットワークをインターセプト
await context.route('**/*.{png,jpg,jpeg}', route => route.abort());
// page は同じ context 内にあるため、上記の設定を引き継ぐ
await page.goto('https://www.example.com/');
});
複数 Context のシナリオ
同じテスト内で複数の独立したユーザーをシミュレートする必要がある場合は、Context を手動で作成できます。
例
// 2人のユーザー用に独立した Context を作成
const userAContext = await browser.newContext();
const userBContext = await browser.newContext();
// 2人のユーザーのページは完全に分離される
const pageA = await userAContext.newPage();
const pageB = await userBContext.newPage();
await pageA.goto('https://www.example.com/login');
await pageB.goto('https://www.example.com/login');
// ユーザー A がログイン
await pageA.getByLabel('ユーザー名').fill('user_a');
await pageA.getByLabel('パスワード').fill('password_a');
await pageA.getByRole('button', { name: 'ログイン' }).click();
// ユーザー B がログイン(それぞれ独立した Cookie/Session で、互いに影響しない)
await pageB.getByLabel('ユーザー名').fill('user_b');
await pageB.getByLabel('パスワード').fill('password_b');
await pageB.getByRole('button', { name: 'ログイン' }).click();
// クリーンアップ
await userAContext.close();
await userBContext.close();
});
テスト分離の利点
1. 再現性
各テストは同じ初期状態から始まり、どのような順序で実行しても結果が一致します。
2. 連鎖的な失敗の防止
テスト A が失敗してもテスト B まで失敗することはありません。各テストは独立してデバッグできます。
3. 並列実行のサポート
テストが完全に独立しているため、Playwright は複数のワーカーでそれらを安全に並列実行できます。
その他の拡張テスト分離は Playwright のデフォルト動作です。各テストは
test()自動的に独立した Browser Context をpageとcontext取得するため、追加の設定は一切不要です。