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 Hub/Node/Standalone 输出中的任何错误,并在 Selenium issues 中搜索可能的解决方案。
启动 Selenium Grid
如果您运行分布式 Selenium Grid,Playwright 需要 Selenium 节点以可访问的地址注册,以便它可以连接到浏览器。为了确保它按预期工作,在运行 Selenium 节点时设置 SE_NODE_GRID_URL
环境变量指向 Hub。
# 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_REMOTE_URL
环境变量指向您的 Selenium Grid Hub。请注意,这仅适用于 Google Chrome 和 Microsoft Edge。
SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 npx playwright 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'}}" npx playwright test
传递附加请求头
如果您的 Grid 需要设置附加请求头(例如,您应该提供授权令牌以在云中使用浏览器),您可以设置 SELENIUM_REMOTE_HEADERS
环境变量以提供 JSON 序列化的请求头。
SELENIUM_REMOTE_URL=http://<selenium-hub-ip>:4444 SELENIUM_REMOTE_HEADERS="{'Authorization':'Basic b64enc'}" npx playwright test
详细日志
运行 DEBUG=pw:browser*
环境变量以查看 Playwright 如何连接到 Selenium Grid。
DEBUG=pw:browser* SELENIUM_REMOTE_URL=http://internal.grid:4444 npx playwright test
如果您提交问题,请包含此日志。
使用 Selenium Docker
使用 Selenium Grid 的一种简单方法是运行官方 Docker 容器。在 Selenium Docker 镜像 文档中阅读更多信息。有关镜像标签约定,请阅读更多。
独立模式
这是一个运行 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://:4444" selenium/standalone-chromium:latest
然后运行 Playwright。
SELENIUM_REMOTE_URL=https://:4444 npx playwright test
Hub 和 Node 模式
这是一个运行 Selenium Hub 和单个 Selenium Node 并将 Playwright 连接到 Hub 的示例。请注意,Hub 和 Node 具有不同的 IP,并且在启动 Node 容器时,我们传递 SE_NODE_GRID_URL
环境变量指向 Hub。
首先启动 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 npx playwright test
Selenium 3
在内部,Playwright 使用 Chrome DevTools Protocol websocket 连接到浏览器。Selenium 4 暴露了此功能,而 Selenium 3 没有。
这意味着 Selenium 3 以尽力而为的方式支持,Playwright 尝试直接连接到 Grid 节点。Grid 节点必须可以直接从运行 Playwright 的机器访问。