Playwright のテスト オートメーション

Playwright のオートメーションを Test Manager のオートメーションの種類として、Studio で作成されたオートメーションとともに使用します。Studio で既存のテスト スイートを書き換えることはありません。

注:

この機能は管理された可用性であり、対象となるテナントにのみ提供されます。Test Cloud 経由で提供される Test Manager でのみ利用できます。動作するには、UiPath がテナントに対して有効化する必要があります。有効化をリクエストするには、テナントの詳細を添えて UiPath のアカウント チームにお問い合わせください。

Test Manager は、Studio が作成した (ロボット) のオートメーションに加えて、 Playwright のオートメーションを利用したテスト ケースも実行できます。すでに Playwright でエンドツーエンドのテストを記述しているチームは、Studio でテストを書き直すことなく、オーケストレーション、スケジュール設定、レポート、トレーサビリティのためにこれらのテストを Test Manager に取り込むことができます。

前提条件

Playwright のオートメーションを Test Manager から実行するには、まず実行に使用されるロボット アカウント (サーバーレス テスト用に設定された Unattended ロボット アカウントなど) を、[ プロジェクト設定] で Test Manager プロジェクトに追加し、 Test Executor ロールを設定する必要があります。Automation Users グループのメンバーシップだけでは、これは付与されません。Test Executor ロールがなくても、テストは実行および完了しますが、結果は Test Manager に到達しません。すべてのテスト ケースの実行は None の結果とログ エントリで終了するためです。

Playwright test execution faulted before results could be uploaded.

{
  "Code": "Serverless.PlaywrightTest.ResultUploadFailed",
  "Title": "Failed to upload Playwright results to Test Manager",
  "Detail": "The tests ran but an artifact upload URL could not be obtained from Test Manager, so the results were never uploaded. Check that Test Manager is reachable from the pod and the execution context is complete. The execution will be reconciled, but per-test results may be missing."
}

Playwright の自動化の仕組み

Playwright のテスト プロジェクトは、UiPath の外部にある独自のソース管理システムに存在します。そこから、オートメーションは以下のフローで Test Manager に到達します。

1. プロジェクトは、UiPath コマンド ライン インターフェイス (CLI) の tm pack コマンドを使用して UiPath オートメーション パッケージにパッケージ化され、Orchestrator の テナント全体のグローバル パッケージ フィードまたはフォルダー レベルの専用フィードにパブリッシュされます。パッケージ化の手順については、「 Test Manager 用の Playwright プロジェクトをパッケージ化する」をご覧ください。
2. パブリッシュされたパッケージは、Studio でパブリッシュされたオートメーションと同じように、オート メーションの選択 フローを通じて Test Manager で選択できるようになります。
3. パッケージが Test Manager プロジェクト キーを使用して構築された場合、一致するテスト ケースが自動作成され、Test Manager がパッケージを取り込むと、Playwright のオートメーションが各テスト ケースに自動リンクされます。それ以外の場合は、テスト ケースは個別に作成され、Studio のオートメーションの場合と同じフローを使用して、オートメーションが手動でリンクされます。
4. それ以降、テスト ケースは Test Manager の他の自動化されたテスト ケースと同様に動作します。つまり、テスト セットに配置したり、オンデマンドまたはスケジュールに従ってトリガーしたり、結果、成果物、およびトレーサビリティのリンクが他のすべてのテスト ケースとともに表示されます。

Test Manager が Playwright プロジェクトからキャプチャする内容

[Test Manager] フィールド	Playwright から来る
名前 &; 説明	テスト タイトルのみ。パッケージのメタデータには [説明] フィールドがないため、[説明] には入力されません。
ラベル	@tag / アノテーション値 (例: resilience、 observability)、フィルター処理およびテスト セットのスコープ設定用のラベルとしてテスト ケースにコピーされます。
プロジェクト/仕様ファイル	テストが属する Playwright プロジェクト ( playwright.config.tsから) と仕様ファイル。メタデータとしてキャプチャされます。テストごとに 1 つのテスト ケースが作成され、プロジェクトごとに展開はありません。
ソース ([オートメーションを選択] タブ)	[オートメーションを選択] ピッカーに表示される Playwright または UiPath のソースの値。

注:

[名前と説明]、[ラベル]、および [プロジェクト/仕様書ファイル] はすべて、自動生成されたシステム ラベルとしてテスト ケースに実装されます。[ソース] は独立したフィールドであり、[オートメーションを選択] ピッカーにはラベルとしてではなく独自の列として表示されます。

用語

• オートメーションとテスト ケースは、Test Manager では依然として別個の種類の成果物です。
• オートメーション (Playwright または Studio) がテスト ケースに割り当てられる。
• Playwright のテストは、それ自体がテスト ケースと呼ばれることはありません。

