Start Async!

Author: nvborisenko

dotnet/src/webdriver/Chrome/ChromeDriver.cs

@@ -157,6 +157,61 @@ public ChromeDriver(ChromeDriverService service, ChromeOptions options, TimeSpan
         this.AddCustomChromeCommands();
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ChromeDriver"/> class using the specified command executor and options.
+    /// </summary>
+    /// <param name="commandExecutor">The <see cref="ICommandExecutor"/> to use for executing commands.</param>
+    /// <param name="options">The <see cref="ChromeOptions"/> to use for this driver.</param>
+    /// <param name="autoStartSession">Whether to automatically start the session.</param>
+    protected ChromeDriver(ICommandExecutor commandExecutor, ChromeOptions options, bool autoStartSession)
+        : base(commandExecutor, options, autoStartSession)
+    {
+        if (autoStartSession)
+        {
+            this.AddCustomChromeCommands();
+        }
+    }
+
+    /// <summary>
+    /// Asynchronously creates and starts a new instance of the <see cref="ChromeDriver"/> class with default options.
+    /// </summary>
+    /// <returns>A task that represents the asynchronous operation. The task result contains the initialized <see cref="ChromeDriver"/>.</returns>
+    public static Task<ChromeDriver> StartAsync()
+    {
+        return StartAsync(new ChromeOptions());
+    }
+
+    /// <summary>
+    /// Asynchronously creates and starts a new instance of the <see cref="ChromeDriver"/> class using the specified options.
+    /// </summary>
+    /// <param name="options">The <see cref="ChromeOptions"/> to be used with the Chrome driver.</param>
+    /// <returns>A task that represents the asynchronous operation. The task result contains the initialized <see cref="ChromeDriver"/>.</returns>
+    /// <exception cref="ArgumentNullException">If <paramref name="options"/> is <see langword="null"/>.</exception>
+    public static async Task<ChromeDriver> StartAsync(ChromeOptions options)
+    {
+        if (options is null)
+        {
+            throw new ArgumentNullException(nameof(options), "Chrome options must not be null");
+        }
+
+        ChromeDriverService service = ChromeDriverService.CreateDefaultService();
+        ICommandExecutor executor = await GenerateDriverServiceCommandExecutorAsync(service, options, DefaultCommandTimeout).ConfigureAwait(false);
+
+        ChromeDriver driver = new(executor, options, autoStartSession: false);
+        driver.AddCustomChromeCommands();
+
+        try
+        {
+            await driver.StartSessionAsync(options.ToCapabilities()).ConfigureAwait(false);
+            return driver;
+        }
+        catch
+        {
+            driver.Dispose();
+            throw;
+        }
+    }
+
     /// <summary>
     /// Gets a read-only dictionary of the custom WebDriver commands defined for ChromeDriver.
     /// The keys of the dictionary are the names assigned to the command; the values are the

dotnet/src/webdriver/Chromium/ChromiumDriver.cs

@@ -132,6 +132,20 @@ protected ChromiumDriver(ChromiumDriverService service, ChromiumOptions options,
         this.optionsCapabilityName = options.CapabilityName ?? throw new ArgumentException("No chromium options capability name specified", nameof(options));
     }
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ChromiumDriver"/> class using the specified command executor and options.
+    /// </summary>
+    /// <param name="commandExecutor">The <see cref="ICommandExecutor"/> to use for executing commands.</param>
+    /// <param name="options">The <see cref="ChromiumOptions"/> to be used with the ChromiumDriver.</param>
+    /// <param name="autoStartSession">Whether to automatically start the session.</param>
+    /// <exception cref="ArgumentNullException">If <paramref name="options"/> is <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentException">If the Chromium options capability name is <see langword="null"/>.</exception>
+    protected ChromiumDriver(ICommandExecutor commandExecutor, ChromiumOptions options, bool autoStartSession)
+        : base(commandExecutor, ConvertOptionsToCapabilities(options), autoStartSession)
+    {
+        this.optionsCapabilityName = options.CapabilityName ?? throw new ArgumentException("No chromium options capability name specified", nameof(options));
+    }
+
     /// <summary>
     /// Gets the dictionary of custom Chromium commands registered with the driver.
     /// </summary>
@@ -144,7 +158,15 @@ await GenerateDriverServiceCommandExecutorAsync(service, options, commandTimeout
             .GetAwaiter().GetResult();
     }
 
-    private static async Task<ICommandExecutor> GenerateDriverServiceCommandExecutorAsync(DriverService service, DriverOptions options, TimeSpan commandTimeout)
+    /// <summary>
+    /// Asynchronously generates a driver service command executor.
+    /// </summary>
+    /// <param name="service">The <see cref="DriverService"/> to use.</param>
+    /// <param name="options">The <see cref="DriverOptions"/> to be used with the driver.</param>
+    /// <param name="commandTimeout">The maximum amount of time to wait for each command.</param>
+    /// <returns>A task that represents the asynchronous operation. The task result contains the <see cref="ICommandExecutor"/>.</returns>
+    /// <exception cref="ArgumentNullException">If <paramref name="service"/> or <paramref name="options"/> are <see langword="null"/>.</exception>
+    protected static async Task<ICommandExecutor> GenerateDriverServiceCommandExecutorAsync(DriverService service, DriverOptions options, TimeSpan commandTimeout)
     {
         if (service is null)
         {