robotframework-browser 18.8.0

Description:

robotframeworkbrowser 18.8.0

robotframework-browser







Robot Framework Browser library powered by Playwright. Moving browser automation to year 2023!
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.8 or newer is supported. From Node side 18 and 20 LTS versions are supported.

Install node.js e.g. from https://nodejs.org/en/download/
Update pip pip install -U pip to ensure latest version is used
Install robotframework-browser from the commandline: pip install robotframework-browser
Install the node dependencies: run rfbrowser init in your shell


if rfbrowser is not found, try python -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. It is possible to install only selected browser binaries by adding
chromium, firefox or webkit as arguments to init command. Example rfbrowser init firefox would install
only Firefox binaries and rfbrowser init firefox chromium would install both Firefox and Chromium binaries.
Or use the docker images. Documented at docker/README.md.
Install with transformer
Starting from release 18.3.0 Browser library has optional dependency with
Robotidy. Install library with Robotidy, run install with:
pip install robotframework-browser[tidy]. Starting from 18.3.0 release, library will provide external
Robotidy transformer. Transformer provided
by Browser library can be run with command: rfbrowser transform --transformer-name /path/to/tests. Example:
rfbrowser transform --wait-until-network-is-idle /path/to/tests would transform deprecated Wait Until Network Is Idle
keyword to Wait For Load State keyword. To see full list of transformers provided by Browser library, run
command: rfbrowser transform --help.
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 uninstall 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(url, page, logger) {
logger("Going to " + url)
return await page.goto(url);
}
myGoToKeyword.rfdoc = "This is my own go to keyword";
exports.__esModule = true;
exports.myGoToKeyword = myGoToKeyword;

*** Settings ***
Library Browser jsextension=${CURDIR}/mymodule.js

*** Test Cases ***
Example Test
New Page
myGoToKeyword https://www.robotframework.org

See example.
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
Evaluate JavaScript ${ref} (elem) => elem.innerText = "abc"
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}

Parallel test execution using Pabot
You can let RF Browser spawn separate processes for every pabot process. This is very simple, just run the tests normally using pabot (see https://github.com/mkorpela/pabot#basic-use ). However if you have small tests do not use --testlevelsplit, it will cause lots of overhead because tests cannot share the browsers in any case.
You can share the node side RF Browser processes by using the ROBOT_FRAMEWORK_BROWSER_NODE_PORT environment variable, and from Browser.utils import spawn_node_process helper (see the docs for the helper ). This saves some overhead based on how many splits of tests you are running. Clean up the process afterwards.
Re-using authentication credentials

Figure out how the page is storing authentication
If it is localstorage or cookies Save Storage State should work. See usage example: https://marketsquare.github.io/robotframework-browser/Browser.html#Save%20Storage%20State

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.






Mikko Korpela💻
Tatu Aalto💻
Antti Karjalainen🔍
Ismo Aro🔍
Janne Härkönen💻
Kerkko Pelttari💻
Robocorp💵


René💻
Bryan Oakley🤔
Tanakiat Srisaranyakul🤔
Maaret Pyhäjärvi📓
Karlo Smid📓
Frank Schimmel📓
Christoph⚠️


Mika Hänninen💬
imbus💵
Niklas📖
gdroes⚠️
Reaktor💵
Adrian Yorke📖 👀
Nanakawa⚠️


Ed Manlove📖 🐛
Brian Tsao🐛 📓
charis💻 🐛
s-galante🐛
Simon Meggle📓 🐛 ⚠️ 🤔
Anna-Gunda🐛
anton264📓


emakaay🐛
Nea Ohvo🐛
Elout van Leeuwen📖 🤔 💻
LDerikx📖
olga-📖 🐛
Nicholas Bollweg📖
Ville Salonen🐛


Jani Mikkonen🐛 📖
Aleh Borysiewicz🐛
Jürgen Knauth🐛
dalaakso🐛
msirkka🤔
Ossi R.💻
Adrian V.💻 🐛 🤔


Sami Sallmén🐛 ⚠️
Pekka Klärck💻 🐛
Jani Palsamäki🐛
AllanMedeiros🐛
Emmanuel Alap🐛 💻
ankurbhalla-gmail🤔
UliSei🤔 🐛 💻 📓


Tomasz Pawlak🐛
mtoskamp🐛
zastress🐛
Juga Paazmaya💻
Raphael Smadja🤔 💻 🐛
Antti Pakkanen🐛
Luis A Gomez-Tinoco🐛 💡 💻


ePlanLori🐛
laguna357🐛
Gavin Rodgers🐛
pokaalinkanssayohon🤔
Ryan Sandbach🐛 💻
Niko Kahilainen🐛
Guillaume Gautier📖


Robin Matz🤔
Stavros Ntentos📖
Massukio🐛 🤔
Atihinen🐛
gvrkumar🤔
Lauri Helkkula🐛
rlall07🐛 🤔


Eldad Uzman🤔
mgarcibu🐛
DominikG🤔
jokinr⚠️ 🐛
Jier Chen💻
IDvoe🐛
Cosmin Poieana🐛


Shenthil🐛
Marduk Bolaños🐛 🤔
amodzelewski🐛
TimDicos🐛
vinismarques🐛
nizwiz🐛
Reddriver🤔


Seppo🐛
rousku🐛
tomaspekarovic🤔
Robin Mackaij🐛
nixuewei🤔
Slava🤔 🐛 💻
Kari Harju🐛


you🐛
axiom41🐛
amankul🐛
jcb-entrnce🐛
Remppa🐛
Tomasz Pawlak🐛
Timo Stordell🐛


Marcin Gmurczyk💻
Daniel Biehl🐛 🤔
rarajabs🐛
Sandeep Vaidya🤔
falk📖
ciadoh🐛
Johan van Iperen💻


Fabio Zadrozny🐛
BCGST📖
Wilfried van Asten🐛 💻
Mikal H Henriksen🐛
alexinoDr🐛
trybuskrzysztof🐛
Aino1980🐛


BjornAhmark🐛
Mezohren🐛
Zoupers Zou🤔
lasselindqvist🐛
David Nieto Sanz🐛
Gil Forcada Codinachs📖 🐛
Nathan Hannig🐛


Martin Kjellstrand🐛
Anton Medvedev💻
martamedovova-ext91522🐛 🤔
Dr. Dirk Richter🤔
RatexMak🤔
horzuff💻
naibra🐛


Antti Pekka Vilkko🐛
Serafín Martín🐛
JoostW21111🐛
Camatius🐛
terckert🐛
Maksim Bondarew🐛
HenrikSchuette🐛


Gurunatharudh Bhandarkavathe(Infosys)🐛
alpip1997🐛
terolindfors🐛
Thisara Wijesundera🤔
masudparvez🤔
gitkatsi🐛 💻
Many Kasiriha🐛


Thulasi Raju📖
Giancarlo Soverini🤔
lennartq💻
Lukas Boekenoogen📖
anacomparada🐛 📖
siongwai🤔
nfaustin🐛


Guido Schmitz💻
Chris Nesbitt-Smith💻
vmmattila🐛
Andre-A-AtGithub🐛
Paweł🐛