次の方法で共有

Microsoft Playwright Testing プレビュー

  • [アーティクル]

Microsoft Playwright Testing は、クラウドを使用して、異なるオペレーティング システムとブラウザーの組み合わせではるかに高い並列化を使用して Playwright テストを同時に実行できるようにするフル マネージドの Azure サービスです。 つまり、より広範なシナリオカバレッジでテスト実行が高速化され、品質を犠牲にすることなく機能の配信を高速化できます。 また、このサービスを使用すると、テスト結果と関連する成果物をサービスに発行し、サービス ポータルで表示することで、より迅速かつ簡単なトラブルシューティングを行うことができます。 Microsoft Playwright Testing サービスを使用すると、より迅速かつ自信を持って機能をリリースできます。

作業を開始する準備はできましたか? クイック スタート ガイドのに移動してください。

作業の開始

サービスを使用して既存の Playwright テスト スイートを実行するには、次の手順に従います。

前提 条件

  • アクティブなサブスクリプションを持つ Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウント を作成 。
  • Azure アカウントには、所有者、共同作成者、またはクラシック管理者ロールのいずれかが割り当てられている必要があります。
  • Azure CLI は、Playwright テストを実行しているコンピューターにインストールする必要があります。

ワークスペースを作成する

  1. Azure アカウントを使用して、Playwright ポータル にサインインします。

  2. ワークスペースを作成します。

    新しいワークスペース を作成する

    畑 形容
    ワークスペース名の ワークスペースを識別する一意の名前。
    名前に特殊文字や空白を含めることはできません。
    Azure サブスクリプション の ワークスペースを作成する Azure サブスクリプションを選択します。
    リージョン ここで、ワークスペースのテスト実行データが格納されます。

この画面が表示されない場合は、既存のワークスペースを選択し、次のセクションに進みます。

Microsoft Playwright Testing パッケージをインストールする

  1. このコマンドを実行してサービス パッケージをインストールする

    npm init @azure/microsoft-playwright-testing

サービス パッケージをインストールすると、playwright.service.config.ts という名前のサービス構成ファイルが作成されます

サービス構成は次の機能を果たします。

  • Playwright を Microsoft Playwright Testing サービスに直接認証します。
  • Microsoft Playwright Testing レポートを構成に追加します。
  • 必要に応じて、サービス操作のタイムアウトをオーバーライドします。

プロジェクトでバージョン 1.47 以降 @playwright/test 使用していることを確認します。

リージョン エンドポイントを取得する

  1. Playwright ポータルで、セットアップの [リージョン エンドポイントの追加] コマンドをコピーします。

    ワークスペース エンドポイントの を設定する

    エンドポイント URL はワークスペース リージョンに対応します。 ワークスペースの作成時に選択したリージョンに応じて、Playwright ポータルに異なるエンドポイント URL が表示される場合があります。

環境を設定する

前の手順で取得した PLAYWRIGHT_SERVICE_URL が環境内で使用できることを確認します。

dotenv モジュールを使用して環境を管理することをお勧めします。 dotenv では、.env ファイルを使用して環境変数を定義します。

シークレットをリークしないように、.env ファイルを .gitignore ファイルに追加することを忘れないでください。

npm i --save-dev dotenv

.env ファイル

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/accounts/workspace-id/browsers

認証を設定する

Microsoft Playwright Testing ワークスペースで Playwright テストを実行するには、サービスでテストを実行している Playwright クライアントを認証する必要があります。 これは、ローカルの開発マシンまたは CI マシンです。

このサービスには、Microsoft Entra ID とアクセス トークンの 2 つの認証方法が用意されています。

Microsoft Entra ID では Azure 資格情報が使用され、セキュリティで保護されたアクセスのために Azure アカウントへのサインインが必要です。 または、Playwright ワークスペースからアクセス トークンを生成し、セットアップで使用することもできます。

Microsoft Entra ID を使用して認証を設定する

Microsoft Entra ID は、サービスの既定の推奨認証です。 ローカル開発マシンから、Azure CLI 使用してサインインできます

az login

注: 複数の Microsoft Entra テナントの一部である場合は、ワークスペースが属するテナントにサインインしていることを確認してください。 テナント ID は Azure portal から取得できます。「Microsoft Entra テナントの検索」を参照してください。 ID を取得したら、コマンド az login --tenant <TenantID> を使用してサインインします。

アクセス トークンを使用して認証を設定する

Playwright Testing ワークスペースからアクセス トークンを生成し、セットアップで使用できます。 ただし、セキュリティが強化されているため、認証には Microsoft Entra ID を強くお勧めします。 アクセス トークンは便利ですが、有効期間の長いパスワードのように機能し、侵害される可能性が高くなります。

  1. アクセス トークン ベースの認証を使用するには、アクセス トークン ベースの認証 を有効にする

  2. アクセス トークンを使用して認証を設定

サービスへの認証には Microsoft Entra ID を使用することを強くお勧めします。 アクセス トークンを使用している場合は、「アクセス トークンを管理する方法

注: CI パイプラインで Microsoft Playwright Testing を使用するには、パイプラインからサービスで認証を構成する必要があります。さまざまなブラウザーとオペレーティング システム間で継続的なエンド ツー エンド テストを設定する方法に関する

テストを実行する

上記で作成した構成を使用して、サービスによって管理されているブラウザーに対して Playwright テストを実行します。

npx playwright test --config=playwright.service.config.ts --workers=20

次の手順

貢献

このプロジェクトは、投稿と提案を歓迎します。 ほとんどの投稿では、お客様が投稿を使用する権利を当社に付与する権利を有し、実際に行うことを宣言する共同作成者ライセンス契約 (CLA) に同意する必要があります。 詳細については、https://cla.opensource.microsoft.comを参照してください。

プル要求を送信すると、CLA ボットは、CLA を提供し、PR を適切に装飾する必要があるかどうかを自動的に判断します (状態チェック、コメントなど)。 ボットによって提供される指示に従うだけです。 これは、CLA を使用するすべてのリポジトリで 1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの行動規範を採用しています。 詳細については、行動規範に関する FAQ を参照するか、その他の質問やコメントを opencode@microsoft.com にお問い合わせください。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれている場合があります。 Microsoft の商標またはロゴの承認された使用は、マイクロソフトの商標 & ブランド ガイドライン従う必要があります。 このプロジェクトの変更されたバージョンで Microsoft の商標またはロゴを使用することは、混乱を招いたり、Microsoft のスポンサーシップを暗示したりしてはなりません。 第三者の商標またはロゴの使用は、これらの第三者のポリシーに従います。