Robot Framework Browser library powered by Playwright. Aiming for speed, reliability and visibility.
Project description
robotframework-browser
Robot Framework Browser library powered by Playwright. Moving browser automation to year 2021!
Aiming for :rocket: speed, :white_check_mark: reliability and :microscope: visibility.
See keyword documentation and web page for more details.
Installation instructions
Only Python 3.7 or newer is supported.
- Install node.js e.g. from https://nodejs.org/en/download/ (only < v15 supported; if unsure, use 14.15.0 LTS)
- Update pip
pip install -U pipto ensure latest version is used - Install robotframework-browser from the commandline:
pip install robotframework-browser - Install the node dependencies: run
rfbrowser initin your shell
- if
rfbrowseris not found, trypython -m Browser.entry init
Please note that by default Chromium, Firefox and WebKit browser are installed, even those would be already
installed in the system. The installation size depends on the operating system, but usually is +700Mb.
It is possible to skip browser binaries installation with rfbrowser init --skip-browsers command, but then user
is responsible for browser binary installation.
Or use the docker images. Documented at docker/README.md.
Update instructions
To upgrade your already installed robotframework-browser library
- Update from commandline:
pip install -U robotframework-browser - Clean old node side dependencies and browser binaries:
rfbrowser clean-node - Install the node dependencies for the newly installed version:
rfbrowser init
Uninstall instructions
To completely install library, including the browser binaries installed by Playwright, run following commands:
- Clean old node side dependencies and browser binaries:
rfbrowser clean-node - Uninstall with pip:
pip uninstall robotframework-browser
Examples
Testing with Robot Framework
*** Settings ***
Library Browser
*** Test Cases ***
Example Test
New Page https://playwright.dev
Get Text h1 contains Playwright
and testing with Python.
import Browser
browser = Browser.Browser()
browser.new_page("https://playwright.dev")
assert 'Playwright' in browser.get_text("h1")
browser.close_browser()
and extending with JavaScript
async function myGoToKeyword(page, args) {
return await page.goto(args[0]);
}
exports.__esModule = true;
exports.myGoToKeyword = myGoToKeyword;
*** Settings ***
Library Browser jsextension=${CURDIR}/mymodule.js
*** Test Cases ***
Example Test
New Page
myGoToKeyword https://www.robotframework.org
Ready made extensions and a place to share your own at robotframework-browser-extensions.
Ergonomic selector syntax, supports chaining of text, css and xpath selectors
# Select element containing text "Login" with text selector strategy
# and select it's parent `input` element with xpath
Click "Login" >> xpath=../input
# Select element with CSS strategy and select button in it with text strategy
Click div.dialog >> "Ok"
Evaluate in browser page
New Page ${LOGIN_URL}
${ref}= Get Element h1
Get Property ${ref} innerText == Login Page
Execute JavaScript (elem) => elem.innerText = "abc" ${ref}
Get Property ${ref} innerText == abc
Asynchronously waiting for HTTP requests and responses
# The button with id `delayed_request` fires a delayed request. We use a promise to capture it.
${promise}= Promise To Wait For Response matcher= timeout=3s
Click \#delayed_request
${body}= Wait For ${promise}
Device Descriptors
${device}= Get Device iPhone X
New Context &{device}
New Page
Get Viewport Size # returns { "width": 375, "height": 812 }
Sending HTTP requests and parsing their responses
&{response}= HTTP /api/post POST {"name": "John"}
Should Be Equal ${response.status} ${200}
Development
See CONTRIBUTING.md for development instructions.
Core team
In order of appearance.
- Mikko Korpela
- Tatu Aalto
- Janne Hรคrkรถnen (Alumnus)
- Kerkko Pelttari
- Renรฉ Rohner
Contributors
This project is community driven and becomes a reality only through the work of all the people who contribute. Supported by Robocorp through Robot Framework Foundation.
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-10.1.0.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8424fc1f323a4ba51071e6016cdbe23bdfc147c5030aa3a81cc886cd6a68c583 |
|
| MD5 | c1d4032121884b8fca9fc7711fba7286 |
|
| BLAKE2b-256 | bfa20fa65e7b4d739e8050c3b57f919c58631ed59fffe114e1815723f312acbf |
Hashes for robotframework_browser-10.1.0-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9399ef025e06567f5db7354354e551c8bef8e611521c13476e40b2bf0184f965 |
|
| MD5 | 66b1a8439401f0bdbd8a8a255ca5e6f2 |
|
| BLAKE2b-256 | 1c26147424ee5238d8c270c7faf7301e94c15af8eaed1e49ef68c36b97becc6c |
