次の方法で共有


Microsoft Playwright Testing プレビューの機能を使用する

この記事では、Microsoft Playwright Testing プレビューで提供される機能を使用する方法について説明します。

重要

Microsoft Playwright Testing は現在、プレビュー段階です。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

前提条件

背景

Microsoft Playwright Testing プレビューを使用すると、以下を行うことができます。

  • クラウドでホストされたブラウザーを使用してテストを並列で実行することで、ビルド パイプラインを高速化します。
  • テスト結果と成果物をサービスに対して発行し、サービス ポータルを通してそれらに簡単にアクセスできるようにすることで、トラブルシューティングを簡略化します。

これらの機能には独自の価格プランがあり、個別に課金されます。 いずれかの機能、または両方の機能を使用することができます。 これらの機能は、ワークスペースまたは特定の実行に対して有効または無効にすることができます。 価格の詳細については、「Microsoft Playwright Testing プレビューの価格」を参照してください

ワークスペースの機能を管理する

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

  2. ワークスペース設定アイコンを選択し、[全般] ページに移動して、ワークスペースの設定を表示します。

  3. [機能管理] セクションに移動します。

    Playwright Testing ポータルのワークスペース設定ページの機能管理を示すスクリーンショット。

  4. ワークスペースに対して有効にする機能を選択します。

    現時点では、サービスのレポート機能のみを有効または無効にすることができます。 既定では、レポートはワークスペースに対して有効になっています。

テストの実行中に機能を管理する

テスト実行に対していずれかの機能、または両方の機能を使用することもできます。

重要

テスト実行で機能を使用できるのは、それがワークスペースに対して有効になっている場合のみです。

  1. Playwright のセットアップで、playwright.service.config.ts ファイルに移動し、これらの設定を機能管理に使用します。
import { getServiceConfig, ServiceOS } from "@azure/microsoft-playwright-testing";
import { defineConfig } from "@playwright/test";
import { AzureCliCredential } from "@azure/identity";
import config from "./playwright.config";

export default defineConfig(
  config,
  getServiceConfig(config, {
    useCloudHostedBrowsers: true, // Select if you want to use cloud-hosted browsers to run your Playwright tests.
  }),
  {
    reporter: [
      ["list"],
      ["@azure/microsoft-playwright-testing/reporter"], //Microsoft Playwright Testing reporter
    ],
  },
);
  • useCloudHostedBrowsers:
    • 説明: この設定では、Playwright テストの実行に、クラウドでホストされているブラウザーを使用するか、クライアント コンピューター上のブラウザーを使用するかを選択できます。 このオプションを無効にすると、クラウドでホストされているブラウザーではなく、クライアント コンピューターのブラウザーでテストが実行され、料金は発生しません。 レポート オプションは引き続き構成できます。
    • 既定値: true
    • 例:
      useCloudHostedBrowsers: true
      
  • reporter
    • 説明: playwright.service.config.ts ファイルにより、セットアップの Playwright 構成ファイルが拡張されます。 このオプションにより既存のレポーターがオーバーライドされ、Microsoft Playwright Testing レポーターが設定されます。 このリストを追加または変更して、使用するレポーターを含めることができます。 @azure/microsoft-playwright-testing/reporter を追加すると、Microsoft Playwright Testing レポートに対して課金されます。 この機能は、クラウドでホストされているブラウザーとは別に使用できます。つまり、Playwright ポータルでレポートや成果物を取得するために、サービス マネージド ブラウザーでテストを実行する必要はありません。
    • 既定値: ["@azure/microsoft-playwright-testing/reporter"]
    • 例:
      reporter: [
      ["list"],
      ["@azure/microsoft-playwright-testing/reporter"]],
      
  1. Playwright のセットアップで、.runsettings ファイルに移動し、これらの設定を機能管理に使用します。
<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
    <TestRunParameters>
        <!--Select if you want to use cloud-hosted browsers to run your Playwright tests.-->
        <Parameter name="UseCloudHostedBrowsers" value="true" />
    </TestRunParameters>
  <!-- NUnit adapter -->  
  .
  .
  .
    <LoggerRunSettings>
        <Loggers>
            <!--microsoft playwright testing service logger for reporting -->
            <Logger friendlyName="microsoft-playwright-testing" enabled="true" />
            <!--could enable any logger additionally -->
            <Logger friendlyName="trx" enabled="false" />
        </Loggers>
    </LoggerRunSettings>
</RunSettings>

  • UseCloudHostedBrowsers

    • 説明: この設定では、Playwright テストの実行に、クラウドでホストされているブラウザーを使用するか、クライアント コンピューター上のブラウザーを使用するかを選択できます。 このオプションを無効にすると、クラウドでホストされているブラウザーではなく、クライアント コンピューターのブラウザーでテストが実行され、料金は発生しません。
    • 既定値: true
    • 例:
      <Parameter name="UseCloudHostedBrowsers" value="true" />
      
  • reporter

    • 説明: microsoft-playwright-testing ロガーを使用して、テスト結果と成果物をサービスに発行できます。 .runsettings からこれを削除するか、false に設定することで、レポートを無効にできます。
    • 既定値: true
    • 例:
      <Logger friendlyName="microsoft-playwright-testing" enabled="true" />