org.openqa.selenium.chrome

类 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);

 // or alternatively:
 DesiredCapabilities capabilities = DesiredCapabilities.chrome();
 capabilities.setCapability(ChromeOptions.CAPABILITY, options);
 ChromeDriver driver = new ChromeDriver(capabilities);

 // 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 chromedriver v17.0.963.0

字段概要

字段

限定符和类型	字段和说明
static String	CAPABILITY Key used to store a set of ChromeOptions in a DesiredCapabilities object.

构造器概要

构造器

构造器和说明
ChromeOptions()

方法概要

限定符和类型	方法和说明
void	addArguments(List<String> arguments) Adds additional command line arguments to be used when starting Chrome.
void	addArguments(String... arguments)
void	addEncodedExtensions(List<String> encoded) Adds a new Chrome extension to install on browser startup.
void	addEncodedExtensions(String... encoded)
void	addExtensions(File... paths)
void	addExtensions(List<File> paths) Adds a new Chrome extension to install on browser startup.
boolean	equals(Object other)
Object	getExperimentalOption(String name) Returns the value of an experimental option.
int	hashCode()
void	setBinary(File path) Sets the path to the Chrome executable.
void	setBinary(String path) Sets the path to the Chrome executable.
void	setExperimentalOption(String name, Object value) Sets an experimental option.
com.google.gson.JsonElement	toJson() Converts this instance to its JSON representation.

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

字段详细资料

CAPABILITY

public static final String CAPABILITY

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

另请参阅:

常量字段值

构造器详细资料

ChromeOptions

public ChromeOptions()

方法详细资料

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.

参数:

path - Path to Chrome executable.

setBinary

public void setBinary(String 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.

参数:

path - Path to Chrome executable.

addArguments

public void addArguments(String... arguments)

参数:

arguments - The arguments to use when starting Chrome.

另请参阅:

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".

参数:

arguments - The arguments to use when starting Chrome.

addExtensions

public void addExtensions(File... paths)

参数:

paths - Paths to the extensions to install.

另请参阅:

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).

参数:

paths - Paths to the extensions to install.

addEncodedExtensions

public void addEncodedExtensions(String... encoded)

参数:

encoded - Base64 encoded data of the extensions to install.

另请参阅:

addEncodedExtensions(java.util.List)

addEncodedExtensions

public void addEncodedExtensions(List<String> encoded)

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

参数:

encoded - Base64 encoded data of the extensions to install.

setExperimentalOption

public void setExperimentalOption(String name,
                                  Object value)

Sets an experimental option. Useful for new ChromeDriver options not yet exposed through the ChromeOptions API.

参数:

name - Name of the experimental option.

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

getExperimentalOption

public Object getExperimentalOption(String name)

Returns the value of an experimental option.

参数:

name - The option name.

返回:

The option value, or null if not set.

toJson

public com.google.gson.JsonElement toJson()
                                   throws IOException

Converts this instance to its JSON representation.

返回:

The JSON representation of these options.

抛出:

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

equals

public boolean equals(Object other)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object