The Selenium Browser Automation Project

Selenium is an umbrella project for a range of tools and libraries that enable and support the automation of web browsers.

It provides extensions to emulate user interaction with browsers, a distribution server for scaling browser allocation, and the infrastructure for implementations of the W3C WebDriver specification that lets you write interchangeable code for all major web browsers.

This project is made possible by volunteer contributors who have put in thousands of hours of their own time, and made the source code freely available for anyone to use, enjoy, and improve.

Selenium brings together browser vendors, engineers, and enthusiasts to further an open discussion around automation of the web platform. The project organises an annual conference to teach and nurture the community.

At the core of Selenium is WebDriver, an interface to write instruction sets that can be run interchangeably in many browsers. Here is one of the simplest instructions you can make:

from selenium import webdriver

driver = webdriver.Firefox()
driver.get("http://google.com/?hl=en")
search_box = driver.find_element_by_id("q")
search_box.send_keys("cheese")
search_box.submit()

See the Quick Tour for a full explanation of what goes on behind the scenes when you run this code. You should continue on to the narrative documentation to understand how you can install and successfully use Selenium as a test automation tool, and scaling simple tests like this to run in large, distributed environments on multiple browsers, on several different operating systems.

Getting started

If you are new to Selenium, we have a few resources that can help you get up to speed right away.

Narrative documentation

Narrative documentation in chapter form explaining how to use Selenium in detail, from bottom up.

Front matter