Selenium Plugin - Introduction

Overview

The Selenium plugin for SKF currently allows the integration of the following types of java Selenium Tests :

• Selenium 2

  • jUnit 3-based tests
  • jUnit 4-based tests

Selenium Tests must be included in the test project as java sources, and their non-selenium dependencies (if any) packaged as maven2 dependencies and declared in the squash-ta-mavin-plugin dependencies. The source code and resources are compiled each time before the test is executed. For more details, see the Converters section.

If you are looking for information on how to import your existing selenium tests, see the importing legacy tests section.

NB : A working installation of the target browser is required on the machine where the tests are run.

---

Organizing selenium-related files in your Squash TF project

‘File to script.java.selenium2’ converter works from a file resource that is in fact a bundle (a group of files). This group of files may contain java sources and various resources. All sources and resources used by the test must be included in the file bundle.

This means that they must be all grouped in a directory that will be loaded as a file resource, and then converted to a script.java.selenium2 resource.

As in usual java code and resources, the directory structure defines packages in which the classes and resources are located. As in the maven convention, source files will be searched for in the ‘<base>/java’ directory, and any directory under ‘<base>/java’ will define a package level. Resources will be searched for in the same way under ‘<base>/resources’.

Regarding binary dependencies (as opposed to helper source code, which must be included in the selenium test resource directory), they must be provided as maven jars included in the plugin dependencies like so :

Extract from test project pom.xml file

...
<plugin>
    <groupId>org.squashtest.ta</groupId>
    <artifactId>squash-ta-maven-plugin</artifactId>
    <version>1.1.0</version>

    <dependencies>
    ...
    <!-- example of a Selenium test dependency -->
        <dependency>
            <groupId>net.sourceforge.javacsv</groupId>
            <artifactId>javacsv</artifactId>
            <version>2.0</version>
        </dependency>
    ...
    </dependencies>
    ...
</plugin>
...

---

Importing legacy Selenium tests

To import your Selenium tests into your Squash TF test projects, just copy your test source tree (with code AND resources) under a single subdirectory in the ‘squashTA/resources’ directory. For example, if your test source code and resources where under ‘src/test/java’ and ‘src/test/resources’ respectively, you just have to copy the java and test directories in the ‘squashTA/resources/seleniumTests’ subdirectory :

Now, you just have to load ‘seleniumTests’ as a resource to use it in your test.