org.openqa.selenium.chrome
Class ChromeOptions

java.lang.Object
  org.openqa.selenium.chrome.ChromeOptions

public class ChromeOptions
extends Object

Class to manage options specific to ChromeDriver.

Example usage:

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

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

 // For use with RemoteWebDriver:
 DesiredCapabilities capabilities = DesiredCapabilities.chrome();
 capabilities.setCapability(ChromeOptions.CAPABILITY, options);
 RemoteWebDriver driver = new RemoteWebDriver(
     new URL("http://localhost:4444/wd/hub"), capabilities);
 

Since:

Since chromedriver v17.0.963.0

Field Summary

static String

CAPABILITY Key used to store a set of ChromeOptions in a DesiredCapabilities object.

Constructor Summary

ChromeOptions()

Method Summary

void	addArguments(List<String> arguments) Adds additional command line arguments to be used when starting Chrome.
void	addArguments(String... arguments)
void	addExtensions(File... paths)
void	addExtensions(List<File> paths) Adds a new Chrome extension to install on browser startup.
void	setBinary(File path) Sets the path to the Chrome executable.
org.json.JSONObject	toJson() Converts this instance to its JSON representation.

Methods inherited from class java.lang.Object

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

Field Detail

CAPABILITY

public static final String CAPABILITY

Key used to store a set of ChromeOptions in a DesiredCapabilities object.

See Also:

Constant Field Values

Constructor Detail

ChromeOptions

public ChromeOptions()

Method Detail

setBinary

public void setBinary(File path)

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

Parameters:

path - Path to Chrome executable.

addArguments

public void addArguments(String... arguments)

Parameters:

arguments - The arguments to use when starting Chrome.

See Also:

addArguments(java.util.List)

addArguments

public void addArguments(List<String> arguments)

Adds additional command line arguments to be used when starting Chrome. 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 Chrome.

addExtensions

public void addExtensions(File... paths)

Parameters:

paths - Paths to the extensions to install.

See Also:

addExtensions(java.util.List)

addExtensions

public void addExtensions(List<File> paths)

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

Parameters:

paths - Paths to the extensions to install.

toJson

public org.json.JSONObject toJson()
                           throws IOException,
                                  org.json.JSONException

Converts this instance to its JSON representation.

Returns:

The JSON representation of these options.

Throws:

IOException - If an error occurs while reading the extension files from disk.

org.json.JSONException - If an error occurs while encoding these options as JSON.