Tray icon and REPL for trying out Browser Library keywords using Chromium or Edge
Project description
robotframework-browser-tray
Tray icon and REPL for trying out Browser Library keywords using Chromium or Edge
Requirements
- NodeJS >= 18
- Windows
Use Cases
-
Execute tests incrementally using e.g. RobotCode
-
Test selectors in an open web page interactively
How to use it
- Install the package
pip install robotframework-browser-tray
- Execute
browser-tray
Hint: In case your environment does not allow executing browser-tray, call the Python module directly:
python -m BrowserTray
-
Click on the tray icon with the Chromium logo
-
Open a Terminal and execute
ibrowser
Hint: In case your environment does not allow executing ibrowser, call the Python module directly:
python -m BrowserTray.Repl
ibrowser
ibrowser allows testing selectors in an open web page interactively.
To start it execute:
ibrowser
On start up it connects to a running Chromium (started using the tray icon) or Microsoft Edge (see below for instructions).
If you start a new browser while ibrowser is running, call the keyword "Connect" to connect ibrowser to it.
To exit ibrowser press Ctrl-D
.
Usage in a Robot Framework Test Suite
Add these lines to the Settings section of the .robot file:
Library Browser playwright_process_port=4711
Test Setup Connect To Browser http://localhost:1234 chromium use_cdp=True
In order to use other ports execute:
browser-tray --pw-port=XXXX --cdp-port=XXXX
Using Microsoft Edge
If Microsoft Edge is installed on your machine:
- Create a Shortcut to msedge.exe with the target:
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=1234 --user-data-dir=C:\Users\YOUR_USER\RFEdgeProfile
-
Start Edge using this shortcut
-
Execute
ibrowser
How it works
On start up browser-tray
checks whether rfbrowser init
has been executed.
If this requirement is met the Playwright wrapper is started with node site-packages/Browser/wrapper/index.js 4711
.
Selecting "Open Chromium" in the tray icon executes site-packages/Browser/wrapper/node_modules/playwright-core/.local-browsers/chromium-XX/chrome-win/chrome.exe --remote-debugging-port=1234 --test-type
.
ibrowser
is a batteries-included irobot that saves time by importing Browser Library and connecting to a running Chromium or Edge.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for robotframework_browser_tray-1.5.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d087485fe5d334d64bf8d3d49ce7a4af1ae187bc20c1cef11caae661398736ee |
|
MD5 | 7e10f17204c7e4546cb7889c883b24c6 |
|
BLAKE2b-256 | 4501046bac0efb3ec68e4e97f21c0831c7f0d85585342946507c880190eeee02 |
Hashes for robotframework_browser_tray-1.5.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d2cb044422a058a75b7de64557d9c154dd8cc6bb9c0b52f9efc1d5931d1d95d |
|
MD5 | 0b054ae6b3885e711d6e387b16fbd936 |
|
BLAKE2b-256 | aea8dbc55c332325299eec8ace6a3472707fef642aa2f763a00a84705df76684 |