OperaSettings.Capability (OperaDriver 1.1 API)

java.lang.Object
- java.lang.Enum<OperaSettings.Capability>
- - com.opera.core.systems.OperaSettings.Capability

All Implemented Interfaces:

Serializable, Comparable<OperaSettings.Capability>

Enclosing class:

OperaSettings
```
public static enum OperaSettings.Capability
extends Enum<OperaSettings.Capability>
```
The capabilities specifically available to Opera. The capabilities may be used with DesiredCapabilities.opera().

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ARGUMENTS` (String) Arguments to pass to Opera, separated by spaces.
`AUTOSTART` (Boolean) Whether to auto-start the Opera binary.
`BACKEND` Deprecated.
`BINARY` (String/File) Path to the Opera binary to use.
`DETACH` (Boolean) Whether to detach the Opera browser when the driver shuts down.
`DISPLAY` (Integer) The X display to use.
`EMULATION_PROFILE` (EmulationProfile/MobileDevices/String) Allows emulation of specific devices for (currently only) Opera Mobile.
`HOST` (String) The host Opera should connect to.
`LAUNCHER` (String) Path to the launcher binary to use.
`LOGGING_FILE` (String/File) Where to send the output of the logging.
`LOGGING_LEVEL` (String/Level/Integer) How verbose the logging should be.
`NO_QUIT` Deprecated. replaced by `DETACH`
`NO_RESTART` Deprecated.
`OPERAIDLE` (Boolean) Whether to use Opera's alternative implicit wait implementation.
`PORT` (Integer) The port to Opera should connect to.
`PRODUCT` (String) The product we are using, for example `OperaProduct.DESKTOP` or `OperaProduct.CORE`.
`PROFILE` (OperaProfile/String) Directory of the profile to use, or an `OperaProfile` instance object representing a profile.
`PROXY` (Proxy/Proxy JSON object) Details of any proxy to use.
`RUNNER` (Class/String) Allows you to specify which mechanism to use for managing and controlling the Opera binary process from OperaDriver.

Method Summary

Methods
Modifier and Type	Method and Description
`static OperaSettings.Capability`	`findCapability(String capabilityName)` Looks up a capability by its capability name.
`String`	`getCapability()` Gets the string representation of this capability for use in `DesiredCapabilities`.
`String`	`getIdentifier()` Returns the identifier of the capability (used in `OperaSettings` without it's `CAPABILITY_PREFIX`.
`String`	`toString()` Gets the string representation of this capability.
`static OperaSettings.Capability`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static OperaSettings.Capability[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - LOGGING_LEVEL
```
public static final OperaSettings.Capability LOGGING_LEVEL
```
    (String/Level/Integer) How verbose the logging should be. Available levels are: SEVERE (highest value), WARNING, INFO, CONFIG, FINE, FINER, FINEST (lowest value), ALL, OFF. Default is INFO. The argument may consist of either a level name as a string, an integer value, a Level reference, or null. If the value is neither of a known name nor an integer, an IllegalArgumentException will be thrown.
  - LOGGING_FILE
```
public static final OperaSettings.Capability LOGGING_FILE
```
    (String/File) Where to send the output of the logging. Default is to not write to file.
  - BINARY
```
public static final OperaSettings.Capability BINARY
```
    (String/File) Path to the Opera binary to use. If not specified, OperaDriver will guess the path to your Opera installation (typically /usr/bin/opera, C:\Program Files\Opera\opera.exe, or similar).
  - ARGUMENTS
```
public static final OperaSettings.Capability ARGUMENTS
```
    (String) Arguments to pass to Opera, separated by spaces. See opera -help for available command-line switches.
  - HOST
```
public static final OperaSettings.Capability HOST
```
    (String) The host Opera should connect to. Since OperaDriver works in a client-server relationship to Opera (where Opera is the client, driver the server) you can also run remote instances of Opera on other devices; that be a phone, a TV or another computer.
  - PORT
```
public static final OperaSettings.Capability PORT
```
    (Integer) The port to Opera should connect to. Setting this capability to 0 will probe for a free, random port, setting it to -1 will ensure compatibility mode using port the default port 7001 for Operas version 11.52 or older.
  - LAUNCHER
```
public static final OperaSettings.Capability LAUNCHER
```
    (String) Path to the launcher binary to use. The launcher is an external wrapper around the browser, and is used for controlling the binary and taking external screenshots. If left blank, OperaDriver will use a launcher supplied with the package.
  - PROFILE
```
public static final OperaSettings.Capability PROFILE
```
    (OperaProfile/String) Directory of the profile to use, or an OperaProfile instance object representing a profile. If null is given, a random temporary directory is used. If "", an empty string, then the default ~/.autotest profile directory will be used (for backwards compatibility with Opera < 11.60).
  - OPERAIDLE
```
public static final OperaSettings.Capability OPERAIDLE
```
    (Boolean) Whether to use Opera's alternative implicit wait implementation. It will use an in-browser heuristic to guess when a page has finished loading, allowing us with great accuracy tell whether there are any planned events in the document. This functionality is useful for very simple test cases, but not designed for real-world testing. It is disabled by default.
  - DISPLAY
```
public static final OperaSettings.Capability DISPLAY
```
    (Integer) The X display to use. If set, Opera will be started on the specified display. (Only works on GNU/Linux.)
  - AUTOSTART
```
public static final OperaSettings.Capability AUTOSTART
```
    (Boolean) Whether to auto-start the Opera binary. If false, OperaDriver will wait for a connection from the browser. Go to "opera:debug", enter the correct host/port information, and hit "Connect" to connect manually.
  - PROXY
```
public static final OperaSettings.Capability PROXY
```
    (Proxy/Proxy JSON object) Details of any proxy to use. If no proxy is specified, whatever the system's current or default state is used. Accepted types are Proxy or a proxy JSON object like this:
```
   proxyType (string)
   (Required) The type of proxy being used.  Possible values are: direct, a
 direct connection where no proxy in use; manual, a manual proxy settings
 configured,
 e.g. setting a proxy for HTTP, a proxy for FTP, etc; pac, proxy auto configuration
 from a URL); autodetect, proxy auto detection, probably with WPAD; system,
 use system settings.

   proxyAutoconfigUrl (string)
   (Required if proxyType is "pac", ignored otherwise) Specifies the URL to be
 used for proxy auto configuration.  Expected format example:
 http://hostname.com:1234/pacfile

   ftpProxy, httpProxy, sslProxy (string)
   (Optional, ignored if proxyType is not "manual") Specifies the proxies to be used for
 FTP, HTTP and HTTPS requests respectively.  Behaviour is undefined if a request is made,
 where the proxy for the particular protocol is undefined, if proxyType is manual.
 Expected format example: hostname.com:1234
 
