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

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に接続する前に、GridがSelenium WebDriverで動作することを確認してください。例えば、いずれかの例を実行し、SELENIUM_REMOTE_URL環境変数を渡してみてください。WebDriverの例が動作しない場合は、Seleniumハブ/ノード/スタンドアロンの出力でエラーを探し、SeleniumのIssueを検索して解決策を見つけてください。

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に接続する​

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

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

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

追加の機能の受け渡し​

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

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

追加のヘッダーの受け渡し​

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

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

詳細なログ​

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

DEBUG=pw:browser* SELENIUM_REMOTE_URL=http://internal.grid:4444 mvn 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 mvn 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 mvn test

Selenium 3​

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

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