Package org.openqa.selenium.remote

Class RemoteWebDriverBuilder

java.lang.Object
org.openqa.selenium.remote.RemoteWebDriverBuilder
@Beta public class RemoteWebDriverBuilder extends 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")
     .setCapability("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 address(URI) is made, the builder will use ServiceLoader to find all instances of WebDriverInfo and will call WebDriverInfo.createDriver(Capabilities) for the first supported set of capabilities.

  • Method Details

    • 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(String key, 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(String capabilityName, Object 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 capabilities added via addAlternative(Capabilities) or oneOf(Capabilities, Capabilities...) even after this method call.

    • address

      public RemoteWebDriverBuilder address(String uri)
      See Also:

    • address

      public RemoteWebDriverBuilder address(URL url)
      See Also:

    • address

      public RemoteWebDriverBuilder address(URI uri)
      Set the URI of the remote server. If this URI 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).

    • authenticateAs

      public RemoteWebDriverBuilder authenticateAs(org.openqa.selenium.UsernameAndPassword usernameAndPassword)

    • config

      public RemoteWebDriverBuilder config(org.openqa.selenium.remote.http.ClientConfig config)
      Allows precise control of the ClientConfig to use with remote instances. If ClientConfig.baseUri(URI) has been called, then that will be used as the base URI for the session.

    • 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 address(URI).

    • augmentUsing

      public RemoteWebDriverBuilder augmentUsing(Augmenter augmenter)
      Parameters:
      augmenter - The Augmenter to use when creating the WebDriver instance.

    • build

      public org.openqa.selenium.WebDriver build()
      Actually create a new WebDriver session. The returned webdriver is not guaranteed to be a RemoteWebDriver.