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

CIのセットアップ

はじめに​

Playwrightのテストは、あらゆるCIプロバイダーで実行できます。このセクションでは、GitHub Actionsを使用してGitHub上でテストを実行する方法について説明します。他のCIプロバイダーを設定する方法については、継続的インテグレーションに関する詳細なドキュメントをご確認ください。

学ぶこと​

GitHub Actionsのセットアップ​

GitHub Actionsファイルを追加するには、まず.github/workflowsフォルダーを作成し、その中に以下のサンプルコードを含むplaywright.ymlファイルを追加します。これにより、main/masterブランチへのプッシュおよびプルリクエストごとにテストが実行されます。

.github/workflows/playwright.yml
name: Playwright Tests
on:
  push:
    branches: [ main, master ]
  pull_request:
    branches: [ main, master ]
jobs:
  test:
    timeout-minutes: 60
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: Setup dotnet
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: 8.0.x
    - name: Build & Install
      run: dotnet build
    - name: Ensure browsers are installed
      run: pwsh bin/Debug/net8.0/playwright.ps1 install --with-deps
    - name: Run your tests
      run: dotnet test

これに関する詳細については、「GitHub Actionsを理解する」を参照してください。

jobs.test.steps内のステップリストを見ると、ワークフローが以下のステップを実行していることがわかります。

  1. リポジトリをクローンする
  2. 言語の依存関係をインストールする
  3. プロジェクトの依存関係をインストールしてビルドする
  4. Playwrightブラウザをインストールする
  5. テストを実行する

リポジトリを作成してGitHubにプッシュする​

GitHub Actionsワークフローのセットアップが完了したら、あとはGitHubでリポジトリを作成するか、既存のリポジトリにコードをプッシュするだけです。GitHubの指示に従い、`git init`コマンドを使用してGitリポジトリを初期化することを忘れないでください。これにより、コードを追加、コミット、およびプッシュできます。

dotnet repo on github

ワークフローを開く​

Actionsタブをクリックしてワークフローを確認します。ここで、テストが成功したか失敗したかを確認できます。

​

opening the workflow

プルリクエストでは、PRステータスチェック内のDetailsリンクをクリックすることもできます。

pr status checked

テストログの表示​

ワークフローの実行をクリックすると、GitHubが実行したすべてのアクションが表示され、Run Playwright testsをクリックすると、エラーメッセージ、期待されたものと受け取られたもの、および呼び出しログが表示されます。

​

viewing the test logs

トレースの表示​

GitHub ActionsのようなCIで作成されたトレースをアーティファクトとしてアップロードできます。これには、トレースの開始と停止が必要です。失敗したテストに対してのみトレースを記録することをお勧めします。トレースがCIにアップロードされると、trace.playwright.devを使用してダウンロードして開くことができます。これはトレースビューアーの静的ホスト版です。トレースファイルはドラッグアンドドロップでアップロードできます。

​

playwright trace viewer

次は何をしますか​