Skip to main content

Robot Framework Browser library powered by Playwright. Aiming for speed, reliability and visibility.

Project description

robotframework-browser

All Contributors

Version Actions Status License


Robot Framework Browser library powered by Playwright. Moving browser automation to year 2020 (or 2021)!

Aiming for :rocket: speed, :white_check_mark: reliability and :microscope: visibility.

See keyword documentation.

Installation instructions

Only Python 3.7 or newer is supported.

  1. Install node.js e.g. from https://nodejs.org/en/download/
  2. Install robotframework-browser from the commandline: pip install robotframework-browser
  3. Install the node dependencies: run rfbrowser init in your shell

Or use the docker images. Documented at DOCKER.md.

Examples

Testing with Robot Framework

*** Settings ***
Library   Browser

*** Test Cases ***
Example Test
    New Page    https://playwright.dev
    Get Text    h1    ==    🎭 Playwright

and testing with Python.

import Browser
browser = Browser.Browser()
browser.new_page("https://playwright.dev")
assert browser.get_text("h1") == '🎭 Playwright'
browser.close_browser()

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

📖

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

robotframework-browser-1.4.0.tar.gz (359.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

robotframework_browser-1.4.0-py3-none-any.whl (383.9 kB view details)

Uploaded Python 3

File details

Details for the file robotframework-browser-1.4.0.tar.gz.

File metadata

  • Download URL: robotframework-browser-1.4.0.tar.gz
  • Upload date:
  • Size: 359.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.3

File hashes

Hashes for robotframework-browser-1.4.0.tar.gz
Algorithm Hash digest
SHA256 1d4cbae8014b85c5e1a6295f7de0424441aba8cd8f4390ab4643947b4f54c949
MD5 ec2db78419aa79badcc52a603b2d898f
BLAKE2b-256 08964d9d0e02325910bfbcfbb437bd0c77d1dfedd1f084da7852b864b75c688c

See more details on using hashes here.

File details

Details for the file robotframework_browser-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: robotframework_browser-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 383.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.3

File hashes

Hashes for robotframework_browser-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ed1421342917be94079817ae1f6cc891310e3bf9cf5f173169ab0c3a41c7a3ef
MD5 6d436c5f6460ae0e6711b9b40c3ef506
BLAKE2b-256 85efb845fe71f961cd7da8465ab9fc10627c461f7c588114fdce24e3eb12c3df

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page