Registry / testing / robotframework-browser

robotframework-browser

library20.4.0pypypiunverified

Robot Framework Browser library (robotframework-browser) is a web testing library for Robot Framework that uses Playwright internally for browser automation. It aims for speed, reliability, and visibility in web testing. The library has a rapid release cadence, frequently publishing hotfixes and minor versions, often on a monthly or bi-weekly basis.

testing web-framework

pip install robotframework-browser
rfbrowser init

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · ROBOTFRAMEWORK-BRO

robotframework-browser

testingpythonv20.4.0

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

dependency_conflict

glibc

py 3.10–3.910 runs

dependency_conflict

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Browser

✓ *** Settings *** Library Browser

In Robot Framework test files, libraries are imported in the '*** Settings ***' section. Direct Python `import` statements for `Browser` are generally not used by end-users.

This quickstart demonstrates a basic Robot Framework test case using the Browser library. It opens a new browser page to playwright.dev and asserts that the `h1` element contains the text 'Playwright'.

*** Settings *** Library Browser *** Test Cases *** Example Test New Page https://playwright.dev Get Text h1 contains Playwright

robot --version

Debug

Known issues

breakingPython 3.8 support was dropped with version 18.9.0. Users on Python 3.8 or older must upgrade their Python environment to Python 3.9+ (or higher, as latest versions require 3.10+).

fix

Upgrade your Python environment to 3.10 or newer. Refer to the library's official documentation for current Python requirements.

affects: >=18.9.0

breakingThe `Browser/utils/robot_booleans.py` module was removed in version 19.14.0. If you were directly importing or referencing this internal module, your tests will break.

fix

Avoid importing internal utility modules. If specific boolean conversion logic is needed, implement it directly in your test suite or custom library based on Robot Framework's documented APIs.

affects: >=19.14.0

gotchaAfter `pip install robotframework-browser`, it is crucial to run `rfbrowser init` (or `python -m Browser.entry init`) to download necessary browser binaries and Node.js dependencies. Forgetting this step will lead to 'Couldn't execute node' or similar errors when tests run.

fix

Always execute `rfbrowser init` after installation or upgrade. If Node.js is not present, consider `pip install robotframework-browser[bb]` and then `rfbrowser install`.

affects: All versions

gotchaThe `grpcio` dependency, which is used for communication between Python and Node.js, has historically caused installation and runtime issues, especially on macOS (M1/ARM) or with specific Python versions (e.g., building wheels failing). Version 19.12.7 specifically downgraded `grpcio` to 1.78.0 to address issues.

fix

Ensure your Node.js and Python versions align with the library's requirements. If issues persist, try explicitly installing a known working `grpcio` version (e.g., `pip install grpcio==1.78.0`) or using the `robotframework-browser-batteries` variant to bypass Node.js entirely.

affects: All versions, particularly older ones or specific environments

gotchaThe Browser library uses a different paradigm (Browser, Context, Page layers) compared to older Selenium-based libraries. Directly migrating tests from `SeleniumLibrary` without understanding these new concepts can be challenging and lead to incorrect or inefficient test implementations.

fix

Familiarize yourself with the Browser library's concepts of Browser, Context, and Page. Review the official documentation and examples for recommended patterns, especially regarding session management and element interaction.

affects: All versions

gotchaBy default, the Browser library enables 'strict mode' for selectors, meaning keywords will fail if a selector matches multiple elements. This differs from some other web automation libraries.

fix

If you intend to interact with multiple elements, use keywords explicitly designed for that (e.g., `Get Elements`) or disable strict mode where appropriate. Be explicit with your selectors to target a single element.

affects: All versions

gotchaPlaying videos in automated tests using Chromium can sometimes fail due to codec problems. This is often an upstream Playwright/Chromium limitation.

fix

If video playback is critical, try running tests with Firefox or Webkit, or specifically with a full Google Chrome or Microsoft Edge browser (instead of the default Chromium provided by Playwright).

affects: All versions

Upgrade

Version history

20.4.0latest on PyPI · released Aug 19, 2026

Audit

Dependencies

pythonrequiredRequired for Robot Framework and the library itself.

nodejsoptionalRequired by Playwright, which is used internally by the library. LTS versions 20, 22, and 24 are supported.

robotframeworkrequiredThe core framework for which this library provides web automation capabilities.

Agent activity

47 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/MarketSquare/robotframework-browser ↗

packagehttps://pypi.org/project/robotframework-browser/ ↗

homepagehttps://robotframework-browser.org/ ↗

docshttps://marketsquare.github.io/robotframework-browser/Browser.html ↗

changeloghttps://github.com/MarketSquare/robotframework-browser/tree/main/docs/releasenotes ↗