[dotnet] Add Bidi-compliant webSocketUrl capability

Author: jimevans

dotnet/src/webdriver/CapabilityType.cs

@@ -155,6 +155,12 @@ public static class CapabilityType
         /// </summary>
         public static readonly string UseStrictFileInteractability = "strictFileInteractability";
 
+        /// <summary>
+        /// Capability name used to get a value indicating whether to request URL of a WebSocket
+        /// connection for bidirectional communication with a driver.
+        /// </summary>
+        public static readonly string WebSocketUrl = "webSocketUrl";
+
         private static readonly List<string> KnownSpecCompliantCapabilityNames = new List<string>() {
             BrowserName,
             BrowserVersion,
@@ -165,7 +171,8 @@ public static class CapabilityType
             SetWindowRect,
             Timeouts,
             UnhandledPromptBehavior,
-            UseStrictFileInteractability
+            UseStrictFileInteractability,
+            WebSocketUrl
         };
 
         /// <summary>

dotnet/src/webdriver/DriverOptions.cs

@@ -99,6 +99,7 @@ public abstract class DriverOptions
         private string platformName;
         private Proxy proxy;
         private bool? acceptInsecureCertificates;
+        private bool? useWebSocketUrl;
         private bool useStrictFileInteractability;
         private UnhandledPromptBehavior unhandledPromptBehavior = UnhandledPromptBehavior.Default;
         private PageLoadStrategy pageLoadStrategy = PageLoadStrategy.Default;
@@ -118,6 +119,7 @@ protected DriverOptions()
             this.AddKnownCapabilityName(CapabilityType.UnhandledPromptBehavior, "UnhandledPromptBehavior property");
             this.AddKnownCapabilityName(CapabilityType.PageLoadStrategy, "PageLoadStrategy property");
             this.AddKnownCapabilityName(CapabilityType.UseStrictFileInteractability, "UseStrictFileInteractability property");
+            this.AddKnownCapabilityName(CapabilityType.WebSocketUrl, "UseWebSocketUrl property");
         }
 
         /// <summary>
@@ -157,6 +159,16 @@ public bool? AcceptInsecureCertificates
             set { this.acceptInsecureCertificates = value; }
         }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether the driver should request a URL to
+        /// a WebSocket to be used for bidirectional communication.
+        /// </summary>
+        public bool? UseWebSocketUrl
+        {
+            get { return this.useWebSocketUrl; }
+            set { this.useWebSocketUrl = value; }
+        }
+
         /// <summary>
         /// Gets or sets the value for describing how unexpected alerts are to be handled in the browser.
         /// Defaults to <see cref="UnhandledPromptBehavior.Default"/>.
@@ -450,6 +462,11 @@ protected IWritableCapabilities GenerateDesiredCapabilities(bool isSpecification
                 capabilities.SetCapability(CapabilityType.AcceptInsecureCertificates, this.acceptInsecureCertificates);
             }
 
+            if (this.useWebSocketUrl.HasValue)
+            {
+                capabilities.SetCapability(CapabilityType.WebSocketUrl, this.useWebSocketUrl);
+            }
+
             if (this.useStrictFileInteractability)
             {
                 capabilities.SetCapability(CapabilityType.UseStrictFileInteractability, true);

dotnet/src/webdriver/Remote/DesiredCapabilities.cs

@@ -27,7 +27,6 @@ namespace OpenQA.Selenium.Remote
     /// <summary>
     /// Internal class to specify the requested capabilities of the browser for <see cref="IWebDriver"/>.
     /// </summary>
-    [Obsolete("Use of DesiredCapabilities has been deprecated in favor of browser-specific Options classes")]
     internal class DesiredCapabilities : IWritableCapabilities, IHasCapabilitiesDictionary
     {
         private readonly Dictionary<string, object> capabilities = new Dictionary<string, object>();