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

Selenium Grid (実験的)

はじめに​

Playwrightは、ローカルマシンでブラウザを実行する代わりに、Selenium 4が実行されているSelenium Grid Hubに接続してGoogle ChromeまたはMicrosoft Edgeブラウザを起動できます。この機能は実験的であり、それに応じて優先順位が付けられていることに注意してください。

警告

将来的にPlaywrightとSelenium Grid Hubの統合が壊れるリスクがあります。使用する前に、リスクとメリットを比較検討してください。

詳細

内部的には、PlaywrightはChrome DevTools Protocol websocketを使用してブラウザに接続します。Selenium 4は現在この機能を提供していますが、将来的にそうではない可能性があります。Seleniumがこの機能を廃止した場合、Playwrightはそれと連携できなくなります。

PlaywrightをSelenium Gridに接続する前に、グリッドがSelenium WebDriverと連携することを確認してください。例えば、いずれかの例を実行し、SELENIUM_REMOTE_URL環境変数を渡します。WebDriverの例が動作しない場合は、Seleniumハブ/ノード/スタンドアロンの出力でエラーを探し、Seleniumの課題で解決策を検索してください。

Selenium Gridの起動​

分散型Selenium Gridを実行している場合、Playwrightがブラウザに接続できるように、Seleniumノードがアクセス可能なアドレスで登録されている必要があります。期待どおりに動作することを確認するには、Seleniumノードの実行時にハブを指すSE_NODE_GRID_URL環境変数を設定します。

# Start selenium node
SE_NODE_GRID_URL="http://<selenium-hub-ip>:4444" java -jar selenium-server-<version>.jar node

PlaywrightをSelenium Gridに接続する​

PlaywrightをSelenium Grid 4に接続するには、Selenium Grid Hubを指すSELENIUM_REMOTE_URL環境変数を設定します。これはGoogle ChromeとMicrosoft Edgeでのみ動作することに注意してください。

SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 dotnet test

コードを変更する必要はありません。通常のテストハーネスまたはBrowserType.LaunchAsync()を使用するだけです。

追加の機能のパス​

グリッドで追加の機能を設定する必要がある場合（例えば、外部サービスを使用している場合）、JSONでシリアル化された機能を提供するためにSELENIUM_REMOTE_CAPABILITIES環境変数を設定できます。

SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 SELENIUM_REMOTE_CAPABILITIES="{'mygrid:options':{os:'windows',username:'John',password:'secure'}}" dotnet test

追加のヘッダーのパス​

グリッドで追加のヘッダーを設定する必要がある場合（例えば、クラウドでブラウザを使用するために承認トークンを提供する必要がある場合）、JSONでシリアル化されたヘッダーを提供するためにSELENIUM_REMOTE_HEADERS環境変数を設定できます。

SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 SELENIUM_REMOTE_HEADERS="{'Authorization':'Basic b64enc'}" dotnet test

詳細なログ​

PlaywrightがSelenium Gridにどのように接続しているかを確認するには、DEBUG=pw:browser*環境変数を使用して実行してください。

DEBUG=pw:browser* SELENIUM_REMOTE_URL=http://internal.grid:4444 dotnet test

問題を提出する場合は、このログを含めてください。

Selenium Dockerの使用​

Selenium Gridを使用する簡単な方法の1つは、公式のDockerコンテナを実行することです。Selenium Dockerイメージのドキュメントで詳細を読むことができます。イメージのタグ付け規則については、詳細はこちらをご覧ください。

スタンドアロンモード​

以下は、Seleniumスタンドアロンを実行し、Playwrightをそれに接続する例です。ハブとノードが同じlocalhost上にあり、それを指すSE_NODE_GRID_URL環境変数を渡していることに注意してください。

まずSeleniumを起動します。

docker run -d -p 4444:4444 --shm-size="2g" -e SE_NODE_GRID_URL="https://:4444" selenium/standalone-chromium:latest

次にPlaywrightを実行します。

SELENIUM_REMOTE_URL=https://:4444 dotnet test

ハブとノードモード​

以下は、Seleniumハブと単一のSeleniumノードを実行し、Playwrightをハブに接続する例です。ハブとノードが異なるIPを持ち、ノードコンテナを起動する際にハブを指すSE_NODE_GRID_URL環境変数を渡していることに注意してください。

まずハブコンテナと1つ以上のノードコンテナを起動します。

docker run -d -p 4442-4444:4442-4444 --name selenium-hub selenium/hub:4.25.0
docker run -d -p 5555:5555 \
    --shm-size="2g" \
    -e SE_EVENT_BUS_HOST=<selenium-hub-ip> \
    -e SE_EVENT_BUS_PUBLISH_PORT=4442 \
    -e SE_EVENT_BUS_SUBSCRIBE_PORT=4443 \
    -e SE_NODE_GRID_URL="http://<selenium-hub-ip>:4444"
    selenium/node-chromium:4.25.0

次にPlaywrightを実行します。

SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 dotnet test

Selenium 3​

内部的には、PlaywrightはChrome DevTools Protocol websocketを使用してブラウザに接続します。Selenium 4はこの機能を提供しますが、Selenium 3は提供しません。

これは、Selenium 3がベストエフォート方式でサポートされ、Playwrightがグリッドノードに直接接続しようとすることを意味します。グリッドノードは、Playwrightを実行するマシンから直接アクセスできる必要があります。