```
  - RUNNER
```
public static final OperaSettings.Capability RUNNER
```
    (Class/String) Allows you to specify which mechanism to use for managing and controlling the Opera binary process from OperaDriver. The value must be set to the qualified classpath for a class implementing the OperaRunner interface. OperaDriver ships with two implementations that can be used:
```
   com.opera.core.systems.runner.launcher.OperaLauncherRunner (default)
   Uses an external C++ wrapper to control the Opera binary.

   com.opera.core.systems.runner.inprocess.OperaInProcessRunner
   Uses a Java wrapper implementation to control the Opera binary.
 
```
  - EMULATION_PROFILE
```
public static final OperaSettings.Capability EMULATION_PROFILE
```
    (EmulationProfile/MobileDevices/String) Allows emulation of specific devices for (currently only) Opera Mobile. You can either provide your own profile configuration using the following JSON object:
```
   {
     width: INTEGER,
     height: INTEGER,
     ppi: INTEGER,
     input: "native", "touch", "keypad", or "tablet"
     userAgent: "Android", "Desktop", "MeeGo", or "S60"
   }
 
```
    Or use one of the predefined emulation profiles found in MobileDevices:
```
   capabilities.set("opera.emulationProfile", MobileDevices.SAMSUNG_GALAXY_NEXUS);
 
```
    Or provide your own profile using the Java builder:
```
   capabilities.set("opera.emulationProfile", OperaMobileEmulation.builder()
     .setResolution(new Dimension(480, 800)
     .setPPI(123)
     .setUserAgent(UserAgent.ANDROID)
     .setIME(IME.TABLET)
     .build());
 
```
  - NO_RESTART
```
@Deprecated
public static final OperaSettings.Capability NO_RESTART
```
    Deprecated.
    
    (Boolean) Whether to restart Opera on OperaDesktopDriver reinitialization. This option only applies to the Desktop Driver.
  - NO_QUIT
```
@Deprecated
public static final OperaSettings.Capability NO_QUIT
```
    Deprecated. replaced by DETACH
    
    (Boolean) Whether to quit Opera when OperaDriver is shut down. If enabled, it will keep the browser running after the driver is shut down.
  - DETACH
```
public static final OperaSettings.Capability DETACH
```
    (Boolean) Whether to detach the Opera browser when the driver shuts down. This will leave Opera running.
    
    Since:
    
    0.12
  - PRODUCT
```
public static final OperaSettings.Capability PRODUCT
```
    (String) The product we are using, for example OperaProduct.DESKTOP or OperaProduct.CORE.
  - BACKEND
```
@Deprecated
public static final OperaSettings.Capability BACKEND
```
    Deprecated.
    
    (String) Rendering backend used by internal builds of Opera. If null or an empty string, "software" is used by default. Warning: This is a temporary workaround for launcher not taking external window-only screenshots on Windows.
- Method Detail
  - values
```
public static OperaSettings.Capability[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (OperaSettings.Capability c : OperaSettings.Capability.values())
    System.out.println(c);
```
    Returns:
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static OperaSettings.Capability valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    name - the name of the enum constant to be returned.
    
    Returns:
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - getIdentifier
```
public String getIdentifier()
```
    Returns the identifier of the capability (used in OperaSettings without it's CAPABILITY_PREFIX.
    
    Returns:
    the unique identifier of a capability
  - getCapability
```
public String getCapability()
```
    Gets the string representation of this capability for use in DesiredCapabilities.
    
    Returns:
    capability name for use with DesiredCapabilities
  - toString
```
public String toString()
```
    Gets the string representation of this capability.
    
    Overrides:
    
    toString in class Enum<OperaSettings.Capability>
    
    Returns:
    easy to read string representation
  - findCapability
```
public static OperaSettings.Capability findCapability(String capabilityName)
```
    Looks up a capability by its capability name.
    
    Parameters:
    capabilityName - the string representation of the capability
    
    Returns:
    the corresponding capability

Enum OperaSettings.Capability

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

LOGGING_LEVEL

LOGGING_FILE

BINARY

ARGUMENTS

HOST

PORT

LAUNCHER

PROFILE

OPERAIDLE

DISPLAY

AUTOSTART

PROXY

RUNNER

EMULATION_PROFILE

NO_RESTART

NO_QUIT

DETACH

PRODUCT

BACKEND

Method Detail

values

valueOf

getIdentifier

getCapability

toString

findCapability