実行とレポートのパリティ

割り当てが完了すると、Playwright が支援するテスト ケースは、Studio で作成されたテスト ケースとまったく同じように実行、スケジュール設定、レポートされます。つまり、同じトリガー、同じテスト セットのメンバーシップ ルール、同じ結果、トレーサビリティ ビューが表示されます。

既知の制限事項

制限事項	意味
Chromium のみ	実行ポッドは Chromium のみをインストールします。Firefox または WebKit を使用するように設定されたプロジェクトは引き続き選択できますが、そのブラウザーでは実行が実行されません。
サーバーレス実行のみ	Playwright のテストは UiPath サーバーレス インフラストラクチャでのみ実行され、実行ごとに専用のポッドが使用されます。オンプレミスまたはローカルのロボットの実行はまだサポートされていません。
Node.js (JavaScript/TypeScript) のみ	Node.jsベースのみ Playwright プロジェクトがサポートされています。playwright-python、 playwright-java、 playwright-dotnet のプロジェクトはサポートされていません。
自己完結型プロジェクトが必要です。	各プロジェクトは自己完結型ディレクトリからパッケージ化し、依存関係はパックされたルートで解決可能である必要があります。mono-repo サブフォルダーは、自己完結型の場合にのみ機能します。
アサーション レベルの詳細がない	Test Manager は Playwright のアサーションを個別に公開しません。これは、Playwright 独自の試行ごとの成功/失敗の結果と設定された添付ファイルに依存します。
外部で実行された結果のインポートなし	Test Manager の外部で実行される Playwright スイートの結果 (顧客自身の CI など) はインポートできません。
1 つの実行につき 1 つのジョブ	1 つの Playwright テスト セット実行に含まれるすべてのテスト ケースは 1 つの Orchestrator ジョブ内で実行されます。テスト セットのサイズが大きすぎると、ジョブがタイムアウトするリスクがあります。
実行時間の制限	Playwright のテスト セットの実行には 45 分の時間制限があります。これは、Test Manager の他の場所で適用されるビデオ録画の時間制限とは別です。
マルチポッド シャーディングなし	スイート全体は、1 回の実行につき 1 つのポッドで実行されます。Playwright 独自のワーカー並列処理は設定どおりに適用されますが、ポッド間での分散シャーディングはまだ利用できません。
フィクスチャーごとのレポートなし	Playwright の備品 (test.extend()) は正常に動作しますが、Test Manager はテスト ケース レベルまたは備品ごとのレポートを使用してモデル化しません。
自己修復機能はありません。	エージェンティック自己修復機能は、Playwright のオートメーションではまだ利用できません。
強制的な実行順序はありません	テスト ケースの順序は playwright.config.tsに従います。Playwright のテスト セットで [ 実行順序を適用]、[ RPA アクティビティ カバレッジ]、または [ Healing Agent ] を有効化すると、実行がすぐに失敗します。
パッケージ間またはバージョン間の混在は禁止されています	1 つのテスト セット内で 2 つの異なる Playwright パッケージのテスト ケース、または 2 つの異なるバージョンの同じパッケージのテスト ケースを混在させることはブロックされます。
データ ドリブンなテスト セットですべてのバリエーションが実行されます	パラメーター化された Playwright テストの各バリエーションは、それ自体のテスト ケースです。1 つのバリエーションを実行すると、その行のすべてのバリエーションが実行されます。
UiPath のビデオ録画やライブ ストリーミングは利用できません	Playwright のテスト セットで ビデオ録画 を有効化しても効果はなく、[ 録画 ] タブとライブ ストリーミング アクションにデータが表示されません。Playwright自身のビデオキャプチャ(playwright.config.tsのuse: { video })は影響を受けず、これらの.webmファイルは引き続きアーティファクトとして添付されます。

独立した test() 呼び出しとして定義されたテスト ケースは、それぞれが独自の行に属しており、独立して動作します。トレース ビューアーには各バリエーション自体の結果が表示され、実行ログにはすべてのバリエーションが実行済みとして表示されます。

ライセンス

Test Manager を介して Playwright のテストを実行すると、基になるロボット実行レベルでは、他のサーバーレス テスト実行と同じプラットフォーム容量が消費されます。Playwright とネイティブの UiPath テスト オートメーションの使用率に違いはありません。詳しくは、「 ユニファイド プライシング: Test Manager のライセンス」をご覧ください。

関連

• Playwright のアーティファクト キャプチャの仕組み
• Test Manager 用の Playwright プロジェクトをパッケージ化する
• Playwright のテスト用の成果物キャプチャの構成
• オートメーションを選択する