The purpose is to provide a python client to connect to the debugger tools of a web-browser.
Currently supports connecting to Google-Chrome/Chromium over the devtools protocol, via a wrapped websockets client. Feel free to extend and add support for other browsers as required.
For improved performance, install the wsaccel python lib https://pypi.org/project/wsaccel/
Start Google-Chrome, passing a remote debugger port argument, for example on Ubuntu:
$ google-chrome-stable --remote-debugging-port=9899
In a python console, you can connect to the remote debugging port and enable the Page domain.
>> devtools_client = ChromeInterface(9899, domains={"Page": {}})
The client provides some devtools interface methods, for example:
>> with devtools_client.set_timeout(10):
... devtools_client.take_screenshot("/tmp/screenshot.png")
Or more generally you can call remote methods according to the devtools protocol spec (https://chromedevtools.github.io/devtools-protocol/tot/Network), for example
>> devtools_client.execute(domain="Network", method="enable")
>> devtools_client.execute("Network", "setUserAgentOverride", {"userAgent": "Test"})
The test.sh script makes running tests easier, it will create containers with the required
environment; and run a virtual display for the E2E tests.
It takes a single argument which is a pytest expression to run a subset of tests, for example:
./test.sh e2etests/chrome/test_interface.py::TestSwitchTabHeaded::test_switch_tab_headed