Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

Web testing library for Robot Framework

Project description

Selenium2Library is a web testing library for Robot Framework that uses the Selenium tool internally. The project is hosted on GitHub and downloads can be found from PyPI.

Starting from version 3.0, Selenium2Library is renamed to SeleniumLibrary and this project exists mainly to help with transitioning.


Selenium2Library 3.0 and newer extend the new SeleniumLibrary and thus contain exactly the same code and functionality. There have been lot of internal changes in the library, but external functionality provided by keywords should be fully backwards compatible. Libraries and tools using Selenium2Library internally may need to be updated to support Selenium2Library 3.0, though. Selenium2Library 1.8 is the latest, and last, legacy version with the old architecture and code.

Selenium2Library 3.0 supports Python 2.7 as well as Python 3.3 and newer. Selenium2Library 1.8 supports Python 2.6-2.7.

Keyword documentation


The recommended approach to install Selenium2Library, regardless the version, is using pip.

Install (or upgrade) the latest Selenium2Library version:

pip install --upgrade robotframework-selenium2library

Install the legacy Selenium2Library 1.8.0 version:

pip install robotframework-selenium2library==1.8.0

Migrating to SeleniumLibrary

Existing Selenium2Library users should start migrating to the SeleniumLibrary. For most users this should be a simple procedure:

  1. Install the latest Selenium2Library as explained above. This installs both SeleniumLibrary and Selenium2Library, and in fact Selenium2Library is nowadays just a thin wrapper for SeleniumLibrary.

  2. Execute tests normally to see are there problems.

  3. If problems are encountered, try on investigate why they occur. Possible problems can be divided into two categories:

    • If a keyword provided by the library itself has changed, take a look at SeleniumLibrary 3.0 release notes to see is it a known backwards incompatible change. If it isn’t, you may have encountered a regression that ought to be reported to SeleniumLibrary issue tracker.
    • If a library using Selenium2Library does not work anymore, it is likely due to the large internal changes in SeleniumLibrary 3.0. Report the problem to the maintainers of the broken library or fix the problem yourself if you are the maintainer.

    Regardless the problem, you can always ask help on various support channels.

  4. If no problems occur or after problems have been resolved, you can start changing library imports to use SeleniumLibrary instead of Selenium2Library. Also all keyword usages in form like Selenium2Library.Title Should Be need to be updated.

  5. After test data has been updated, Selenium2Library installation can be removed altogether.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for robotframework-selenium2library, version 3.0.0
Filename, size File type Python version Upload date Hashes
Filename, size robotframework_selenium2library-3.0.0-py2.py3-none-any.whl (6.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size robotframework-selenium2library-3.0.0.tar.gz (71.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page