メインコンテンツにスキップ

分離

はじめに​

Playwright で書かれたテストは、ブラウザコンテキストと呼ばれる隔離されたまっさらな環境で実行されます。この分離モデルにより、再現性が向上し、連鎖的なテストの失敗を防ぎます。

テスト分離とは？​

テスト分離とは、それぞれのテストが他のテストから完全に分離されている状態を指します。すべてのテストは、他のどのテストとも独立して実行されます。これは、各テストが独自のローカルストレージ、セッションストレージ、Cookieなどを持つことを意味します。Playwrightは、インコグニートモードのようなプロファイルに相当するBrowserContextを使用することでこれを実現しています。これらは、作成が高速かつ安価で、単一のブラウザで実行されている場合でも完全に分離されています。Playwrightは各テストに対してコンテキストを作成し、そのコンテキスト内でデフォルトのPageを提供します。

テスト分離が重要な理由​

  • 失敗の持ち越しがない。1つのテストが失敗しても、他のテストに影響を与えません。
  • エラーや不安定さのデバッグが簡単です。なぜなら、単一のテストを何度でも実行できるからです。
  • 並行実行やシャーディングなどを行う際に、順序を考慮する必要がありません。

テスト分離の2つの方法​

テスト分離には、最初からやり直すか、途中でクリーンアップするかの2つの異なる戦略があります。テスト間にクリーンアップを行うことの問題点は、クリーンアップを忘れやすく、「訪問済みリンク」のようにクリーンアップできないものがあることです。あるテストの状態が次のテストに漏れ出し、テストが失敗したり、問題が別のテストから発生するためデバッグが困難になる可能性があります。最初からやり直すということはすべてが新しいということなので、テストが失敗しても、そのテスト内だけを調べればデバッグできます。

Playwright がテスト分離を実現する方法​

Playwright はブラウザコンテキストを使用してテスト分離を実現します。各テストには独自のブラウザコンテキストがあります。テストを実行するたびに新しいブラウザコンテキストが作成されます。Playwright をテストランナーとして使用する場合、ブラウザコンテキストはデフォルトで作成されます。それ以外の場合は、ブラウザコンテキストを手動で作成できます。

import { test } from '@playwright/test';

test('example test', async ({ page, context }) => {
  // "context" is an isolated BrowserContext, created for this specific test.
  // "page" belongs to this context.
});

test('another test', async ({ page, context }) => {
  // "context" and "page" in this second test are completely
  // isolated from the first test.
});

ブラウザコンテキストは、モバイルデバイス、パーミッション、ロケール、カラースキームを含む複数ページのシナリオをエミュレートするためにも使用できます。詳細については、エミュレーションガイドをご覧ください。

単一テスト内の複数のコンテキスト​

Playwright は、単一のシナリオ内で複数のブラウザコンテキストを作成できます。これは、チャットのようなマルチユーザー機能をテストする場合に便利です。

import { test } from '@playwright/test';

test('admin and user', async ({ browser }) => {
  // Create two isolated browser contexts
  const adminContext = await browser.newContext();
  const userContext = await browser.newContext();

  // Create pages and interact with contexts independently
  const adminPage = await adminContext.newPage();
  const userPage = await userContext.newPage();
});