Deprecates withCapabilities method and removes tests (#9701)

Co-authored-by: David Burns <[email protected]>

Author: gpt14

javascript/node/selenium-webdriver/index.js

@@ -318,6 +318,8 @@ class Builder {
   }
 
   /**
+   * @deprecated Since Selenium 4.0 withCapabilities is deprecated, use set*Options instead where * is the browser(eg setChromeOptions)
+   *
    * Sets the desired capabilities when requesting a new session. This will
    * overwrite any previously set capabilities.
    * @param {!(Object|Capabilities)} capabilities The desired capabilities for

javascript/node/selenium-webdriver/test/builder_test.js

@@ -21,14 +21,12 @@ const assert = require('assert')
 
 const chrome = require('../chrome')
 const edge = require('../edge')
-const error = require('../lib/error')
 const firefox = require('../firefox')
 const ie = require('../ie')
 const safari = require('../safari')
 const test = require('../lib/test')
 const { Browser } = require('../lib/capabilities')
 const { Pages } = require('../lib/test')
-const { Builder, Capabilities } = require('..')
 
 test.suite(function (env) {
   const BROWSER_MAP = new Map([
@@ -71,30 +69,3 @@ test.suite(function (env) {
     })
   }
 })
-
-describe('Builder', function () {
-  describe('catches incorrect use of browser options class', function () {
-    function test(key, options) {
-      it(key, async function () {
-        let builder = new Builder().withCapabilities(
-          new Capabilities()
-            .set('browserName', 'fake-browser-should-not-try-to-start')
-            .set(key, new options())
-        )
-        try {
-          let driver = await builder.build()
-          await driver.quit()
-          return Promise.reject(Error('should have failed'))
-        } catch (ex) {
-          if (!(ex instanceof error.InvalidArgumentError)) {
-            throw ex
-          }
-        }
-      })
-    }
-
-    test('chromeOptions', chrome.Options)
-    test('moz:firefoxOptions', firefox.Options)
-    test('safari.options', safari.Options)
-  })
-})