{"id":14978762,"url":"https://github.com/robotframework/seleniumlibrary","last_synced_at":"2025-12-17T02:54:00.928Z","repository":{"id":37385015,"uuid":"2625205","full_name":"robotframework/SeleniumLibrary","owner":"robotframework","description":"Web testing library for Robot Framework","archived":false,"fork":false,"pushed_at":"2025-02-27T00:40:52.000Z","size":114487,"stargazers_count":1433,"open_issues_count":66,"forks_count":771,"subscribers_count":145,"default_branch":"master","last_synced_at":"2025-05-08T05:13:26.273Z","etag":null,"topics":["python","robotframework","selenium"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robotframework.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2011-10-22T08:01:34.000Z","updated_at":"2025-05-06T04:47:53.000Z","dependencies_parsed_at":"2023-10-13T04:48:01.667Z","dependency_job_id":"64419d2f-fbea-49b6-9b19-0eef86d9303d","html_url":"https://github.com/robotframework/SeleniumLibrary","commit_stats":{"total_commits":2227,"total_committers":125,"mean_commits":17.816,"dds":0.7364167040862146,"last_synced_commit":"b5986f49e0906b8e3cab58dc0ba35211df4a9f55"},"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotframework%2FSeleniumLibrary","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotframework%2FSeleniumLibrary/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotframework%2FSeleniumLibrary/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robotframework%2FSeleniumLibrary/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robotframework","download_url":"https://codeload.github.com/robotframework/SeleniumLibrary/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253003117,"owners_count":21838645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","robotframework","selenium"],"created_at":"2024-09-24T13:58:20.157Z","updated_at":"2025-12-17T02:54:00.922Z","avatar_url":"https://github.com/robotframework.png","language":"Python","readme":"SeleniumLibrary\n===============\n\n.. contents::\n\nIntroduction\n------------\n\nSeleniumLibrary_ is a web testing library for `Robot Framework`_ that\nutilizes the Selenium_ tool internally. The project is hosted on GitHub_\nand downloads can be found from PyPI_.\n\nSeleniumLibrary currently works with Selenium 4. It supports Python 3.8 through 3.13.\nIn addition to the normal Python_ interpreter, it works also\nwith PyPy_.\n\nSeleniumLibrary is based on the \"old SeleniumLibrary\" that was forked to\nSelenium2Library and then later renamed back to SeleniumLibrary.\nSee the `VERSIONS.rst`_ for more information about different versions and the\noverall project history.\n\n.. image:: https://img.shields.io/pypi/v/robotframework-seleniumlibrary.svg?label=version\n   :target: https://pypi.python.org/pypi/robotframework-seleniumlibrary\n   \n.. image:: https://img.shields.io/pypi/dm/robotframework-seleniumlibrary.svg\n   :target: https://pypi.python.org/pypi/robotframework-seleniumlibrary\n\n.. image:: https://img.shields.io/pypi/l/robotframework-seleniumlibrary.svg\n   :target: https://www.apache.org/licenses/LICENSE-2.0\n\n.. image:: https://github.com/robotframework/SeleniumLibrary/actions/workflows/CI.yml/badge.svg?branch=master\n    :target: https://github.com/robotframework/SeleniumLibrary/actions/workflows/CI.yml\n\nKeyword Documentation\n---------------------\nSee `keyword documentation`_ for available keywords and more information\nabout the library in general.\n\nInstallation\n------------\n\nThe recommended installation method is using pip_::\n\n    pip install --upgrade robotframework-seleniumlibrary\n\nRunning this command installs also the latest Selenium and Robot Framework\nversions. The ``--upgrade`` option can be omitted when installing the library for the\nfirst time.\n\nIt is possible to install directly from the GitHub_ repository. To install\nlatest source from the master branch, use this command::\n\n    pip install git+https://github.com/robotframework/SeleniumLibrary.git\n\nPlease note that installation will take some time, because ``pip`` will\nclone the SeleniumLibrary_ project to a temporary directory and then\nperform the installation.\n\nSee `Robot Framework installation instructions`_ for detailed information\nabout installing Python and Robot Framework itself. For more details about\nusing ``pip`` see `its own documentation \u003cpip_\u003e`__.\n\nBrowser drivers\n---------------\n\nBrowsers and drivers are installed and managed automatically by `Selenium Manager`__.\nFor more information, see the `Selenium documentation`__.\n\n__ https://www.selenium.dev/documentation/selenium_manager\n__ https://seleniumhq.github.io/selenium/docs/api/py/index.html#drivers\n\nUsage\n-----\n\nTo use SeleniumLibrary in Robot Framework tests, the library needs to\nfirst be imported using the ``Library`` setting as any other library.\nThe library accepts some import time arguments, which are documented\nin the `keyword documentation`_ along with all the keywords provided\nby the library.\n\nWhen using Robot Framework, it is generally recommended to write as\neasy-to-understand tests as possible. The keywords provided by\nSeleniumLibrary is pretty low level, though, and often require\nimplementation-specific arguments like element locators to be passed\nas arguments. It is thus typically a good idea to write tests using\nRobot Framework's higher-level keywords that utilize SeleniumLibrary\nkeywords internally. This is illustrated by the following example\nwhere SeleniumLibrary keywords like ``Input Text`` are primarily\nused by higher-level keywords like ``Input Username``.\n\n.. code:: robotframework\n\n    *** Settings ***\n    Documentation     Simple example using SeleniumLibrary.\n    Library           SeleniumLibrary\n\n    *** Variables ***\n    ${LOGIN URL}      http://localhost:7272\n    ${BROWSER}        Chrome\n\n    *** Test Cases ***\n    Valid Login\n        Open Browser To Login Page\n        Input Username    demo\n        Input Password    mode\n        Submit Credentials\n        Welcome Page Should Be Open\n        [Teardown]    Close Browser\n\n    *** Keywords ***\n    Open Browser To Login Page\n        Open Browser    ${LOGIN URL}    ${BROWSER}\n        Title Should Be    Login Page\n\n    Input Username\n        [Arguments]    ${username}\n        Input Text    username_field    ${username}\n\n    Input Password\n        [Arguments]    ${password}\n        Input Text    password_field    ${password}\n\n    Submit Credentials\n        Click Button    login_button\n\n    Welcome Page Should Be Open\n        Title Should Be    Welcome Page\n\n\nThe above example is a slightly modified version of an example in a\n`demo project`_ that illustrates using Robot Framework and SeleniumLibrary.\nSee the demo for more examples that you can also execute on your own\nmachine. For more information about Robot Framework test data syntax in\ngeneral see the `Robot Framework User Guide`_.\n\nExtending SeleniumLibrary\n-------------------------\nBefore creating your own library which extends the ``SeleniumLibrary``, please consider would\nthe extension be also useful also for general usage. If it could be useful also for general\nusage, please create a new issue describing the enhancement request and even better if the\nissue is backed up by a pull request.\n\nIf the enhancement is not generally useful, example solution is domain specific, then the\nSeleniumLibrary offers public APIs which can be used to build its own plugins and libraries.\nPlugin API allows us to add new keywords, modify existing keywords and modify the internal\nfunctionality of the library. Also new libraries can be built on top of the\nSeleniumLibrary. Please see `extending documentation`_ for more details about the\navailable methods and for examples how the library can be extended.\n\nCommunity\n---------\n\nIf the provided documentation is not enough, there are various community channels\navailable:\n\n- ``#seleniumlibrary`` and ``#seleniumlibrary-dev`` channels in\n  Robot Framework `Slack community`_\n- `Robot Framework forum`_ has channel for SeleniumLibrary.\n- SeleniumLibrary `issue tracker`_ for bug reports and concrete enhancement\n  requests\n- `Other community channels`_ including paid support\n\n\n.. _Robot Framework: https://robotframework.org\n.. _Selenium: https://www.seleniumhq.org/\n.. _SeleniumLibrary: https://github.com/robotframework/SeleniumLibrary\n.. _pip: http://pip-installer.org\n.. _PyPI: https://pypi.python.org/pypi/robotframework-seleniumlibrary\n.. _GitHub: https://github.com/robotframework/SeleniumLibrary\n.. _Keyword Documentation: https://robotframework.org/SeleniumLibrary/SeleniumLibrary.html\n.. _Python: https://python.org\n.. _PyPy: https://pypy.org\n.. _demo project: https://github.com/robotframework/WebDemo\n.. _Robot Framework User Guide: https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html\n.. _Robot Framework installation instructions: https://github.com/robotframework/robotframework/blob/master/INSTALL.rst\n.. _extending documentation: https://github.com/robotframework/SeleniumLibrary/blob/master/docs/extending/extending.rst\n.. _Slack community: https://robotframework-slack-invite.herokuapp.com\n.. _Robot Framework forum: https://forum.robotframework.org/\n.. _issue tracker: https://github.com/robotframework/SeleniumLibrary/issues\n.. _Other community channels: https://robotframework.org/#community\n.. _VERSIONS.rst: https://github.com/robotframework/SeleniumLibrary/blob/master/VERSIONS.rst\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobotframework%2Fseleniumlibrary","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobotframework%2Fseleniumlibrary","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobotframework%2Fseleniumlibrary/lists"}