Package org.openqa.selenium.chrome

Class ChromeDriverService

java.lang.Object

org.openqa.selenium.remote.service.DriverService

org.openqa.selenium.chrome.ChromeDriverService

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ChromeDriverService
extends org.openqa.selenium.remote.service.DriverService

Manages the life and death of a ChromeDriver server.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ChromeDriverService.Builder	Builder used to configure new ChromeDriverService instances.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	CHROME_DRIVER_ALLOWED_IPS_PROPERTY	System property that defines comma-separated list of remote IPv4 addresses which are allowed to connect to ChromeDriver.
static java.lang.String	CHROME_DRIVER_APPEND_LOG_PROPERTY	Boolean system property that defines whether ChromeDriver should append to existing log file.
static java.lang.String	CHROME_DRIVER_DISABLE_BUILD_CHECK	System property that defines whether the ChromeDriver executable should check for build version compatibility between ChromeDriver and the browser.
static java.lang.String	CHROME_DRIVER_EXE_PROPERTY	System property that defines the location of the ChromeDriver executable that will be used by the default service.
static java.lang.String	CHROME_DRIVER_LOG_LEVEL_PROPERTY	System property that defines the log level when ChromeDriver output is logged.
static java.lang.String	CHROME_DRIVER_LOG_PROPERTY	System property that defines the default location where ChromeDriver output is logged.
static java.lang.String	CHROME_DRIVER_READABLE_TIMESTAMP	System property that toggles the formatting of the timestamps of the logs
static java.lang.String	CHROME_DRIVER_SILENT_OUTPUT_PROPERTY	Boolean system property that defines whether the ChromeDriver executable should be started in silent mode.
static java.lang.String	CHROME_DRIVER_VERBOSE_LOG_PROPERTY	Boolean system property that defines whether the ChromeDriver executable should be started with verbose logging.
static java.lang.String	CHROME_DRIVER_WHITELISTED_IPS_PROPERTY	Deprecated. use CHROME_DRIVER_ALLOWED_IPS_PROPERTY

Fields inherited from class org.openqa.selenium.remote.service.DriverService

DEFAULT_TIMEOUT, process

Constructor Summary

Constructors

Constructor	Description
ChromeDriverService(java.io.File executable, int port, java.time.Duration timeout, java.util.List<java.lang.String> args, java.util.Map<java.lang.String,java.lang.String> environment)
ChromeDriverService(java.io.File executable, int port, java.util.List<java.lang.String> args, java.util.Map<java.lang.String,java.lang.String> environment)

Method Summary

Modifier and Type	Method	Description
static ChromeDriverService	createDefaultService()	Configures and returns a new ChromeDriverService using the default configuration.
static ChromeDriverService	createServiceWithConfig(ChromeOptions options)	Deprecated. Use ChromeDriverService.Builder.withLogLevel(ChromiumDriverLogLevel) }

Methods inherited from class org.openqa.selenium.remote.service.DriverService

checkExecutable, close, findExecutable, getArgs, getEnvironment, getOutputStream, getTimeout, getUrl, getUrl, hasShutdownEndpoint, isRunning, sendOutputTo, start, stop, waitUntilAvailable

Methods inherited from class java.lang.Object

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

Field Detail

CHROME_DRIVER_EXE_PROPERTY

public static final java.lang.String CHROME_DRIVER_EXE_PROPERTY

System property that defines the location of the ChromeDriver executable that will be used by the default service.

See Also:

Constant Field Values

CHROME_DRIVER_READABLE_TIMESTAMP

public static final java.lang.String CHROME_DRIVER_READABLE_TIMESTAMP

System property that toggles the formatting of the timestamps of the logs

See Also:

Constant Field Values

CHROME_DRIVER_LOG_PROPERTY

public static final java.lang.String CHROME_DRIVER_LOG_PROPERTY

System property that defines the default location where ChromeDriver output is logged.

See Also:

Constant Field Values

CHROME_DRIVER_LOG_LEVEL_PROPERTY

