# Robot Framework Browser

> A browser automation library for Robot Framework, powered by Playwright. Speed, reliability and visibility, with assertions built into the keywords.

Source: [https://robotframework-browser.org/](https://robotframework-browser.org/)

Robot Framework deserves a browser automation solution designed for the 2020s.
Browser library, powered by [Playwright](https://playwright.dev/), provides
speed, reliability and visibility.

- [Get started](https://robotframework-browser.org/#start)
- [Why Browser](https://robotframework-browser.org/why)

- Browser: **21.0.0**
- Playwright: **1.64.1**
- Node: **26.13.0**
- Keywords: **154**
- Stars: **661**
- Contributors: **211**
- Releases: **192**
- Sleeps: **0**

## Speed, reliability and visibility.

**Speed**

One Node process drives Chromium, Firefox and WebKit. No driver binary per
browser, no version to keep in step with an update.

**Reliability**

Every action waits for the element to be actionable before it acts. No sleeps
to tune, and no flake to chase down.

**Visibility**

Video, a Playwright trace and a screenshot on failure, attached to the Robot
Framework log.

- Conscientious assertions
- Precise and fast browser window and tab control
- Chainable selector strategies
- Good shadow DOM support
- Simple descriptors for mobile devices
- Sending HTTP requests

[How it works, and how it compares](https://robotframework-browser.org/why)

## Running in five minutes.

Three blocks. Copy them in order and you have a passing test — nothing to
configure in between.

### Install the library and the browsers

No Node.js needed — the `[bb]` extra brings one along in the wheel.
`rfbrowser install` downloads the browser binaries Playwright drives. The tabs
below pick your shell automatically.

```bash
$ pip install "robotframework-browser[bb]"
Successfully installed robotframework-browser-21.0.0 robotframework-browser-batteries-21.0.0
$ rfbrowser install
Installing Playwright browser binaries…
✓ chromium   downloaded
✓ firefox    downloaded
✓ webkit     downloaded
```

```powershell
PS> py -m pip install "robotframework-browser[bb]"
Successfully installed robotframework-browser-21.0.0 robotframework-browser-batteries-21.0.0
PS> py -m Browser.entry install
Installing Playwright browser binaries…
✓ chromium   downloaded
✓ firefox    downloaded
✓ webkit     downloaded
```

Want a Node toolchain of your own instead, or on a platform with no wheel? That
route is two different commands and [Installation](https://robotframework-browser.org/docs/start/installation) has
both.

### Write a test

One import, no setup keyword, no explicit waits. `Get Text` both reads the
value and asserts it — and it keeps re-reading until the search results arrive,
which is why nothing here waits for them.

```robot [first.robot]
*** Settings ***
Library     Browser

*** Test Cases ***
Search The Syllabus
    New Page      https://syllabus.robotframework.org
    Fill Text     id=search_input_react    Argument Types
    Get Text      body    *=    2.5.2.8
```

### Run it

Robot Framework as usual — the browser opens, acts and closes.

```bash
$ robot first.robot
=========================================================
First
✓ Search Robot Framework
1 test, 1 passed, 0 failed
```

Next: the [getting-started guide](https://robotframework-browser.org/docs/start/getting-started), or the
[keyword reference](https://robotframework-browser.org/keywords).

Writing your tests with an AI assistant? This site is also published for
language models: [llms.txt](https://robotframework-browser.org/llms.txt) lists
every page as Markdown,
[llms-full.txt](https://robotframework-browser.org/llms-full.txt) holds all the
docs in one file, and
[keywords.md](https://robotframework-browser.org/keywords.md) the complete
keyword reference. Point your assistant there.

## Use. Benefit. Contribute.

Browser library is built in the open by the Robot Framework community — 206
people so far. Questions, ideas and bug reports are how most of them started,
and how the library got this far.

- [Community and contributing](https://robotframework-browser.org/community)
- [Forum](https://forum.robotframework.org/c/libraries/browser)
- [GitHub](https://github.com/MarketSquare/robotframework-browser)

### And 206 people who made it better

Bug reports, ideas, documentation, running main against a real suite before it
was ever released. Most of them never wrote a line of code for Browser.
[See who did what](https://robotframework-browser.org/community#hall).

**Let's make the best Browser library.**