Class WebDriverFromThirdPartyFactory

Namespace

CSF.Extensions.WebDriver.Factories

Assembly

CSF.Extensions.WebDriver.dll

Chain of responsibility implementation of ICreatesWebDriverFromOptions which creates WebDriver instances using a third-party factory type, specified in DriverFactoryType.

public class WebDriverFromThirdPartyFactory : ICreatesWebDriverFromOptions

Inheritance

object

WebDriverFromThirdPartyFactory

Implements

ICreatesWebDriverFromOptions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

WebDriverFactoryExtensions.GetWebDriver(ICreatesWebDriverFromOptions, WebDriverCreationOptionsCollection, Action<DriverOptions>)

WebDriverFactoryExtensions.GetWebDriver(ICreatesWebDriverFromOptions, WebDriverCreationOptionsCollection, string, Action<DriverOptions>)

Constructors

WebDriverFromThirdPartyFactory(ICreatesWebDriverFromOptions, IGetsWebDriverAndOptionsTypes, IServiceProvider, ILogger<WebDriverFromThirdPartyFactory>)

Initialises a new instance of WebDriverFromThirdPartyFactory.

public WebDriverFromThirdPartyFactory(ICreatesWebDriverFromOptions next, IGetsWebDriverAndOptionsTypes typeProvider, IServiceProvider services, ILogger<WebDriverFromThirdPartyFactory> logger)

Parameters

next ICreatesWebDriverFromOptions

The next implementation in the chain of responsibility.

typeProvider IGetsWebDriverAndOptionsTypes

A type-providing service.

services IServiceProvider

The DI service provider.

logger ILogger<WebDriverFromThirdPartyFactory>

A logger

Exceptions

ArgumentNullException

If any parameter is null.

Methods

GetWebDriver(WebDriverCreationOptions, Action<DriverOptions>)

Gets a WebDriver using the settings from the specified WebDriver configuration object.

public WebDriverAndOptions GetWebDriver(WebDriverCreationOptions options, Action<DriverOptions> supplementaryConfiguration = null)

Parameters

options WebDriverCreationOptions

An object indicating which WebDriver implementation to use and how the WebDriver should be configured.

supplementaryConfiguration Action<DriverOptions>

An optional action which further-configures the WebDriver options before the driver is created.

Returns

WebDriverAndOptions

An object containing both a WebDriver instance and the OpenQA.Selenium.DriverOptions which were used to create it.

Remarks

The WebDriver configuration object specifies both the OpenQA.Selenium.IWebDriver implementation type to use as well as any relevant options for that WebDriver.

Exceptions

ArgumentNullException

If options is null.

ArgumentException

If any of:

• The DriverType of the options is null or empty
• The OptionsFactory of the options is null
• The DriverType of the options is set to an implementation of OpenQA.Selenium.IWebDriver which does not expose a public constructor which takes a single parameter of type OpenQA.Selenium.DriverOptions (or a more derived type). Such WebDriver implementations will require a custom factory, indicated by DriverFactoryType
• The DriverFactoryType of the options is not null, but the implementation of ICreatesWebDriverFromOptions indicated by that type did not return an OpenQA.Selenium.IWebDriver instance

TypeLoadException

Either DriverType or DriverFactoryType of the options are non-null/non-empty but no type can be found matching the specifed values.