rf-browser

Browser Library Skill

Quick Reference

Browser Library uses Playwright for fast, reliable browser automation with built-in auto-waiting and powerful assertion capabilities.

Installation

pip install robotframework-browser
rfbrowser init

Library Import

*** Settings ***
Library    Browser    auto_closing_level=KEEP

Import options:

• auto_closing_level=KEEP - Keep browser open between tests (faster)
• auto_closing_level=TEST - Close after each test (clean state)
• timeout=30s - Default timeout for operations
• enable_presenter_mode=true - Slow down for demos

Essential Concepts

Browser -> Context -> Page Hierarchy

Browser (chromium/firefox/webkit)
  └── Context (isolated session: cookies, storage)
        └── Page (single tab/window)

• Browser: The browser process (Chrome, Firefox, or WebKit)
• Context: Isolated browser session with its own cookies, localStorage, and cache
• Page: A single tab or popup window within a context

New Browser    chromium    headless=false
New Context    viewport={'width': 1920, 'height': 1080}
New Page       https://example.com

Auto-Waiting

Browser Library automatically waits for elements to be actionable before interacting. No explicit waits needed in most cases.

• Waits for element to be visible
• Waits for element to be stable (not animating)
• Waits for element to be enabled
• Waits for element to receive events

Core Keywords Quick Reference

Navigation

New Browser    chromium    headless=false
New Context    viewport={'width': 1920, 'height': 1080}
New Page       https://example.com
Go To          https://example.com/login
Reload
Go Back
Go Forward

Locators (Selector Syntax)

# CSS (default)
Click    button.submit
Click    #login-btn
Click    [data-testid="submit"]

# Text
Click    text=Login
Click    "Login"              # Exact text match

# XPath
Click    xpath=//button[@type='submit']

# Chained selectors (powerful!)
Click    .form >> button.submit
Click    #container >> text=Save

# nth-match
Click    button >> nth=0      # First button
Click    button >> nth=-1     # Last button

# Role selectors (accessibility)
Click    role=button[name="Submit"]