Class DriverService

Namespace

OpenQA.Selenium

Assembly

WebDriver.dll

Exposes the service provided by a native WebDriver server executable.

public abstract class DriverService : ICommandServer, IDisposable

Inheritance

object

DriverService

Implements

ICommandServer

IDisposable

Derived

ChromeDriverService

EdgeDriverService

FirefoxDriverService

InternetExplorerDriverService

OperaDriverService

PhantomJSDriverService

SafariDriverService

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Constructors

DriverService(string, int, string, Uri)

Initializes a new instance of the DriverService class.

protected DriverService(string servicePath, int port, string driverServiceExecutableName, Uri driverServiceDownloadUrl)

Parameters

servicePath string

The full path to the directory containing the executable providing the service to drive the browser.

port int

The port on which the driver executable should listen.

driverServiceExecutableName string

The file name of the driver service executable.

driverServiceDownloadUrl Uri

A URL at which the driver service executable may be downloaded.

Exceptions

ArgumentException

If the path specified is null or an empty string.

DriverServiceNotFoundException

If the specified driver service executable does not exist in the specified directory.

Properties

CommandLineArguments

Gets the command-line arguments for the driver service.

protected virtual string CommandLineArguments { get; }

Property Value

string

DriverServiceExecutableName

Gets the executable file name of the driver service.

protected string DriverServiceExecutableName { get; }

Property Value

string

HasShutdown

Gets a value indicating whether the service has a shutdown API that can be called to terminate it gracefully before forcing a termination.

protected virtual bool HasShutdown { get; }

Property Value

bool

HideCommandPromptWindow

Gets or sets a value indicating whether the command prompt window of the service should be hidden.

public bool HideCommandPromptWindow { get; set; }

Property Value

bool

HostName

Gets or sets the host name of the service. Defaults to "localhost."

public string HostName { get; set; }

Property Value

string

Remarks

Most driver service executables do not allow connections from remote (non-local) machines. This property can be used as a workaround so that an IP address (like "127.0.0.1" or "::1") can be used instead.

InitializationTimeout

Gets a value indicating the time to wait for an initial connection before timing out.

protected virtual TimeSpan InitializationTimeout { get; }

Property Value

TimeSpan

IsInitialized

Gets a value indicating whether the service is responding to HTTP requests.

protected virtual bool IsInitialized { get; }

Property Value

bool

IsRunning

Gets a value indicating whether the service is running.

public bool IsRunning { get; }

Property Value

bool

Port

Gets or sets the port of the service.

public int Port { get; set; }

Property Value

int

ProcessId

Gets the process ID of the running driver service executable. Returns 0 if the process is not running.

public int ProcessId { get; }

Property Value

int

ServiceUrl

Gets the Uri of the service.

public Uri ServiceUrl { get; }

Property Value

Uri

SuppressInitialDiagnosticInformation

Gets or sets a value indicating whether the initial diagnostic information is suppressed when starting the driver server executable. Defaults to false, meaning diagnostic information should be shown by the driver server executable.

public bool SuppressInitialDiagnosticInformation { get; set; }

Property Value

bool

TerminationTimeout

Gets a value indicating the time to wait for the service to terminate before forcing it to terminate.

protected virtual TimeSpan TerminationTimeout { get; }

Property Value

TimeSpan

Methods

Dispose()

Releases all resources associated with this DriverService.

public void Dispose()

Dispose(bool)

Releases all resources associated with this DriverService.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

true if the Dispose method was explicitly called; otherwise, false.

FindDriverServiceExecutable(string, Uri)

Finds the specified driver service executable.

protected static string FindDriverServiceExecutable(string executableName, Uri downloadUrl)

Parameters

executableName string

The file name of the executable to find.

downloadUrl Uri

A URL at which the driver service executable may be downloaded.

Returns

string

The directory containing the driver service executable.

Exceptions

DriverServiceNotFoundException

If the specified driver service executable does not exist in the current directory or in a directory on the system path.

Start()

Starts the DriverService.

public void Start()