Class WebDriver

dotnet/src/webdriver/WebDriver.cs:33–1164

A base class representing a driver for a web browser.

/// A base class representing a driver for a web browser.
/// </summary>
public class WebDriver : IWebDriver, ISearchContext, IJavaScriptExecutor, IFindsElement, ITakesScreenshot, ISupportsPrint, IActionExecutor, IAllowsFileDetection, IHasCapabilities, IHasCommandExecutor, IHasSessionId, ICustomDriverCommandExecutor, IHasVirtualAuthenticator
{
    /// <summary>
    /// The default command timeout for HTTP requests in a RemoteWebDriver instance.
    /// </summary>
    protected static readonly TimeSpan DefaultCommandTimeout = TimeSpan.FromSeconds(60);
    private IFileDetector fileDetector = new DefaultFileDetector();
    private NetworkManager? network;
    private WebElementFactory elementFactory;

    private readonly List<string> registeredCommands = new List<string>();

    /// <summary>
    /// Initializes a new instance of the <see cref="WebDriver"/> class.
    /// </summary>
    /// <param name="executor">The <see cref="ICommandExecutor"/> object used to execute commands.</param>
    /// <param name="capabilities">The <see cref="ICapabilities"/> object used to configure the driver session.</param>
    protected WebDriver(ICommandExecutor executor, ICapabilities capabilities)
    {
        this.CommandExecutor = executor;
        this.elementFactory = new WebElementFactory(this);
        this.registeredCommands.AddRange(DriverCommand.KnownCommands);

        if (this is ISupportsLogs)
        {
            // Only add the legacy log commands if the driver supports
            // retrieving the logs via the extension end points.
            this.RegisterDriverCommand(DriverCommand.GetAvailableLogTypes, new HttpCommandInfo(HttpCommandInfo.GetCommand, "/session/{sessionId}/se/log/types"), true);
            this.RegisterDriverCommand(DriverCommand.GetLog, new HttpCommandInfo(HttpCommandInfo.PostCommand, "/session/{sessionId}/se/log"), true);
        }

        try
        {
            this.StartSession(capabilities);
        }
        catch (Exception)
        {
            try
            {
                // Failed to start driver session, disposing of driver
                this.Dispose();
            }
            catch
            {
                // Ignore the clean-up exception. We'll propagate the original failure.
            }
            throw;
        }
    }

    /// <summary>
    /// Gets the <see cref="ICommandExecutor"/> which executes commands for this driver.
    /// </summary>
    public ICommandExecutor CommandExecutor { get; }

    /// <summary>
    /// Gets the <see cref="ICapabilities"/> that the driver session was created with, which may be different from those requested.
    /// </summary>