Skip to main content

Introduction

Python language bindings for Selenium WebDriver.

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

Home:

http://www.seleniumhq.org

Docs:

https://seleniumhq.github.io/selenium/docs/api/py/api.html

Dev:

https://github.com/SeleniumHQ/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+

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.53.2.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-release.storage.googleapis.com/2.53/selenium-server-standalone-2.53.0.jar

Run the server from the command line:

java -jar selenium-server-standalone-2.53.0.jar

Then run your Python client scripts.

Use The Source Luke!

View source code online at https://github.com/SeleniumHQ/selenium/tree/master/py/

Download files

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

Source Distribution

selenium-2.53.5.tar.gz (816.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

selenium-2.53.5-py2.py3-none-any.whl (884.9 kB view details)

Uploaded Python 2Python 3

File details

Details for the file selenium-2.53.5.tar.gz.

File metadata

  • Download URL: selenium-2.53.5.tar.gz
  • Upload date:
  • Size: 816.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for selenium-2.53.5.tar.gz
Algorithm Hash digest
SHA256 783e0064a34a026b924d0a1679d5b2ec633462e5091dd71ebd6e6d078674c597
MD5 c7e40c360d73e267234e166f252f574c
BLAKE2b-256 41ffd77fd45739a2290da74ba314182fcfbe98b4e617e89b973bc5c667444334

See more details on using hashes here.

File details

Details for the file selenium-2.53.5-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for selenium-2.53.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 2db746d0a2fea378fbc7950da6bd8073df1a31fdcedf1b01b579849d43efc574
MD5 d8f65c861a14ad315e6d71a79f9edc8d
BLAKE2b-256 241d9e7cba7fd1f92d9aaf4fc83fd7d27b2a92dadfd4400dca443c79764100dc

See more details on using hashes here.

Release history Release notifications | RSS feed

4.48.0

2 files

4.47.0

2 files

4.46.0

2 files

4.45.0

2 files

4.44.0

2 files

4.43.0

2 files

4.42.0

2 files

4.41.0

2 files

4.40.0

2 files

4.39.0

2 files

4.38.0

2 files

4.37.0

2 files

4.36.0

2 files

4.35.0

2 files

4.34.2

2 files

4.34.1

1 file

4.34.0

2 files

4.33.0

2 files

4.32.0

2 files

4.31.0

2 files

4.30.0

2 files

4.29.0

2 files

4.28.1

2 files

4.28.0

2 files

4.27.1

2 files

4.27.0

2 files

4.26.1

2 files

4.26.0

2 files

4.25.0

2 files

4.24.0

2 files

4.23.1

2 files

4.23.0

2 files

4.22.0

2 files

4.21.0

2 files

4.20.0

2 files

4.19.0

2 files

4.18.1

2 files

4.18.0

2 files

4.17.2

2 files

4.17.1

2 files

4.17.0

2 files

4.16.0

2 files

4.15.2

2 files

4.15.1

2 files

4.15.0

2 files

4.14.0

2 files

4.13.0

2 files

4.12.0

2 files

4.11.2

2 files

4.11.1

2 files

4.11.0

2 files

4.10.0

2 files

4.9.1

2 files

4.9.0

2 files

4.8.3

2 files

4.8.2

2 files

4.8.1

2 files

4.8.0

2 files

4.7.2

2 files

4.7.1

1 file

4.7.0

1 file

4.6.1

1 file

4.6.0

1 file

4.5.0

1 file

4.4.3

1 file

4.4.2

1 file

4.4.1

1 file

4.4.0

1 file

4.3.0

1 file

4.2.0

1 file

4.1.5

1 file

4.1.4

1 file

4.1.3

1 file

4.1.2

1 file

4.1.1

1 file

4.1.0

1 file

4.0.0

1 file

4.0.0a6

2 files

3.141.0

2 files

3.14.1

2 files

3.14.0

2 files

3.13.0

2 files

3.12.0

2 files

3.11.0

2 files

3.10.0

2 files

3.9.0

2 files

3.8.1

2 files

3.8.0

2 files

3.7.0

2 files

3.6.0

2 files

3.5.0

2 files

3.4.3

2 files

3.4.2

2 files

3.4.1

2 files

3.4.0

2 files

3.3.3

2 files

3.3.2

2 files

3.3.1

2 files

3.3.0

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.53.6

2 files

This release

2.53.5 This release

2 files

2.53.4

2 files

2.53.3

2 files

2.53.2

2 files

2.53.1

2 files

2.53.0

2 files

2.52.0

1 file

2.51.1

1 file

2.51.0

1 file

2.50.1

2 files

2.50.0

2 files

2.49.2

2 files

2.49.1

2 files

2.49.0

2 files

2.48.0

2 files

2.47.3

2 files

2.47.2

1 file

2.47.1

2 files

2.47.0

1 file

2.46.1

1 file

2.46.0

1 file

2.45.0

1 file

2.44.0

1 file

2.43.0

1 file

2.42.1

1 file

2.42.0

1 file

2.41.0

1 file

2.40.0

1 file

2.39.0

1 file

2.38.4

1 file

2.38.3

1 file

2.38.2

1 file

2.38.1

1 file

2.38.0

1 file

2.37.2

1 file

2.37.1

1 file

2.37.0

1 file

2.36.0

1 file

2.35.0

1 file

2.34.0

1 file

2.33.0

1 file

2.32.0

1 file

2.31.0

1 file

2.30.0

1 file

2.29.0

1 file

2.28.0

1 file

2.27.0

1 file

2.26.0

1 file

2.25.0

1 file

2.24.0

1 file

2.23.0

1 file

2.22.1

1 file

2.22.0

1 file

2.21.3

1 file

2.21.2

1 file

2.21.1

1 file

2.21.0

1 file

2.20.0

1 file

2.19.1

1 file

2.19.0

1 file

2.18.1

1 file

2.17.0

2 files

2.16.0

1 file

2.15.0

1 file

2.14.0

1 file

2.13.1

1 file

2.13.0

1 file

2.12.1

1 file

2.12.0

1 file

2.11.1

1 file

2.11.0

1 file

2.10.0

1 file

2.9.0

1 file

2.8.1

1 file

2.8.0

1 file

2.7.0

1 file

2.6.0

1 file

2.5.0

1 file

2.4.0

1 file

2.3.0

1 file

2.2.0

1 file

2.1.0

1 file

2.0.1

1 file

2.0.0

1 file

1.0.3

1 file

1.0.1

3 files

0.9.2

3 files

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