org.openqa.selenium.opera

Class OperaOptions

java.lang.Object

org.openqa.selenium.MutableCapabilities

org.openqa.selenium.opera.OperaOptions

All Implemented Interfaces:

java.io.Serializable, Capabilities

public class OperaOptions
extends MutableCapabilities

Class to manage options specific to OperaDriver.

Example usage:

 OperaOptions options = new OperaOptions()
 options.addExtensions(new File("/path/to/extension.crx"))
 options.setBinary(new File("/path/to/chrome"));

 // For use with OperaDriver:
 OperaDriver driver = new OperaDriver(options);

 // For use with RemoteWebDriver:
 OperaOptions options = new OperaOptions();
 RemoteWebDriver driver = new RemoteWebDriver(
     new URL("http://localhost:4444/wd/hub"), options);
 

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CAPABILITY Key used to store a set of OperaOptions in a Capabilities object.

Constructor Summary

Constructors

Constructor and Description
OperaOptions()

Method Summary

Modifier and Type	Method and Description
OperaOptions	addArguments(java.util.List<java.lang.String> arguments) Adds additional command line arguments to be used when starting Opera.
OperaOptions	addArguments(java.lang.String... arguments)
OperaOptions	addEncodedExtensions(java.util.List<java.lang.String> encoded) Adds a new Opera extension to install on browser startup.
OperaOptions	addEncodedExtensions(java.lang.String... encoded)
OperaOptions	addExtensions(java.io.File... paths)
OperaOptions	addExtensions(java.util.List<java.io.File> paths) Adds a new Opera extension to install on browser startup.
java.util.Map<java.lang.String,?>	asMap()
java.lang.Object	getExperimentalOption(java.lang.String name) Returns the value of an experimental option.
OperaOptions	setBinary(java.io.File path) Sets the path to the Opera executable.
OperaOptions	setBinary(java.lang.String path) Sets the path to the Opera executable.
OperaOptions	setExperimentalOption(java.lang.String name, java.lang.Object value) Sets an experimental option.

Methods inherited from class org.openqa.selenium.MutableCapabilities

amendHashCode, equals, getCapability, hashCode, merge, setCapability, setCapability, setCapability, setCapability, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openqa.selenium.Capabilities

getBrowserName, getPlatform, getVersion, is, isJavascriptEnabled

Field Detail

CAPABILITY

public static final java.lang.String CAPABILITY

Key used to store a set of OperaOptions in a Capabilities object.

See Also:

Constant Field Values

Constructor Detail

OperaOptions

public OperaOptions()

Method Detail

setBinary

public OperaOptions setBinary(java.io.File path)

Sets the path to the Opera executable. This path should exist on the machine which will launch Opera. The path should either be absolute or relative to the location of running OperaDriver server.

Parameters:

path - Path to Opera executable.

setBinary

public OperaOptions setBinary(java.lang.String path)

Sets the path to the Opera executable. This path should exist on the machine which will launch Opera. The path should either be absolute or relative to the location of running OperaDriver server.

Parameters:

path - Path to Opera executable.

addArguments

public OperaOptions addArguments(java.lang.String... arguments)

Parameters:

arguments - The arguments to use when starting Opera.

See Also:

addArguments(java.util.List)

addArguments

public OperaOptions addArguments(java.util.List<java.lang.String> arguments)

Adds additional command line arguments to be used when starting Opera. For example:

   options.setArguments(
       "load-extension=/path/to/unpacked_extension",
       "allow-outdated-plugins");
 

Each argument may contain an option "--" prefix: "--foo" or "foo". Arguments with an associated value should be delimitted with an "=": "foo=bar".

Parameters:

arguments - The arguments to use when starting Opera.

addExtensions

public OperaOptions addExtensions(java.io.File... paths)

Parameters:

paths - Paths to the extensions to install.

See Also:

addExtensions(java.util.List)

addExtensions

public OperaOptions addExtensions(java.util.List<java.io.File> paths)

Adds a new Opera extension to install on browser startup. Each path should specify a packed Opera extension (CRX file).

Parameters:

paths - Paths to the extensions to install.

addEncodedExtensions

public OperaOptions addEncodedExtensions(java.lang.String... encoded)

Parameters:

encoded - Base64 encoded data of the extensions to install.

See Also:

addEncodedExtensions(java.util.List)

addEncodedExtensions

public OperaOptions addEncodedExtensions(java.util.List<java.lang.String> encoded)

Adds a new Opera extension to install on browser startup. Each string data should specify a Base64 encoded string of packed Opera extension (CRX file).

Parameters:

encoded - Base64 encoded data of the extensions to install.

setExperimentalOption

public OperaOptions setExperimentalOption(java.lang.String name,
                                          java.lang.Object value)

Sets an experimental option. Useful for new OperaDriver options not yet exposed through the OperaOptions API.

Parameters:

name - Name of the experimental option.

value - Value of the experimental option, which must be convertible to JSON.

getExperimentalOption

public java.lang.Object getExperimentalOption(java.lang.String name)

Returns the value of an experimental option.

Parameters:

name - The option name.

Returns:

The option value, or null if not set.

asMap

public java.util.Map<java.lang.String,?> asMap()

Specified by:

asMap in interface Capabilities

Overrides:

asMap in class MutableCapabilities

Returns:

The capabilities as a Map