Filip/playwright
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

docs: add Selenium Grid integration (#9582)

Browse source
This commit is contained in:
Dmitry Gozman 2021-10-18 11:24:30 -07:00 committed by GitHub
parent 22fe1662c0
commit 7a4e799968
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 38 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
docs/src/selenium-grid.md Normal file
View file

@ -0,0 +1,38 @@
---
id: selenium-grid
title: "Selenium Grid"
---
Playwright can connect to [Selenium Grid Hub](https://www.selenium.dev/documentation/grid/) to launch **Chrome** browser, instead of running browser on the local machine. To enable this mode, set `SELENIUM_REMOTE_URL` environment variable pointing to your Selenium Grid Hub.
```bash js
# Playwright Test
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub npx playwright test
# Playwright Library
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub node script.js
```
```bash python
# With Pytest
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub pytest --browser chromium
# Plain Python
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub python script.py
```
```bash java
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub mvn test
```
```bash csharp
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub dotnet test
```
You don't have to change your code, just use [`method: BrowserType.launch`] as usual.
When using Selenium Grid Hub, you can [skip browser downloads](./browsers.md#skip-browser-downloads).
:::note
Internally, Playwright connects to the browser using [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) websocket. This requires Selenium Grid nodes to be directly accessible from the machine that runs Playwright.
:::