Note: You are looking at a static snapshot of documentation related to Robot Framework automations. The most recent documentation is at https://robocorp.com/docs
robocorp-browser
The robocorp-browser
is a wrapper for the Playwright
project, with quality-of-life improvements such as automatic lifecycle management
for Playwright objects (meant to be used with robocorp-tasks
).
Usage
๐ Check that you have added the dependency in your configuration, this library is not apart of the
robocorp
-package.
- conda.yaml for an automation Task Packages
- action-package.yaml for an automation Action Packages
- requirements.txt, pyproject.toml etc. for the rest
from robocorp.tasks import task
from robocorp import browser
from robocorp import vault
@task
def browser_automate():
# Configure may be used to set the basic robocorp.browser settings.
# It must be called prior to calling APIs which create playwright objects.
browser.configure(
# Note: screenshot="only-on-failure" is actually the default.
# If the browser_automate() function finishes with an exception it will
# make a screenshot and embed it into the logs.
screenshot="only-on-failure",
# By default headless is False unless running in a Linux container
# without a DISPLAY/WAYLAND_DISPLAY environment variable, but it
# can also be manually specified.
headless=True,
# Interactions may be run in slow-motion (given in milliseconds).
slowmo=100,
)
# browser.goto() may be used as a shortcut to get the current page and
# go to some url (it may create the browser if still not created).
browser.goto("https://example.com>")
login()
def login():
# APIs in robocorp.browser return the same browser instance, which is
# automatically closed when the task finishes.
page = browser.page()
# robocorp.vault is recommended for managing secrets.
account = vault.get_secret("default-account")
# Use the playwright Browser api as usual.
page.fill('//input[@ng-reflect-name="password"]', account["password"])
page.click("input:text('Submit')")
๐ You can also get started with our template
Changelog
A list of releases and corresponding changes can be found in the changelog.