public static final java.lang.String CHROME_DRIVER_LOG_LEVEL_PROPERTY

System property that defines the log level when ChromeDriver output is logged.

See Also:

Constant Field Values

CHROME_DRIVER_APPEND_LOG_PROPERTY

public static final java.lang.String CHROME_DRIVER_APPEND_LOG_PROPERTY

Boolean system property that defines whether ChromeDriver should append to existing log file.

See Also:

Constant Field Values

CHROME_DRIVER_VERBOSE_LOG_PROPERTY

public static final java.lang.String CHROME_DRIVER_VERBOSE_LOG_PROPERTY

Boolean system property that defines whether the ChromeDriver executable should be started with verbose logging.

See Also:

Constant Field Values

CHROME_DRIVER_SILENT_OUTPUT_PROPERTY

public static final java.lang.String CHROME_DRIVER_SILENT_OUTPUT_PROPERTY

Boolean system property that defines whether the ChromeDriver executable should be started in silent mode.

See Also:

Constant Field Values

CHROME_DRIVER_ALLOWED_IPS_PROPERTY

public static final java.lang.String CHROME_DRIVER_ALLOWED_IPS_PROPERTY

System property that defines comma-separated list of remote IPv4 addresses which are allowed to connect to ChromeDriver.

See Also:

Constant Field Values

CHROME_DRIVER_WHITELISTED_IPS_PROPERTY

@Deprecated
public static final java.lang.String CHROME_DRIVER_WHITELISTED_IPS_PROPERTY

Deprecated.

use CHROME_DRIVER_ALLOWED_IPS_PROPERTY

System property that defines comma-separated list of remote IPv4 addresses which are allowed to connect to ChromeDriver.

See Also:

Constant Field Values

CHROME_DRIVER_DISABLE_BUILD_CHECK

public static final java.lang.String CHROME_DRIVER_DISABLE_BUILD_CHECK

System property that defines whether the ChromeDriver executable should check for build version compatibility between ChromeDriver and the browser.

See Also:

Constant Field Values

Constructor Detail

ChromeDriverService

public ChromeDriverService(java.io.File executable,
                           int port,
                           java.util.List<java.lang.String> args,
                           java.util.Map<java.lang.String,java.lang.String> environment)
                    throws java.io.IOException

Parameters:

executable - The ChromeDriver executable.

port - Which port to start the ChromeDriver on.

args - The arguments to the launched server.

environment - The environment for the launched server.

Throws:

java.io.IOException - If an I/O error occurs.

ChromeDriverService

public ChromeDriverService(java.io.File executable,
                           int port,
                           java.time.Duration timeout,
                           java.util.List<java.lang.String> args,
                           java.util.Map<java.lang.String,java.lang.String> environment)
                    throws java.io.IOException

Parameters:

executable - The ChromeDriver executable.

port - Which port to start the ChromeDriver on.

timeout - Timeout waiting for driver server to start.

args - The arguments to the launched server.

environment - The environment for the launched server.

Throws:

java.io.IOException - If an I/O error occurs.

Method Detail

createDefaultService

public static ChromeDriverService createDefaultService()

Configures and returns a new ChromeDriverService using the default configuration. In this configuration, the service will use the ChromeDriver executable identified by the CHROME_DRIVER_EXE_PROPERTY system property. Each service created by this method will be configured to use a free port on the current system.

Returns:

A new ChromeDriverService using the default configuration.

createServiceWithConfig

@Deprecated
public static ChromeDriverService createServiceWithConfig(ChromeOptions options)

Deprecated.

Use ChromeDriverService.Builder.withLogLevel(ChromiumDriverLogLevel) }

Configures and returns a new ChromeDriverService using the supplied configuration. In this configuration, the service will use the ChromeDriver executable identified by the CHROME_DRIVER_EXE_PROPERTY system property. Each service created by this method will be configured to use a free port on the current system.

Returns:

A new ChromeDriverService using the supplied configuration from ChromeOptions.