org.openqa.selenium.remote

Class RemoteWebDriverBuilder

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriverBuilder

@Beta
public class RemoteWebDriverBuilder
extends java.lang.Object

Create a new Selenium session using the W3C WebDriver protocol. This class will not generate any data expected by the original JSON Wire Protocol, so will fail to create sessions as expected if used against a server that only implements that protocol.

Expected usage is something like:

   WebDriver driver = RemoteWebDriver.builder()
     .addAlternative(new FirefoxOptions())
     .addAlternative(new ChromeOptions())
     .addMetadata("cloud:key", "hunter2")
     .setCapabilitiy("proxy", new Proxy())
     .build();
 

In this example, we ask for a session where the browser will be either Firefox or Chrome (we don't care which), but where either browser will use the given Proxy. In addition, we've added some metadata to the session, setting the "cloud.key" to be the secret passphrase of our account with the cloud "Selenium as a Service" provider.

If no call to withDriverService(DriverService) or url(URL) is made, the builder will use ServiceLoader to find all instances of DriverService.Builder and will call DriverService.Builder#score(Capabilities) for each alternative until a new session can be created.

Method Summary

Modifier and Type	Method and Description
RemoteWebDriverBuilder	addAlternative(org.openqa.selenium.Capabilities options) Add to the list of possible configurations that might be asked for.
RemoteWebDriverBuilder	addMetadata(java.lang.String key, java.lang.Object value) Adds metadata to the outgoing new session request, which can be used by intermediary of end nodes for any purpose they choose (commonly, this is used to request additional features from cloud providers, such as video recordings or to set the timezone or screen size).
org.openqa.selenium.WebDriver	build() Actually create a new WebDriver session.
RemoteWebDriverBuilder	oneOf(org.openqa.selenium.Capabilities maybeThis, org.openqa.selenium.Capabilities... orOneOfThese) Clears the current set of alternative browsers and instead sets the list of possible choices to the arguments given to this method.
RemoteWebDriverBuilder	setCapability(java.lang.String capabilityName, java.lang.String value) Sets a capability for every single alternative when the session is created.
RemoteWebDriverBuilder	url(java.lang.String url)
RemoteWebDriverBuilder	url(java.net.URL url) Set the URL of the remote server.
RemoteWebDriverBuilder	withDriverService(DriverService service) Use the given DriverService to set up the webdriver instance.

Methods inherited from class java.lang.Object

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

Method Detail

oneOf

public RemoteWebDriverBuilder oneOf(org.openqa.selenium.Capabilities maybeThis,
                                    org.openqa.selenium.Capabilities... orOneOfThese)

Clears the current set of alternative browsers and instead sets the list of possible choices to the arguments given to this method.

addAlternative

public RemoteWebDriverBuilder addAlternative(org.openqa.selenium.Capabilities options)

Add to the list of possible configurations that might be asked for. It is possible to ask for more than one type of browser per session. For example, perhaps you have an extension that is available for two different kinds of browser, and you'd like to test it).

addMetadata

public RemoteWebDriverBuilder addMetadata(java.lang.String key,
                                          java.lang.Object value)

Adds metadata to the outgoing new session request, which can be used by intermediary of end nodes for any purpose they choose (commonly, this is used to request additional features from cloud providers, such as video recordings or to set the timezone or screen size). Neither parameter can be null.

setCapability

public RemoteWebDriverBuilder setCapability(java.lang.String capabilityName,
                                            java.lang.String value)

Sets a capability for every single alternative when the session is created. These capabilities are only set once the session is created, so this will be set on capabiltiies added via addAlternative(Capabilities) or oneOf(Capabilities, Capabilities...) even after this method call.

url

public RemoteWebDriverBuilder url(java.lang.String url)

See Also:

url(URL)

url

public RemoteWebDriverBuilder url(java.net.URL url)

Set the URL of the remote server. If this URL is not set, then it assumed that a local running remote webdriver session is needed. It is an error to call this method and also withDriverService(DriverService).

withDriverService

public RemoteWebDriverBuilder withDriverService(DriverService service)

Use the given DriverService to set up the webdriver instance. It is an error to set both this and also call url(URL).

build

public org.openqa.selenium.WebDriver build()

Actually create a new WebDriver session. The returned webdriver is not guaranteed to be a RemoteWebDriver.