Azure Playwright プレビュー

2025-07-01

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

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

役に立つリンク

クイックスタート: 大規模なでエンドツーエンドのテストを実行する
クイックスタート: さまざまなブラウザーとオペレーティングシステムでエンドツーエンドの継続的なテストを設定する
の機能と利点を調べる
ドキュメント
料金
フィードバックの共有

開始する

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

[前提条件]

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

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

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

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

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

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

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

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

このコマンドを実行してサービスパッケージをインストールする
```
npm init @azure/playwright
```

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

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

Playwright を Azure Playwright サービスに誘導して認証します。
必要に応じて、サービス操作のタイムアウトをオーバーライドします。

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

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

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

認証を設定する

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

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

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> を使用してサインインします

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

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

アクセストークンベースの認証を使用するには、アクセストークンベースの認証を有効にする
アクセストークンを使用して認証を設定

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

手記：CI パイプラインで Azure Playwright を使用するには、パイプラインからサービスを使用して認証を構成する必要があります (「さまざまなブラウザーやオペレーティングシステム間で継続的なエンドツーエンドテストを設定する」を参照してください)

テストの実行

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

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

次のステップ

CI/CD パイプラインでテストを実行します。
作成したワークスペースへのアクセス管理する方法について説明します。
さまざまな数のワーカーを試して、テストスイートの最適な構成決定します。

投稿

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

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

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

商標

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