SeleniumLibrary

6.8.0 · active · verified Sat Apr 11

SeleniumLibrary is a web testing library for Robot Framework, leveraging the Selenium WebDriver internally. It supports robust browser automation for web application testing. The current version, 6.8.0, supports Python 3.8 through 3.14, various Selenium 4.x versions, and Robot Framework 6.1.1 through 7.3.2. Releases are frequent, typically adapting to new Python, Selenium, and Robot Framework versions.

Warnings

breaking SeleniumLibrary version 6.0.0 and newer requires Selenium WebDriver 4.x+. Older versions of Selenium are no longer supported.
Fix: Ensure your `selenium` package is updated to version 4.x or newer (e.g., `pip install --upgrade selenium`).
deprecated The `headlesschrome` and `headlessfirefox` browser options for `Open Browser` were deprecated and removed in v6.2.0. Headless mode should now be configured using Selenium options directly.
Fix: Use the `options` argument with Selenium's `Options` object (e.g., `options=chromeoptions:add_argument(--headless)`).
gotcha SeleniumLibrary v6.1.1 fixed an incompatibility with Selenium v4.10.0+ where certain deprecated Selenium code paths were removed, causing issues for the library.
Fix: Upgrade SeleniumLibrary to v6.1.1 or newer to ensure compatibility with recent Selenium versions.
gotcha Version 6.7.1 downgraded the requirement on the `click` dependency to `click>=8.0` to address installation issues in some environments.
Fix: If experiencing dependency resolution issues with `click`, ensure you are on SeleniumLibrary 6.7.1 or newer. You might need to manually downgrade `click` if an incompatible version was installed.
breaking Python 2 support was dropped prior to SeleniumLibrary 4.0. All modern versions require Python 3.8+.
Fix: Migrate your test environment and Robot Framework setup to Python 3.8 or newer.
breaking Prior to version 3.0, the library was known as `Selenium2Library`. Migrating to `SeleniumLibrary` requires changing the import statement (`Library Selenium2Library` to `Library SeleniumLibrary`) and potentially updating keyword calls if prefixed.
Fix: Update library imports in your Robot Framework `*** Settings ***` and ensure keyword calls reflect the new library name. Refer to migration guides for details.

Install

pip install robotframework-seleniumlibrary Install latest version

Imports

SeleniumLibrary
```
*** Settings ***
Library    SeleniumLibrary
```
SeleniumLibrary is a Robot Framework library, imported directly in the settings section of a .robot file, not as a Python module in Python code.

Quickstart

This Robot Framework example demonstrates a basic login test using SeleniumLibrary. It opens a Chrome browser, navigates to a login page, inputs text into username and password fields, clicks the login button, asserts a successful login message, and then closes the browser. Replace `${USERNAME_HERE}` and `${PASSWORD_HERE}` with actual credentials or variables.

*** Settings ***
Library    SeleniumLibrary

*** Test Cases ***
Example Login Test
    Open Browser    https://the-internet.herokuapp.com/login    browser=chrome
    Input Text    id=username    ${USERNAME_HERE}
    Input Text    id=password    ${PASSWORD_HERE}
    Click Button    css:button[type='submit']
    Element Should Contain    id=flash    You logged into a secure area!
    Close Browser

view raw JSON →