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

インストール

はじめに​

Playwright Test は、エンドツーエンドテストのニーズに対応するために特別に作成されました。Playwright は、Chromium、WebKit、Firefox を含むすべての最新レンダリングエンジンをサポートしています。Windows、Linux、macOS で、ローカルまたは CI 上で、ヘッドレスまたはヘッド付きで、Android 版 Google Chrome およびモバイル Safari のネイティブモバイルエミュレーションを使用してテストします。

学習内容

Playwright のインストール​

npm、yarn、または pnpm を使用して Playwright をインストールして開始します。または、VS Code 拡張機能を使用して開始し、テストを実行することもできます。

npm init playwright@latest

インストールコマンドを実行し、以下を選択して開始します

  • TypeScript または JavaScript を選択します (デフォルトは TypeScript)
  • テストフォルダーの名前 (デフォルトは tests または e2e (プロジェクトに tests フォルダーが既にある場合))
  • GitHub Actions ワークフローを追加して、CI でテストを簡単に実行できるようにします
  • Playwright ブラウザーをインストールします (デフォルトは true)

インストールされるもの​

Playwright は、必要なブラウザーをダウンロードし、次のファイルを作成します。

playwright.config.ts
package.json
package-lock.json
tests/
  example.spec.ts
tests-examples/
  demo-todo-app.spec.ts

playwright.config は、Playwright を実行するブラウザーの変更など、Playwright の構成を追加できる場所です。既存のプロジェクト内でテストを実行している場合、依存関係は package.json に直接追加されます。

tests フォルダーには、テストを開始するのに役立つ基本的なサンプルテストが含まれています。詳細な例については、todo アプリをテストするために作成されたテストを含む tests-examples フォルダーを確認してください。

サンプルテストの実行​

デフォルトでは、テストは Chromium、Firefox、WebKit の 3 つのブラウザーすべてで、3 つのワーカーを使用して実行されます。これは、playwright.config ファイルで構成できます。テストはヘッドレスモードで実行されるため、テストの実行時にブラウザーは開きません。テストの結果とテストログはターミナルに表示されます。

npx playwright test

tests running in command line ヘッドレスモードでのテストの実行、複数のテストの実行、特定のテストの実行などについては、テストの実行に関するドキュメントをご覧ください。

HTML テストレポート​

テストが完了すると、HTML レポーターが生成され、ブラウザー、合格したテスト、失敗したテスト、スキップされたテスト、および不安定なテストでレポートをフィルタリングできるテストの完全なレポートが表示されます。各テストをクリックして、テストのエラーとテストの各ステップを調べることができます。デフォルトでは、一部のテストが失敗した場合、HTML レポートが自動的に開かれます。

npx playwright show-report

HTML Report

UI モードでのサンプルテストの実行​

UI モードでテストを実行すると、タイムトラベルデバッグ、ウォッチモードなどで開発者エクスペリエンスが向上します。

npx playwright test --ui

UI Mode

機能の詳細については、UI モードに関する詳細ガイドをご覧ください。

Playwright の更新​

Playwright を最新バージョンに更新するには、次のコマンドを実行します

npm install -D @playwright/test@latest
# Also download new browser binaries and their dependencies:
npx playwright install --with-deps

次のコマンドを実行すると、Playwright のバージョンをいつでも確認できます

npx playwright --version

システム要件​

  • 最新バージョンの Node.js 18、20、または 22。
  • Windows 10 以降、Windows Server 2016 以降、または Windows Subsystem for Linux (WSL)。
  • macOS 13 Ventura 以降。
  • Debian 12、Ubuntu 22.04、Ubuntu 24.04 (x86-64 および arm64 アーキテクチャ上)。

次へ​