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.
protected int	amendHashCode() Subclasses can use this to add information that isn't always in the capabilities map.
java.util.Map<java.lang.String,java.lang.Object>	asMap()
boolean	equals(java.lang.Object o)
java.lang.Object	getCapability(java.lang.String capabilityName)
java.lang.Object	getExperimentalOption(java.lang.String name) Returns the value of an experimental option.
Platform	getPlatform()
int	hashCode()
OperaOptions	merge(Capabilities extraCapabilities) Merges the extra capabilities provided into this DesiredCapabilities instance.
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.
OperaOptions	setProxy(Proxy proxy)
java.util.Map<java.lang.String,java.lang.Object>	toJson()
java.lang.String	toString()

Methods inherited from class org.openqa.selenium.MutableCapabilities

setCapability, setCapability, setCapability, setCapability

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.Capabilities

getBrowserName, 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

merge

public OperaOptions merge(Capabilities extraCapabilities)

Description copied from class: MutableCapabilities

Merges the extra capabilities provided into this DesiredCapabilities instance. If capabilities with the same name exist in this instance, they will be overridden by the values from the extraCapabilities object.

Specified by:

merge in interface Capabilities

Overrides:

merge in class MutableCapabilities

Parameters:

extraCapabilities - Additional capabilities to be added.

Returns:

DesiredCapabilities after the merge

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.

setProxy

public OperaOptions setProxy(Proxy proxy)

asMap

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

Specified by:

asMap in interface Capabilities

Returns:

The capabilities as a Map

getPlatform

public Platform getPlatform()

Specified by:

getPlatform in interface Capabilities

getCapability

public java.lang.Object getCapability(java.lang.String capabilityName)

Specified by:

getCapability in interface Capabilities

Parameters:

capabilityName - The capability to return.

Returns:

The value, or null if not set.

See Also:

CapabilityType

toJson

public java.util.Map<java.lang.String,java.lang.Object> toJson()

amendHashCode

protected int amendHashCode()

Subclasses can use this to add information that isn't always in the capabilities map.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object