Skip to main content
Version: 1.18

Selenium Grid

Playwright can connect to Selenium Grid Hub that runs Selenium 4 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.

# 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

You don't have to change your code, just use browser_type.launch(**kwargs) as usual.

When using Selenium Grid Hub, you can skip browser downloads.

If your grid requires additional capabilities to be set (for example, you use an external service), you can use SELENIUM_REMOTE_CAPABILITIES environment variable to provide JSON-serialized capabilities.

# With Pytest
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub SELENIUM_REMOTE_CAPABILITIES="{'mygrid:options':{os:'windows',username:'John',password:'secure'}}" pytest --browser chromium

# Plain Python
SELENIUM_REMOTE_URL=http://internal.grid:4444/wd/hub SELENIUM_REMOTE_CAPABILITIES="{'mygrid:options':{os:'windows',username:'John',password:'secure'}}" python script.py
note

Internally, Playwright connects to the browser using Chrome DevTools Protocol websocket. Selenium 4 hub exposes this capability. Selenium 3 is supported in a best-effort manner. Grid nodes must be directly accessible from the machine that runs Playwright.