Package com.vaadin.testbench.parallel

Class ParallelTest

java.lang.Object

com.vaadin.testbench.TestBenchTestCase

com.vaadin.testbench.parallel.ParallelTest

All Implemented Interfaces:

HasDriver, HasElementQuery, HasSearchContext, HasTestBenchCommandExecutor

public class ParallelTest
extends TestBenchTestCase

Unit tests should extend ParallelTest if they are to be run in several browser configurations. For each browser configuration, a WebDriver is properly created with the desired configuration.

You can configure your tests to be run in Sauce Labs. See details at https://wiki.saucelabs.com and https://github.com/vaadin/testbench-demo.

Field Summary

Fields

Modifier and Type	Field	Description
ScreenshotOnFailureRule	screenshotOnFailure

Fields inherited from class com.vaadin.testbench.TestBenchTestCase

driver, maxAttempts, testbenchVersion

Constructor Summary

Constructors

Constructor	Description
ParallelTest()

Method Summary

Modifier and Type	Method	Description
static List<org.openqa.selenium.remote.DesiredCapabilities>	getDefaultCapabilities()
protected org.openqa.selenium.remote.DesiredCapabilities	getDesiredCapabilities()	Gets the DesiredCapabilities (usually browser name and version)
protected String	getHubHostname()	Returns the hostname of the hub where test is to be run on.
protected String	getHubURL()	Returns the complete URL of the hub where the tests will be run on.
protected Browser	getRunLocallyBrowser()
protected String	getRunLocallyBrowserVersion()
protected RunOnHub	getRunOnHub(Class<?> klass)
void	setDesiredCapabilities(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)	Sets the requested DesiredCapabilities (usually browser name and version)
void	setup()	Sets the driver for this test instance.

Methods inherited from class com.vaadin.testbench.TestBenchTestCase

concatUrl, executeScript, findElement, findElements, getCommandExecutor, getContext, getDriver, setDriver, testBench, waitUntil, waitUntil, wrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.testbench.HasElementQuery

$, $

Field Detail

screenshotOnFailure

public ScreenshotOnFailureRule screenshotOnFailure

Constructor Detail

ParallelTest

public ParallelTest()

Method Detail

getHubURL

protected String getHubURL()

Returns the complete URL of the hub where the tests will be run on. Used by setup(), for the creation of the WebDriver.

This method uses getHubHostname() to build the complete address of the Hub. Override in order to define a different hub address.

You can provide sauce.user and sauce.sauceAccessKey system properties or SAUCE_USERNAME and SAUCE_ACCESS_KEY environment variables to run the tests in Sauce Labs. If both system property and environment variable is defined, system property is prioritised.

Returns:

the complete URL of the hub where the tests will be run on. Used by setup(), for the creation of the WebDriver.

getHubHostname

protected String getHubHostname()

Returns the hostname of the hub where test is to be run on. If unit test is annotated by RunLocally, this method returns localhost. Otherwise, it will return the host defined by the com.vaadin.testbench.Parameters.hubHostname system parameter or the host defined using a RunOnHub annotation.

This method is used by getHubURL() to get the full URL of the hub to run tests on.

Returns:

the hostname of the hub where test is to be run on.

setup

public void setup()
           throws Exception

Sets the driver for this test instance. Uses SetupDriver.setupRemoteDriver(String) or SetupDriver.setupLocalDriver(Browser) according to the annotations found in current test case.

RunOnHub annotation can be used on the test case class to define a test hub's hostname for the driver to connect to it.
RunLocally annotation can be used on the test case class to force the driver to connect to localhost (RunLocally annotation overrides RunOnHub annotation).

Throws:

Exception - if unable to instantiate WebDriver

getRunOnHub

protected RunOnHub getRunOnHub(Class<?> klass)

Returns:

Value of the RunOnHub annotation of current Class, or null if annotation is not present.

getRunLocallyBrowser

protected Browser getRunLocallyBrowser()

Returns:

Browser value of the RunLocally annotation of current Class, or null if annotation is not present.

getRunLocallyBrowserVersion

protected String getRunLocallyBrowserVersion()

Returns:

Version value of the RunLocally annotation of current Class, or empty empty String if annotation is not present.

getDefaultCapabilities

public static List<org.openqa.selenium.remote.DesiredCapabilities> getDefaultCapabilities()

Returns:

default capabilities, used if no BrowserConfiguration method was found

setDesiredCapabilities

public void setDesiredCapabilities(org.openqa.selenium.remote.DesiredCapabilities desiredCapabilities)

Sets the requested DesiredCapabilities (usually browser name and version)

Parameters:

desiredCapabilities -

getDesiredCapabilities

protected org.openqa.selenium.remote.DesiredCapabilities getDesiredCapabilities()

Gets the DesiredCapabilities (usually browser name and version)

Returns: