Selenium HTML Launcher (selenium_html.jar)

The Selenium HTML launcher allows interfacing with Selenium HTML tests.
It has been tested with Selenium 1.0.


Configuration

The selenium_html.xml file allows pre-configuring the launcher with some default values:


Parameter Description
General
Test root path This must indicate where are located all the Selenium HTML tests.
This is a root path. Each test in XStudio has a canonical path that will be appended to this path.
This path MUST not include an ending slash.

Default value is: C:/tests/Selenium/html
Selenium - HTML
Java install path This must indicate the path to the java install.

Default value is: C:/Program Files/Java/jdk1.6.0_06
Server JAR path This must indicate the path to the Selenium Remote Control Server.

Default value is: C:/Program Files/Selenium-1.0/selenium-remote-control-1.0.1/selenium-server-1.0.1/selenium-server.jar
Server options This may indicate optional arguments to pass to the Selenium Remote Control Server.

Default value is: -singleWindow -trustAllSSLCertificates
Browser This must indicate which browser to use to run the tests. Plese refer to Selenium documentation to know which string to use (as of Today it can be also firefox or chrome).

Default value is: iehta
Domain URL This must indicate the URL of the web site under testing.

Default value is: http://www.xqual.com


These values can be changed while creating the campaign session from XStudio.


Requirements

The tests are executed by the launcher using this syntax:


"<javaInstallPath>/bin/java.exe" -jar "<seleniumServerJarPath>" <seleniumServerOptions>
-htmlSuite "*<browser>" "<domainUrl>" "<testRootPath>/<testPath>/<testName>.html"
"selenium_server_report.html" -log "selenium_server_traces.txt"

And this is executed from the working directory <testRootPath>


The test will be marked as passed or failed depending on the report and traces generated by Selenium. The report and the execution traces are also attached to the testcase execution in XStudio.


Tutorial: Creating and executing Selenium HTML tests

In this tutorial, we will learn to run some Selenium HTML test scripts.


Prerequisites

Install Selenium 1.0 in the folder C:\Externals\Selenium-1.0


Create a file C:\tests\selenium\html\example\basic_test.html and edit it with the following content:


<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head profile="http://selenium-ide.openqa.org/profiles/test-case">
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <link rel="selenium.base" href="http://www.xqual.com/" />
    <title>basic_test
    </title>
  </head>
  <body>
    <table cellpadding="1" cellspacing="1" border="1">
      <thead>
        <tr>
          <td rowspan="1" colspan="3">basic_test</td>
        </tr>
      </thead>
      <tbody>
        <tr><td>open</td><td>/</td><td></td></tr>
      </tbody>
    </table>
  </body>
</html>

Create a dedicated category for Selenium HTML tests and create a test

  • create a category Selenium HTML associated to the launcher selenium_html.jar
  • under this category, create (somewhere in the tree) a test with name basic_test and with a canonical path set to example.



Creating a test campaign

  • create a campaign including only the test basic_test
  • create a campaign session specifying in the configuration:
    • Test root path: C:/tests/selenium/html.
    • Java install path: C:/Program Files/Java/jdk1.6.0_06
    • Server Jar Path:
      C:/Externals/Selenium-1.0/selenium-remote-control-1.0.1/selenium-server-1.0.1/selenium-server.jar
    • Browser: iehta
    • Domain URL: http://www.xqual.com



Run a campaign session

Run the campaign session