Skip to main content

Selenium Client Driver

Introduction

Python language bindings for Selenium WebDriver.

The selenium package is used automate web browser interaction from Python.

Home:

http://www.seleniumhq.org

Docs:

selenium package API

Dev:

https://code.google.com/p/selenium/

PyPI:

https://pypi.python.org/pypi/selenium

IRC:

#selenium channel on freenode

Several browsers/drivers are supported (Firefox, Chrome, Internet Explorer, PhantomJS), as well as the Remote protocol.

Supported Python Versions

  • Python 2.6, 2.7

  • Python 3.2, 3.3

Installing

If you have pip on your system, you can simply install or upgrade the Python bindings:

pip install -U selenium

Alternately, you can download the source distribution from PyPI (e.g. selenium-2.37.tar.gz), unarchive it, and run:

python setup.py install

Note: both of the methods described above install selenium as a system-wide package That will require administrative/root access to ther machine. You may consider using a virtualenv to create isolated Python environments instead.

Example 0:

  • open a new Firefox browser

  • load the page at the given URL

from selenium import webdriver

browser = webdriver.Firefox()
browser.get('http://seleniumhq.org/')

Example 1:

  • open a new Firefox browser

  • load the Yahoo homepage

  • search for “seleniumhq”

  • close the browser

from selenium import webdriver
from selenium.webdriver.common.keys import Keys

browser = webdriver.Firefox()

browser.get('http://www.yahoo.com')
assert 'Yahoo!' in browser.title

elem = browser.find_element_by_name('p')  # Find the search box
elem.send_keys('seleniumhq' + Keys.RETURN)

browser.quit()

Example 2:

Selenium WebDriver is often used as a basis for testing web applications. Here is a simple example uisng Python’s standard unittest library:

import unittest

class GoogleTestCase(unittest.TestCase):

    def setUp(self):
        self.browser = webdriver.Firefox()
        self.addCleanup(self.browser.quit)

    def testPageTitle(self):
        self.browser.get('http://www.google.com')
        self.assertIn('Google', self.browser.title)

if __name__ == '__main__':
    unittest.main(verbosity=2)

Selenium Server (optional)

For normal WebDriver scripts (non-Remote), the Java server is not needed.

However, to use Selenium Webdriver Remote or the legacy Selenium API (Selenium-RC), you need to also run the Selenium server. The server requires a Java Runtime Environment (JRE).

Download the server separately, from: http://selenium.googlecode.com/files/selenium-server-standalone-2.37.1.jar

Run the server from the command line:

java -jar selenium-server-standalone-2.37.1.jar

Then run your Python client scripts.

Use The Source Luke!

View source code online:

official:

https://code.google.com/p/selenium/source/browse/py

mirror:

https://github.com/SeleniumHQ/selenium/tree/master/py

Metadata

Release files for selenium 2.37.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for selenium 2.37.1
File Size Uploaded Provenance Actions
selenium-2.37.1.tar.gz 2.6 MB Without provenance Details for selenium-2.37.1.tar.gz

Release files / selenium-2.37.1.tar.gz

Download URL selenium-2.37.1.tar.gz
Size 2.6 MB
Tags Source
SHA-256 checksum
How to use checksums
ea9f1554cc5892146d2f71ffcfca050456a81b6fa7d31a970c34fcf9f93e64ab
BLAKE2b-256 checksum
How to use checksums
d2f59f462dc6d27e9d911f99a7ed6e7d25502ca804ea67dd7bd08146844e1307
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for selenium 2.37.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.37.1 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page