WebDriver Customization

The jamine-maven-plugin ships with HtmlUnitDriver by default but it is also possible to change to any other WebDriver implementation and configure it with Capabilities.

Changing the implementation

The webDriverClassName parameter allows you to specify the WebDriver implementation you would like to use in place of HtmlUnitDriver. The WebDriver implementation must either have a constructor that excepts no arguments or a constructor that accepts a single Capabilities argument.

Here is an example using FirefoxDriver:

<build>
  <plugins>
    <plugin>
      <groupId>com.github.searls</groupId>
      <artifactId>jasmine-maven-plugin</artifactId>
      <version>2.2<version>
      <executions>
        <execution>
          <goals>
            <goal>test</goal>
          </goals>
          <configuration>
            <webDriverClassName>org.openqa.selenium.firefox.FirefoxDriver</webDriverClassName>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

Setting capabilities

You can configure your WebDriver implementation using Capabilities as a simple String, List, or a Map. The capabilities are configured using the webDriverCapabilities parameter and you may provide multiple capabilities.

Capability as a String

<webDriverCapabilities>
  <capability>
    <name>phantomjs.binary.path</name>
    <value>/opt/phantomjs/bin/phantomjs</value>
  </capability>
</webDriverCapabilities>

Capability as a List

<webDriverCapabilities>
  <capability>
    <name>phantomjs.cli.args</name>
    <list>
      <value>--disk-cache=true</value>
      <value>--max-disk-cache-size=256</value>
    </list>
  </capability>
</webDriverCapabilities>

Capability as a Map

<webDriverCapabilities>
  <capability>
    <name>proxy</name>
    <map>
      <httpProxy>myproxyserver.com:8000</httpProxy>
    </map>
  </capability>
</webDriverCapabilities>

You will need to consult with your WebDriver implementation to determine what capabilities are possible. If a capability can not be provided as either a String, List, or Map then it is currently not supported.

Lastly, we do not test every possible WebDriver implementation with every possible permutation of capabilities so it is very possible that they will not work. Feel free to file a bug if you come across such a capability that you feel should be supported.

Examples

Configuring the default HtmlUnitDriver to use a proxy:

<plugin>
  <groupId>com.github.searls</groupId>
  <artifactId>jasmine-maven-plugin</artifactId>
  <version>2.2<version>
  <executions>
    <execution>
      <goals>
        <goal>test</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <webDriverCapabilities>
      <capability>
        <name>proxy</name>
        <map>
          <httpProxy>myproxyserver.com:8000</httpProxy>
        </map>
      </capability>
    </webDriverCapabilities>
  </configuration>
</plugin>

Configuring PhantomJSDriver with custom binary path and caching settings:

<plugin>
  <groupId>com.github.searls</groupId>
  <artifactId>jasmine-maven-plugin</artifactId>
  <version>2.2<version>
  <executions>
    <execution>
      <goals>
        <goal>test</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <webDriverClassName>org.openqa.selenium.phantomjs.PhantomJSDriver</webDriverClassName>
    <webDriverCapabilities>
      <capability>
        <name>phantomjs.binary.path</name>
        <value>/opt/phantomjs/bin/phantomjs</value>
      </capability>
      <capability>
        <name>phantomjs.cli.args</name>
        <list>
          <value>--disk-cache=true</value>
          <value>--max-disk-cache-size=256</value>
        </list>
      </capability>
    </webDriverCapabilities>
  </configuration>
</plugin>