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

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で動作することを確認してください。例えば、例の1つを実行し、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に接続する​

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

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

コードを変更する必要はなく、通常通りテストハーネスまたはbrowserType.launch()を使用するだけです。

追加の機能(capabilities)を渡す​

Gridに追加の機能(capabilities)を設定する必要がある場合 (例えば、外部サービスを使用する場合)、JSONにシリアライズされた機能を指定するためにSELENIUM_REMOTE_CAPABILITIES環境変数を設定できます。

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

追加のヘッダーを渡す​

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

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

詳細ログ​

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

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

Selenium 3​

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

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