跳到主要內容

Selenium Grid (實驗性)

簡介​

Playwright 可以連接到 Selenium Grid Hub，後者運行 Selenium 4 以啟動 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 hub/node/standalone 輸出中尋找任何錯誤，並在 Selenium issues 中搜尋可能的解決方案。

啟動 Selenium Grid​

如果您運行分散式 Selenium Grid，Playwright 需要將 Selenium 節點註冊到可存取的位址，以便它可以連接到瀏覽器。為了確保它能如預期般運作，請在運行 selenium 節點時設定指向 hub 的 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 pytest --browser chromium

您不必更改程式碼，只需像往常一樣使用您的測試工具或 browser_type.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'}}" pytest --browser chromium

傳遞其他標頭​

如果您的 Grid 需要設定其他標頭 (例如，您應該提供授權令牌以在您的雲端中使用瀏覽器)，您可以設定 SELENIUM_REMOTE_HEADERS 環境變數以提供 JSON 序列化的標頭。

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

詳細日誌​

使用 DEBUG=pw:browser* 環境變數執行以查看 Playwright 如何連接到 Selenium Grid。

DEBUG=pw:browser* SELENIUM_REMOTE_URL=http://internal.grid:4444 pytest --browser chromium

如果您提交問題，請包含此日誌。

使用 Selenium Docker​

使用 Selenium Grid 的一種簡單方法是運行官方 Docker 容器。在 selenium docker images 文件中閱讀更多內容。有關映像標記約定，請閱讀更多內容。

獨立模式​

這裡是一個運行 Selenium 獨立模式並將 Playwright 連接到它的範例。請注意，hub 和 node 位於相同的 localhost 上，並且我們傳遞指向它的 SE_NODE_GRID_URL 環境變數。

首先啟動 Selenium。

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

然後運行 Playwright。

SELENIUM_REMOTE_URL=https://127.0.0.1:4444 pytest --browser chromium

Hub 和節點模式​

這裡是一個運行 Selenium Hub 和單個 Selenium 節點，並將 Playwright 連接到 Hub 的範例。請注意，hub 和 node 具有不同的 IP，並且我們在啟動節點容器時傳遞指向 hub 的 SE_NODE_GRID_URL 環境變數。

首先啟動 Hub 容器和一個或多個節點容器。

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 pytest --browser chromium

Selenium 3​

在內部，Playwright 使用 Chrome DevTools Protocol websocket 連接到瀏覽器。Selenium 4 公開了此功能，而 Selenium 3 沒有。

這表示 Selenium 3 以盡力而為的方式支援，其中 Playwright 嘗試直接連接到 Grid 節點。Grid 節點必須可從運行 Playwright 的機器直接存取。