跳到主要內容

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 dotnet test

您不必更改程式碼，只需像往常一樣使用您的測試工具或 BrowserType.LaunchAsync()。

傳遞額外功能​

如果您的 grid 需要設定額外功能（例如，您使用外部服務），您可以設定 SELENIUM_REMOTE_CAPABILITIES 環境變數以提供 JSON 序列化的功能。

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

傳遞額外標頭​

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

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

詳細日誌​

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

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

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

使用 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 dotnet test

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 dotnet test

Selenium 3​

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

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