跳到主要內容

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 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 的一種簡單方法是運行官方 docker 容器。請在 selenium docker images 文件中閱讀更多資訊。有關映像標記慣例，請閱讀更多資訊。

獨立模式​

以下是運行 selenium standalone 並將 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 mvn test

Hub 和 nodes 模式​

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

首先啟動 hub 容器和一個或多個 node 容器。

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 的機器直接訪問。