com.vaadin.testbench.parallel.
Class ParallelTest
All Implemented Interfaces:
HasDriver
, HasElementQuery
, HasSearchContext
, HasTestBenchCommandExecutor
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
FieldsFields inherited from class com.vaadin.testbench.TestBenchTestCase
driver, maxAttempts
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic List<org.openqa.selenium.remote.DesiredCapabilities>
protected org.openqa.selenium.remote.DesiredCapabilities
Gets the
DesiredCapabilities
(usually browser name and version)protected String
Returns the hostname of the hub where test is to be run on.
protected String
Returns the complete URL of the hub where the tests will be run on.
protected Browser
protected String
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 Details
-
screenshotOnFailure
-
-
Constructor Details
-
ParallelTest
public ParallelTest()
-
-
Method Details
-
getHubURL
Returns the complete URL of the hub where the tests will be run on. Used by
setup()
, for the creation of theWebDriver
.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 theWebDriver
. -
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 thecom.vaadin.testbench.Parameters.hubHostname
system parameter or the host defined using aRunOnHub
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
Sets the driver for this test instance. Uses
SetupDriver.setupRemoteDriver(String)
orSetupDriver.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 overridesRunOnHub
annotation).Throws:
Exception
- if unable to instantiateWebDriver
-
getRunOnHub
-
getRunLocallyBrowser
Returns:
Browser value of the
RunLocally
annotation of current Class, or null if annotation is not present. -
getRunLocallyBrowserVersion
Returns:
Version value of the
RunLocally
annotation of current Class, or empty empty String if annotation is not present. -
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
- to be set -
getDesiredCapabilities
protected org.openqa.selenium.remote.DesiredCapabilities getDesiredCapabilities()Gets the
DesiredCapabilities
(usually browser name and version)Returns:
the
DesiredCapabilities
-