Getting Started with Selenium
Getting Started with Selenium
By Frank Cohen
23,879 Downloads · Refcard 67 of 202 (see them all)
The Essential Selenium Cheat Sheet
Getting Started with Selenium
Selenium is a portable software testing framework for Web applications. Selenium works well for QA testers needing record/playback authoring of tests and for software developers needing to author tests in Java, Ruby, Python, PHP, and several other languages using the Selenium API. The Selenium architecture runs tests directly in most modern Web browsers, including MS IE, Firefox, Opera, Safari, and Chrome. Selenium deploys on Windows, Linux, and Macintosh platforms.
Selenium was developed by a team of programmers and testers at ThoughtWorks. Selenium is open source software, released under the Apache 2.0 license and can be downloaded and used without royalty to the originators.
Architecture in a Nutshell
Selenium architecture offers several ways to play a test.
Functional testing (Type 1) uses the Selenium IDE add-on to Firefox to record and playback Selenium tests in Firefox. Functional testing (Type 2) uses Selenium Grid to run tests in a farm of browsers and operating environments. For example, run install Selenium Grid on 3 operation environments (for example, Windows Vista, Windows XP, and Ubutu) and on each install 2 browser (for example, Microsoft Internet Explorer and Firefox) to smoke test, integration test, and functional test your application on 6 combinations of operating environment and browser. Many more combinations of operating environment and browser are possible. An option for functional testing (Type 2) is to use the PushToTest TestMaker/TestNode open source project. It uses Selenium RC to provide Selenium Gridlike capability with the added advantage of providing datadriven Selenium tests, results analysis charts and graphs, and better stability of the test operations.
HTMLUnit runs Selenium tests faster than a real browser and requires much less memory and CPU resources.
Selenium IDE installs as a Firefox add-on. Below are the steps to download and install Selenium IDE:
- Download selenium-ide-1.0.2.xpi (or similar) from http://seleniumhq.org.
- From Firefox open the .xpi file. Follow the Firefox instructions.
- Note: Selenium Grid runs as an Ant task. You need JDK 1.6, Ant 1.7, and the Selenium Grid 1.0 binary distribution. Additional directions can be found at http://selenium-grid.seleniumhq.org/get_started.html
- See http://www.pushtotest.com/products for TestMaker installation instructions.
Record/playback using selenium ide
Selenium IDE is a Firefox add-on that records clicks, typing, and other actions to make a test, which you can play back in the Firefox browser. Open Selenium IDE from the Firefox Tools drop-down menu, Selenium IDE command.
Selenium IDE records interactions with the Web application, with one command per line. Clicking a recorded command highlights the command, displays a reference page, and displays the command in a command form editor. Click the command form entry down-triangle to see a list of all the Selenium commands.
Run the current test by clicking the Run Test Case icon in the icon bar. Right click a test command to choose the Set Breakpoint command. Selenium IDE runs the test to a breakpoint and then pauses. The icon bar Step icon continues executing the test one command at a time.
With Selenium IDE open, the menu bar context changes to provide access to Selenium commands: Open/Close Test Case and Test Suite. Test Suites contain one or more Test Cases.
Use the Options dropdown menu, Options command to set general preferences for Selenium IDE.
Selenium Context Menu provides quick commands to insert new Selenium commands, evaluate XPath expressions within the live Web page, and to show all available Selenium commands. Right click on commands in Selenium IDE, and right-click on elements in the browser page to view the Selenium Context Menu commands.
Selenese Table Format
Selenium IDE is meant to be a light-weight record/playback tool to facilitate getting started with Selenium. It is not designed to be a full test development environment. While Selenium records in an HTML table format (named Selenese) the table format only handles simple procedural test use cases. The Selenese table format does not provide operational test data support, conditionals, branching, and looping. For these you must Export Selenese files into Java, Ruby, or other supported languages.
Selenium Command reference
Selenium comes with commands to: control Selenium test operations, browser and cookie operations, pop-up, button, list, edit field, keyboard, mouse, and form operations. Selenium also provides access operations to examine the Web application (details are at http://release.seleniumhq.org/selenium-core/0.8.0/reference.html).
|Command||Value, Target, Wait Command|
|setMouseSpeed||number of pixels|
|Popup Box Operations|
|Checkbox & Radio Buttons|
|Lists & Dropdowns|
Selenese Table Format
Selenium commands identify elements within a Web page using:
|identifier=id||Select the element with the specified @id attribute. If no match is found, select the first element whose @name attribute is id.|
|name=name||Select the first element with the specified @name attribute. The name may optionally be followed by one or more elementfilters, separated from the name by whitespace. If the filterType is not specified, value is assumed. For example, name=style value=carol|
Locate an element using an XPath expression. Here are a few examples:
|link=textPattern||Select the link (anchor) element which contains text matching the specified pattern.|
Select the element using css selectors. For example:
Selenium 1.0 css selector locator supports all css1, css2 and css3 selectors except namespace in css3, some pseudo classes(:nthof-type, :nth-last-of-type, :first-of-type, :last-of-type, :only-of-type, :visited, :hover, :active, :focus, :indeterminate) and pseudo elements(::first-line, ::first-letter, ::selection, ::before, ::after). Without an explicit locator prefix, Selenium uses the following default strategies:
dom, for locators starting with "document." xpath, for locators starting with "//" identifier, otherwise
Your choice of element locator type has an impact on the test playback performance. The following table compares performance of Selenium element locators using Firefox 3 and Internet Explorer 7.
|Locator used||Type||Firefox 3||Internet Explorer 7|
|q||Locator||47 ms||798 ms|
|//input[@name='q']||XPath||32 ms||563 ms|
|//html/body//form//input||XPath||47 ms||859 ms|
|//input||XPath||31 ms||564 ms|
|document.forms.elements||DOM Index||31 ms||125 ms|
Additional details on Selenium performance can be found at: http://www.pushtotest.com/docs/thecohenblog/symposium
Selenium implements a domain specific language (DSL) for testing. Some applications do not lend themselves to record/ playback: 1) The test flow changes depending on the results of a step in the test, 2) The input data changes depending on the state of the application, and 3) The test requires asynchronously operating test flows. For these conditions, consider using the Selenium DSL in a script driven test. Selenium provides support for Java, Python, Ruby, Groovy, PHP, and C#.
Selenium IDE helps get a script-driven test started by exporting to a unit test format. For example, consider the following test in the Selenese table format:
Use the Selenium IDE File menu, Export, Python Selenium RC command to export the test to a jUnit-style TestCase written in Python. The following shows the Java source code:
package com.example.tests; from selenium import selenium import unittest, time, re class franktest(unittest.TestCase): def setUp(self): self.verificationErrors =  self.selenium = selenium("localhost", 4444, "*chrome", \ "http://change-this-to-the-site-you-are-testing/") self.selenium.start() def test_franktest(self): sel = self.selenium sel.open("/") sel.type("q", "sock puppet") sel.click("sa") sel.wait_for_page_to_load("30000") sel.click("//div[@id='res']/div/ol/li/div/h2/a/em") sel.click("//div[@id='res']/div/ol/li/div/h2/a/em") sel.wait_for_page_to_load("30000") def tearDown(self): self.selenium.stop() self.assertEqual(, self.verificationErrors) if __name__ == "__main__": unittest.main()
An exported test like the one above has access to all of Python's functions, including conditionals, looping and branching, reusable object libraries, inheritance, collections, and dynamically typed data formats.
Selenium provides a Selenium RC client package for Java, Python, C#, Ruby, Groovy, PHP, and Perl. The client object identifies the Selenium RC service in its constructor:
self.selenium = selenium("localhost", 4444, "*iexplore", \ "http://change-this-to-the-site-you-are-testing/") self.selenium.start()
The above code identifies the Selenium RC service running on the localhost machine at port 4444. This client will run the test in Microsoft Internet Explorer. The third parameter identifies the base URL from which the recorded test will operate.
Using the selenium.start() command initializes and starts the Selenium RC service. The Selenium RC client module (import selenium in Python) provides methods to operate the Selenium DSL commands (click, type, etc.) in the Browserbot running in the browser. For example, selenium.click("open") tells the Browserbot to a click command to the element with an id tag equal to "open". The browser responds to the click command and communicates with the Web application.
At the end of the test the selenium.stop() command ends the Selenium RC service.
Selenium and Ajax
Consider the following checklist when using Selenium with Ajax applications:
Your Selenium tests may require a large number of extra commands to ensure the test stays in synchronization with the Ajax application. Consider an Ajax application that requires a log-in, then displays a selection list of items, then presents an order form. Ajax enabled applications often deliver multiple steps of function on a single page and show-and-hide elements as you work with the application. Some even disable form submit buttons and other user interface elements until you enter enough valid information. For an application like this you will need a combination of Selenium commands. Consider the following Selenium test:
Some Ajax applications use lazy-loading techniques to improve user interaction with the application. A stock market application provides a list of 10 stock quotes asynchronously after the user clicks the submit button. The list may take 10 to 50 seconds to completly update on the screen. Using waitForXPathCount pauses the test until the page contains the number of nodes that match the specified XPath expression.
Many Ajax applications use dynamic element id tags. The Ajax application that named the Log-out button app_6 may later rename the button to app_182. We recommend using DOM element locator techniques, or XPath techniques if needed, to dynamically find elements on a positional or other attribute means.
Working with tinymce and Ajax objects
Here is an example of using the TinyMCE API from a Selenium test context:
this.browserbot.getCurrentWindow().tinyMCE.execCommand ('mceInsertContent',false,'<b>Hello world!!</b>');
Selenium offers no operational test data production capability itself. For example, a Selenium test of a sign-in page usually needs sign-in name and sign-in password operational test data to operate. Two options are available: 1) Use the data access features in Java, Ruby, or one of other supported languages, 2) Use PushToTest TestMaker's Selenium Script Runner to inject data from comma separated value (CSV) files, relational databases, objects, and Web services. See http://tinyurl.com/btxvn4 for details.
Create a Comma-Separated-Value file. Use your favorite text editor or spreadsheet program. Name the file data.csv. The contents must be in the following form.
The first row of the data file contains column names. These will be used to map values into the Selenium test. Change the Selenium test to refer to mapping name. PushToTest maps the data from the named column in the CSV data file to the Selenium test data using the first row definitions.
Connect the Data Production Library (DPL) to the Selenium test in a TestMaker TestScenario. Begin by definition a HashDPL. This DPL reads from CSV data files and provides the data to the test.
<DataSources> <dpl name="mydpl" type="HashDPL"> <argument name="file" dpl="rsc" value="getDataByIndex" index="0"/> </dpl> </DataSources>
Next, tell the TestScenario to send the data.csv and Selenium test files to the TestNodes that will operate the test.
<resources> <data path="data.csv"/> <selenese path="CalendarTest.selenium"/> </resources>
Then tell the Selenium ScriptRunner to use the DPL provided data when running the Selenium test.
<run name="CalendarTest" testclass="CalendarTest.selenium" method="runSeleneseFile" langtype="selenium"> <argument dpl="mydpl" name="DPL_Properties" value="getNextData"/> </run>
The getNextData operation gets the next row of data from the CSV file. The Selenium ScriptRunner injexts the data into the Selenium test.
Browser Sandbox, Redirect, and proxy issues
Some Web applications redirect from http to https URLs. The browser will often issue a warning that stops the Selenium test.
Selnium does not support a test moving across domains. For example, a test that started with a baseurl of www.mydomain. com may not open a page on www.secondomain.com.
selenium RC browser profiles
Selenium Remote Control (RC) enables test operation on multiple real browsers. A browser profile attribute may be any of the following installed browsers: chrome, konqueror, piiexplore, iehta, mock, opera, pifirefox, safari, iexplore and custom. Append the path to the real browser after browser profile if your system path does not state the path to the browser. For example:
Component approach example
Many organizations pursue a "Test and Trash" methodology to achieve agile software development lifecycles. For example, an organization in pursuit of agile techniques may change up to 30% of an application with an application lifecycle of 8 weeks. Without giving the change much thought, up to 30% of their recorded tests break!
We recommend a component approach to building tests. Test components perform specific test operations. We write or record tests as individuals components of test function. For example, a component operates the sign-in function of a private Web application. When the sign-in portion of the application changes, we only need to change the sign-in test and the rest of test continues to perform normally.
Selenium supports the component approach in three ways: Selenium IDE supports Test Suites and Test Cases, exporting Selenium tests to dynamic languages (Java, Ruby, Perl, etc.) creates reusable software classes, and 3) PushToTest TestMaker supports multiple use cases with parameterized test use cases.
In Selenium IDE, the File menu enables tests to be saved as test cases or test suites. Record a test, use File -> Save Test Case. Create a second Test Case by choosing File -> New Test Case. Record the second test use case. Save the TestSuite for these two test use cases by choosing File -> Save TestSuite. Click the "Run entire test suite" icon from the Selenium IDE tool bar.
TestMaker defines test use cases using a simple XML notation:
<usecases> <usecase name="MailerCheck_usecase"> <test> <run name="LogIn" testclass="Login.selenium" instance="myinst" method="runSeleneseFile" langtype="selenium"> </run> <run name="OrderProduct" testclass="OrderProduct.selenium" instance="myinst" method="runSeleneseFile" langtype="selenium"> </run> </test> </usecase> </usecases>
Selenium offers no results reporting capability of its own. Two options are available: 1) Write your tests as a set of JUnit tests and use JUnit Report (http://ant.apache.org/manual/OptionalTasks/junitreport.html) to plot success/failure charts, 2) Use PushToTest TestMaker Results Analysis Engine to produce more than 300 charts from the transaction and step time tracking of Selenium tests.
For example, TestMaker tracks Selenium command duration in a test suite or test case. Consider the following chart. This shows the "Step" time it takes to process each Selenium command in a test use case over 10 equal periods of time that the test took to operate.
Test Maker allows repurposing Selenium tests as load test service monitors. http://www.pushtotest.com
BrowserMob facilitates low-cost Selenium load testing. http://browsermob.com/load-testing
SauceLabs provides a farm of Selenium RC servers for testing. http://saucelabs.com/
ThoughtWorks Twist can be used for test authoring and management. http://studios.thoughtworks.com/twist-agile-test-automation
Running a Selenium test as a functional test in TestMaker. TestMaker displays the success/failure of each command in the test and the duration in milliseconds of each step.
The Future, Selenium 2.0 (AKA Webdriver )
The Selenium Project started the WebDriver project, to be delivered as Selenium 2.0. WebDriver is a new architecture that plays Selenium tests by driving the browser through its native interface. This solves the test playback stability issue in Selenium 1.0 but requires the Selenium project to maintain individual API drivers for all the supported browsers. While there is no release date for Selenium 2.0, the WebDriver code is already functional and available for download at http://code.google.com/p/webdriver.
SkillsMatter.com, Think88com, PushToTest.com, RTTSWeb.com, and Scott Bellware (http://blog.scottbellware.com) offer training courses fro Selenium. PushToTest offers free Open Source Test Workshops (http://workshop.pushtotest.com) as a meet-up for Selenium and other Open Source Test tool users.
About The name Selenium
Selenium lore has it that the originators chose the name of Selenium after learning that Selenium is the antidote to Mercury poisoning. There appears to be no love between the Selenium team and HP Mercury, but perhaps a bit of envy