Selenium is a testing tool that automates web applications. It can also be used to automate basic browser functions and administration tasks.

Quick Info

HCL Launch
HCL Launch version 7.0 or later
Created by
HCL Software
Updated Date
March 23, 2021
Version Name Modified date Action

8.1100926 16-Mar-2021 14:06



This plugin includes one or more steps, click Steps for step details and properties.


This plugin requires HCL Launch version 7.0 or later.

This plugin runs on all operating systems that HCL Launch supports.

This plugin requires access to either the Selenium RC (1.0), Selenium Webdriver (2.X) Standalone Server JAR file, or Selenium Html Runner (3.X) JAR file. The selenium-server-standalone-2.XX.X.jar and selenium-html-runner-3.XX.X.jar files can be found on Seleniums Download page under previous releases. Note: Version 3 of the selenium-server-standalone JAR will require additional environment set up. For simplicity, we recommend the latest selenium-html-runner JAR.


See Installing plugins in HCL Launch for installing and removing plugins.


The following table describes the changes made in each plugin version.

Plugin history details
Version Description
  • Enhance usability and improve logging of the Selenium automation plugin.
  • The Test Results file path and result, totalTime, numTestTotal, numTestPasses, numTestFailures, numCommandPasses, numCommandFailures, and numCommandErrors test suite results are recorded as output properties.
  • Fix APAR PI82820 Selenium plugin fails with IndexOutOfBoundsException
  • Support for Selenium v2 and v3 has been added. If running Selenium v2, specify the selenium-server-standalone-2.XX.X.jar. If running Selenium v3, specify the selenium-html-runner-3.XX.X.jar.
  • The Test Results file is now an optional property. A file or folder, depending on version of Selenium, named testResults will be created as necessary.


The Run Test Suite step automates running of a Selenium test suite in an IBM Urban Code Deploy process. The step starts a temporary Selenium server and passes the specified test suite, which contains one or more tests, to be processed. The test suite can be created using Seleniums IDE and is written in a format called Selenese. The prior link is to documentation about Seleniums IDE and instructions on how to create a test and test suite. If this is your first time using Selenium, we recommend you start here. Once you have a firm understanding of Selenium and its uses, we encourage you to replicate the short tutorial below.

Step palette

To access this plugin in the palette, click Quality > Functional Testing > Selenium.


The following process steps are available in the Selenium plugin.

Run Test Suite

Run a Selenium test suite

Input properties for the Run Test Suite step
Name Type Description Required
Selenium Jar Location String The fully-qualified path to the selenium-server-standalone (v2) or selenium-html-runner (v3) JAR file. For example: C:\Program Files\Selenium\selenium-server-standalone-2.53.1.jar. Yes
Starting URL String The starting URL on which to execute the tests. For example: Yes
Test Failure Threshold String The maximum percentage of failed tests that, if surpassed, results in the steps failure. Specify a value from 0 to 100. A value of 0 will have the step fail on any failure. A value of 100 ignores test results and always succeed if there are no runtime errors. Default value is 100. No
Test Results String The fully-qualified path of the test results file or folder. If using a selenium-server-standalone-2.X.X.jar, specify a file. If using a selenium-html-runner-3.X.X.jar, specify a folder. For example: C:\Documents\testResults[.html]. If left empty, a file/folder named `testResults`is generated in the working directory. No
Test Suite String The fully-qualified path to the HTML suite file. For example: C:\Documents\testSuite.html. Yes
Web Browser String The web browser to run the tests. For example: *firefox. Yes