Skip to content

Leemur89/robotframework-browser

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

robotframework-browser

All Contributors

Version Actions Status License


Robot Framework Browser library powered by Playwright. Moving browser automation to year 2021!

Aiming for πŸš€ speed, βœ… reliability and πŸ”¬ visibility.

See keyword documentation and web page for more details.

Installation instructions

Only Python 3.7 or newer is supported.

  1. Install node.js e.g. from https://nodejs.org/en/download/ (only < v15 supported; if unsure, use 14.15.0 LTS)
  2. Update pip pip install -U pip to ensure latest version is used
  3. Install robotframework-browser from the commandline: pip install robotframework-browser
  4. 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.

Or use the docker images. Documented at docker/README.md.

Update instructions

To upgrade your already installed robotframework-browser library

  1. Update from commandline: pip install -U robotframework-browser
  2. Clean old node side dependencies and browser binaries: rfbrowser clean-node
  3. 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:

  1. Clean old node side dependencies and browser binaries: rfbrowser clean-node
  2. 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.


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

πŸ›

About

Robot Framework Browser library powered by Playwright.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 53.8%
  • RobotFramework 22.4%
  • TypeScript 16.4%
  • HTML 3.8%
  • JavaScript 3.4%
  • Dockerfile 0.2%