selenium-webdriver 4.0.0-beta.4 → 4.0.0-rc-1

package/CHANGES.md

@@ -1,3 +1,22 @@
+## v4.0.0-rc-1
+
+* Deprecates withCapabilities method and removes tests (#9701)
+* expose `withLocator` method at the top level
+* Enables Mobile feature for Firefox (Still need to expand this to chromium based browsers)
+
+* Add the ability to do Relative Locators with all By types. Fixes #9559
+* Add default Opera capabilities. Fixes #9654
+* Add support for ChromeDriver `--enable-chrome-logs` (#9575) [Author: Mark Stacey]
+
+  The `--enable-chrome-logs` ChromeDriver option can now be enabled using
+  the Chromium (or Chrome) ServiceBuilder, similarly to the other options
+  provided by ChromeDriver.
+
+* Add the debuggerAddress option to chromium.js (#9561) [Author: Brandon Walderman]
+* Adds http client options (#9638)[Author: Dharin Shah]
+* Updating edge.js to extend chromium.driver (fixes #9626)
+
+
 ## v4.0.0-beta.4
 
 * Add windowTypes option support for ChromiumDriver (#7897)

package/README.md

@@ -223,7 +223,9 @@ under the License.
 [edge]: http://go.microsoft.com/fwlink/?LinkId=619687
 [geckodriver]: https://github.com/mozilla/geckodriver/releases/
 [reduction]: http://www.webkit.org/quality/reduction.html
-[release]: http://selenium-release.storage.googleapis.com/index.html
+
+[release]: https://www.selenium.dev/downloads/
+
 [users]: https://groups.google.com/forum/#!forum/selenium-users
 [safaridriver]: https://developer.apple.com/library/prerelease/content/releasenotes/General/WhatsNewInSafari/Articles/Safari_10_0.html#//apple_ref/doc/uid/TP40014305-CH11-DontLinkElementID_28
-[operadriver]: https://github.com/operasoftware/operachromiumdriver/releases
+[operadriver]: https://github.com/operasoftware/operachromiumdriver/releases

package/chrome.js

@@ -236,10 +236,9 @@ class Driver extends chromium.Driver {
    */
   static createSession(opt_config, opt_serviceExecutor) {
     let caps = opt_config || new Options()
-    return /** @type {!Driver} */ (super.createSession(
-      caps,
-      opt_serviceExecutor
-    ))
+    return /** @type {!Driver} */ (
+      super.createSession(caps, opt_serviceExecutor)
+    )
   }
 }
 

package/chromium.js

@@ -213,6 +213,14 @@ class ServiceBuilder extends remote.DriverService.Builder {
     return this.addArguments('--log-path=' + path)
   }
 
+  /**
+   * Enables Chrome logging.
+   * @returns {!ServiceBuilder} A self reference.
+   */
+   enableChromeLogging() {
+    return this.addArguments('--enable-chrome-logs');
+  }
+
   /**
    * Enables verbose logging.
    * @return {!ServiceBuilder} A self reference.
@@ -275,6 +283,19 @@ class Options extends Capabilities {
     return this
   }
 
+  /**
+   * Sets the address of a Chromium remote debugging server to connect to.
+   * Address should be of the form "{hostname|IP address}:port"
+   * (e.g. "localhost:9222").
+   *
+   * @param {string} address The address to connect to.
+   * @return {!Options} A self reference.
+   */
+  debuggerAddress(address) {
+    this.options_.debuggerAddress = address;
+    return this
+  }
+
   /**
    * Configures the driver to start the browser in headless mode.
    *
@@ -557,14 +578,13 @@ class Options extends Capabilities {
    * @return {!Options} A self reference.
    */
   windowTypes(...args) {
-    let windowTypes = (this.options_.windowTypes || []).concat(...args);
+    let windowTypes = (this.options_.windowTypes || []).concat(...args)
     if (windowTypes.length) {
-      this.options_.windowTypes = windowTypes;
+      this.options_.windowTypes = windowTypes
     }
-    return this;
+    return this
   }
 
-
   /**
    * Converts this instance to its JSON wire protocol representation. Note this
    * function is an implementation not intended for general use.
@@ -581,7 +601,7 @@ class Options extends Capabilities {
           return extension.toString('base64')
         }
         return io
-          .read(/** @type {string} */(extension))
+          .read(/** @type {string} */ (extension))
           .then((buffer) => buffer.toString('base64'))
       })
     }
@@ -634,7 +654,7 @@ class Driver extends webdriver.WebDriver {
    * implementation.
    * @override
    */
-  setFileDetector() { }
+  setFileDetector() {}
 
   /**
    * Schedules a command to launch Chrome App with given ID.

package/edge.js

@@ -80,8 +80,6 @@
 const { Browser } = require('./lib/capabilities')
 const io = require('./io')
 const chromium = require('./chromium')
-const http = require('./http')
-const webdriver = require('./lib/webdriver')
 
 /**
  * Name of the EdgeDriver executable.
@@ -111,10 +109,10 @@ class ServiceBuilder extends chromium.ServiceBuilder {
     let exe = opt_exe || locateSynchronously()
     if (!exe) {
       throw Error(
-        `The WebDriver for Edge could not be found on the current PATH. Please download the `+
-        `latest version of ${EDGEDRIVER_CHROMIUM_EXE} from `+
-        `https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ `+
-        `and ensure it can be found on your PATH.`
+        `The WebDriver for Edge could not be found on the current PATH. Please download the ` +
+          `latest version of ${EDGEDRIVER_CHROMIUM_EXE} from ` +
+          `https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ ` +
+          `and ensure it can be found on your PATH.`
       )
     }
     super(exe)
@@ -143,24 +141,20 @@ class Options extends chromium.Options {
 /**
  * Creates a new WebDriver client for Microsoft's Edge.
  */
-class Driver extends webdriver.WebDriver {
+class Driver extends chromium.Driver {
   /**
    * Creates a new browser session for Microsoft's Edge browser.
    *
-   * @param {(Capabilities|Options)=} options The configuration options.
-   * @param {remote.DriverService=} opt_service The service to use; will create
+   * @param {(Capabilities|Options)=} opt_config The configuration options.
+   * @param {remote.DriverService=} opt_serviceExecutor The service to use; will create
    *     a new Legacy or Chromium service based on {@linkplain Options} by default.
    * @return {!Driver} A new driver instance.
    */
-  static createSession(options, opt_service) {
-    options = options || new Options()
-    let service = opt_service || getDefaultService()
-    let client = service.start().then((url) => new http.HttpClient(url))
-    let executor = new http.Executor(client)
-
-    return /** @type {!Driver} */ (super.createSession(executor, options, () =>
-      service.kill()
-    ))
+  static createSession(opt_config, opt_serviceExecutor) {
+    let caps = opt_config || new Options()
+    return /** @type {!Driver} */ (
+      super.createSession(caps, opt_serviceExecutor)
+    )
   }
 
   /**
@@ -180,7 +174,7 @@ function setDefaultService(service) {
   if (defaultService && defaultService.isRunning()) {
     throw Error(
       'The previously configured EdgeDriver service is still running. ' +
-      'You must shut it down before you may adjust its configuration.'
+        'You must shut it down before you may adjust its configuration.'
     )
   }
   defaultService = service
@@ -199,7 +193,6 @@ function getDefaultService() {
   return defaultService
 }
 
-
 /**
  * _Synchronously_ attempts to locate the chromedriver executable on the current
  * system.
@@ -213,6 +206,7 @@ function locateSynchronously() {
 Options.prototype.BROWSER_NAME_VALUE = Browser.EDGE
 Options.prototype.CAPABILITY_KEY = 'ms:edgeOptions'
 Driver.prototype.VENDOR_CAPABILITY_PREFIX = 'ms'
+Driver.getDefaultService = getDefaultService
 
 // PUBLIC API
 

package/firefox.js

@@ -124,7 +124,6 @@ const io = require('./io')
 const remote = require('./remote')
 const webdriver = require('./lib/webdriver')
 const zip = require('./io/zip')
-const cdp = require('./devtools/CDPConnection')
 const { Browser, Capabilities } = require('./lib/capabilities')
 const { Zip } = require('./io/zip')
 
@@ -394,6 +393,24 @@ class Options extends Capabilities {
     }
     throw TypeError('binary must be a string path or Channel object')
   }
+
+  /**
+   * Enables Mobile start up features
+   *
+   * @param {string} androidPackage The package to use
+   * @return {!Options} A self reference
+   */
+  enableMobile(androidPackage = "org.mozilla.firefox", androidActivity = null, deviceSerial = null) {
+    this.firefoxOptions_().androidPackage = androidPackage
+
+    if (androidActivity) {
+      this.firefoxOptions_().androidActivity = androidActivity
+    }
+    if (deviceSerial) {
+      this.firefoxOptions_().deviceSerial = deviceSerial
+    }
+    return this
+  }
 }
 
 /**

package/http/index.js

@@ -77,8 +77,9 @@ class HttpClient {
    *     Defaults to `http.globalAgent`.
    * @param {?string=} opt_proxy The proxy to use for the connection to the
    *     server. Default is to use no proxy.
+   * @param {?Object.<string,Object>} client_options
    */
-  constructor(serverUrl, opt_agent, opt_proxy) {
+  constructor(serverUrl, opt_agent, opt_proxy, client_options = {}) {
     /** @private {http.Agent} */
     this.agent_ = opt_agent || null
 
@@ -88,12 +89,33 @@ class HttpClient {
      */
     this.options_ = getRequestOptions(serverUrl)
 
+    /**
+     * client options, header overrides
+     */
+    this.client_options = client_options
+
+    /**
+     * sets keep-alive for the agent
+     * see https://stackoverflow.com/a/58332910
+     */
+    this.keepAlive = this.client_options['keep-alive']
+
     /**
      * @private {?RequestOptions}
      */
     this.proxyOptions_ = opt_proxy ? getRequestOptions(opt_proxy) : null
   }
 
+  get keepAlive() {
+    return this.agent_.keepAlive
+  }
+
+  set keepAlive(value) {
+    if (value === 'true' || value === true) {
+      this.agent_.keepAlive = true
+    }
+  }
+
   /** @override */
   send(httpRequest) {
     let data
@@ -106,7 +128,7 @@ class HttpClient {
       })
     }
 
-    headers['User-Agent'] = USER_AGENT
+    headers['User-Agent'] = this.client_options['user-agent'] || USER_AGENT
     headers['Content-Length'] = 0
     if (httpRequest.method == 'POST' || httpRequest.method == 'PUT') {
       data = JSON.stringify(httpRequest.data)
@@ -232,7 +254,7 @@ function sendRequest(options, onOk, onError, opt_data, opt_proxy, opt_retries) {
           hash: location.hash,
           headers: {
             Accept: 'application/json; charset=utf-8',
-            'User-Agent': USER_AGENT,
+            'User-Agent': options.headers['User-Agent'] || USER_AGENT,
           },
         },
         onOk,

package/ie.js

@@ -18,7 +18,7 @@
 /**
  * @fileoverview Defines a {@linkplain Driver WebDriver} client for Microsoft's
  * Internet Explorer. Before using the IEDriver, you must download the latest
- * [IEDriverServer](http://selenium-release.storage.googleapis.com/index.html)
+ * [IEDriverServer](https://www.selenium.dev/downloads/)
  * and place it on your
  * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29). You must also apply
  * the system configuration outlined on the Selenium project
@@ -370,7 +370,7 @@ class Options extends Capabilities {
       behavior !== SCROLL_BEHAVIOUR.TOP &&
       behavior !== SCROLL_BEHAVIOUR.BOTTOM
     ) {
-      throw new error.InvalidArgumentError(`Element Scroll Behavior out of range. 
+      throw new error.InvalidArgumentError(`Element Scroll Behavior out of range.
       It should be either ${SCROLL_BEHAVIOUR.TOP} or ${SCROLL_BEHAVIOUR.BOTTOM}`)
     }
     this.options_[Key.ELEMENT_SCROLL_BEHAVIOR] = behavior
@@ -402,9 +402,9 @@ function createServiceFromCapabilities(capabilities) {
   if (!exe || !fs.existsSync(exe)) {
     throw Error(
       `${IEDRIVER_EXE} could not be found on the current PATH. Please ` +
-        `download the latest version of ${IEDRIVER_EXE} from ` +
-        'http://selenium-release.storage.googleapis.com/index.html and ' +
-        'ensure it can be found on your system PATH.'
+      `download the latest version of ${IEDRIVER_EXE} from ` +
+      'https://www.selenium.dev/downloads/ and ' +
+      'ensure it can be found on your system PATH.'
     )
   }
 
@@ -478,9 +478,9 @@ class Driver extends webdriver.WebDriver {
     let client = service.start().then((url) => new http.HttpClient(url))
     let executor = new http.Executor(client)
 
-    return /** @type {!Driver} */ (super.createSession(executor, options, () =>
-      service.kill()
-    ))
+    return /** @type {!Driver} */ (
+      super.createSession(executor, options, () => service.kill())
+    )
   }
 
   /**

package/index.js

@@ -103,7 +103,7 @@ function ensureFileDetectorsAreEnabled(ctor) {
  */
 class ThenableWebDriver {
   /** @param {...?} args */
-  static createSession(...args) {} // eslint-disable-line
+  static createSession(...args) { } // eslint-disable-line
 }
 
 /**
@@ -162,7 +162,7 @@ function createDriver(ctor, ...args) {
  *   option always takes precedence over {@code SELENIUM_SERVER_JAR}.
  *
  * - {@code SELENIUM_SERVER_JAR}: defines the path to the
- *   <a href="http://selenium-release.storage.googleapis.com/index.html">
+ *   <a href="https://www.selenium.dev/downloads/">
  *   standalone Selenium server</a> jar to use. The server will be started the
  *   first time a WebDriver instance and be killed when the process exits.
  *
@@ -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
@@ -615,7 +617,7 @@ class Builder {
     if (typeof browser !== 'string') {
       throw TypeError(
         `Target browser must be a string, but is <${typeof browser}>;` +
-          ' did you forget to call forBrowser()?'
+        ' did you forget to call forBrowser()?'
       )
     }
 
@@ -736,8 +738,8 @@ class Builder {
       default:
         throw new Error(
           'Do not know how to build driver: ' +
-            browser +
-            '; did you forget to call usingServer(url)?'
+          browser +
+          '; did you forget to call usingServer(url)?'
         )
     }
   }
@@ -793,9 +795,9 @@ function checkOptions(caps, key, optionType, setMethod) {
   if (val instanceof optionType) {
     throw new error.InvalidArgumentError(
       'Options class extends Capabilities and should not be set as key ' +
-        `"${key}"; set browser-specific options with ` +
-        `Builder.${setMethod}(). For more information, see the ` +
-        'documentation attached to the function that threw this error'
+      `"${key}"; set browser-specific options with ` +
+      `Builder.${setMethod}(). For more information, see the ` +
+      'documentation attached to the function that threw this error'
     )
   }
 }
@@ -807,6 +809,7 @@ exports.Builder = Builder
 exports.Button = input.Button
 exports.By = by.By
 exports.withTagName = by.withTagName
+exports.withLocator = by.withLocator
 exports.Capabilities = capabilities.Capabilities
 exports.Capability = capabilities.Capability
 exports.Condition = webdriver.Condition

package/io/exec.js

@@ -76,7 +76,8 @@ class Result {
   }
 }
 
-const COMMAND_RESULT = /** !WeakMap<!Command, !Promise<!Result>> */ new WeakMap()
+const COMMAND_RESULT =
+  /** !WeakMap<!Command, !Promise<!Result>> */ new WeakMap()
 const KILL_HOOK = /** !WeakMap<!Command, function(string)> */ new WeakMap()
 
 /**

package/lib/by.js

@@ -258,8 +258,36 @@ class By {
   }
 }
 
+/**
+ * Start Searching for relative objects using the value returned from
+ * `By.tagName()`.
+ *
+ * Note: this method will likely be removed in the future please use
+ * `locateWith`.
+ * @param {By} The value returned from calling By.tagName()
+ * @returns
+ */
 function withTagName(tagName) {
-  return new RelativeBy(tagName)
+  return new RelativeBy({ 'css selector': tagName })
+}
+
+/**
+ * Start searching for relative objects using search criteria with By.
+ * @param {string} A By map that shows how to find the initial element
+ * @returns {RelativeBy}
+ */
+function locateWith(by) {
+  return new RelativeBy(getLocator(by));
+}
+
+function getLocator(locatorOrElement) {
+  let toFind
+  if (locatorOrElement instanceof By) {
+    toFind = locatorOrElement.toObject()
+  } else {
+    toFind = locatorOrElement
+  }
+  return toFind
 }
 
 /**
@@ -269,11 +297,11 @@ function withTagName(tagName) {
  */
 class RelativeBy {
   /**
-   * @param {string} tagName
+   * @param {By} findDetails
    * @param {Array<Object>} filters
    */
-  constructor(tagName, filters = null) {
-    this.root = tagName
+  constructor(findDetails, filters = null) {
+    this.root = findDetails
     this.filters = filters || []
   }
 
@@ -285,7 +313,7 @@ class RelativeBy {
   above(locatorOrElement) {
     this.filters.push({
       kind: 'above',
-      args: [this.getLocator(locatorOrElement)],
+      args: [getLocator(locatorOrElement)],
     })
     return this
   }
@@ -298,7 +326,7 @@ class RelativeBy {
   below(locatorOrElement) {
     this.filters.push({
       kind: 'below',
-      args: [this.getLocator(locatorOrElement)],
+      args: [getLocator(locatorOrElement)],
     })
     return this
   }
@@ -311,7 +339,7 @@ class RelativeBy {
   toLeftOf(locatorOrElement) {
     this.filters.push({
       kind: 'left',
-      args: [this.getLocator(locatorOrElement)],
+      args: [getLocator(locatorOrElement)],
     })
     return this
   }
@@ -324,7 +352,7 @@ class RelativeBy {
   toRightOf(locatorOrElement) {
     this.filters.push({
       kind: 'right',
-      args: [this.getLocator(locatorOrElement)],
+      args: [getLocator(locatorOrElement)],
     })
     return this
   }
@@ -337,7 +365,7 @@ class RelativeBy {
   near(locatorOrElement) {
     this.filters.push({
       kind: 'near',
-      args: [this.getLocator(locatorOrElement)],
+      args: [getLocator(locatorOrElement)],
     })
     return this
   }
@@ -350,22 +378,12 @@ class RelativeBy {
   marshall() {
     return {
       relative: {
-        root: { 'css selector': this.root },
+        root: this.root,
         filters: this.filters,
       },
     }
   }
 
-  getLocator(locatorOrElement) {
-    let toFind
-    if (locatorOrElement instanceof By) {
-      toFind = locatorOrElement.toObject()
-    } else {
-      toFind = locatorOrElement
-    }
-    return toFind
-  }
-
   /** @override */
   toString() {
     // The static By.name() overrides this.constructor.name.  Shame...
@@ -411,5 +429,6 @@ module.exports = {
   By: By,
   RelativeBy: RelativeBy,
   withTagName: withTagName,
+  locateWith: locateWith,
   checkedLocator: check,
 }

package/lib/capabilities.js

@@ -263,7 +263,9 @@ class Capabilities {
    * @return {!Capabilities} A basic set of capabilities for Firefox.
    */
   static firefox() {
-    return new Capabilities().setBrowserName(Browser.FIREFOX).set("moz:debuggerAddress", true)
+    return new Capabilities()
+      .setBrowserName(Browser.FIREFOX)
+      .set('moz:debuggerAddress', true)
   }
 
   /**
@@ -280,6 +282,13 @@ class Capabilities {
     return new Capabilities().setBrowserName(Browser.SAFARI)
   }
 
+  /**
+   * @return {!Capabilities} A basic set of capabilities for Opera
+   */
+  static opera() {
+    return new Capabilities().setBrowserName(Browser.OPERA)
+  }
+
   /**
    * @return {!Object<string, ?>} The JSON representation of this instance.
    *     Note, the returned object may contain nested promised values.

package/lib/http.js

@@ -490,7 +490,8 @@ function buildRequest(customCommands, w3c, command) {
   }
 }
 
-const CLIENTS = /** !WeakMap<!Executor, !(Client|IThenable<!Client>)> */ new WeakMap()
+const CLIENTS =
+  /** !WeakMap<!Executor, !(Client|IThenable<!Client>)> */ new WeakMap()
 
 /**
  * A command executor that communicates with the server using JSON over HTTP.

package/lib/input.js

@@ -20,14 +20,8 @@
 /**
  * @fileoverview Defines types related to user input with the WebDriver API.
  */
-
-const promise = require('./promise')
 const { Command, Name } = require('./command')
-const {
-  InvalidArgumentError,
-  UnknownCommandError,
-  UnsupportedOperationError,
-} = require('./error')
+const { InvalidArgumentError } = require('./error')
 
 /**
  * Enumeration of the buttons used in the advanced interactions API.
@@ -503,7 +497,6 @@ class Actions {
    *     sequence (see class description for details).
    */
   constructor(executor, { async = false } = {}) {
-
     /** @private @const */
     this.executor_ = executor
 
@@ -882,13 +875,9 @@ class Actions {
       return Promise.resolve()
     }
 
-    try {
-      await this.executor_.execute(
-        new Command(Name.ACTIONS).setParameter('actions', _actions)
-      )
-    } catch (ex) {
-      throw ex
-    }
+    await this.executor_.execute(
+      new Command(Name.ACTIONS).setParameter('actions', _actions)
+    )
   }
 }
 

package/lib/until.js

@@ -137,14 +137,13 @@ exports.alertIsPresent = function alertIsPresent() {
  * @return {!Condition<boolean>} The new condition.
  */
 exports.titleIs = function titleIs(title) {
-  return new Condition(
-    'for title to be ' + JSON.stringify(title),
-    function (driver) {
-      return driver.getTitle().then(function (t) {
-        return t === title
-      })
-    }
-  )
+  return new Condition('for title to be ' + JSON.stringify(title), function (
+    driver
+  ) {
+    return driver.getTitle().then(function (t) {
+      return t === title
+    })
+  })
 }
 
 /**
@@ -189,14 +188,13 @@ exports.titleMatches = function titleMatches(regex) {
  * @return {!Condition<boolean>} The new condition.
  */
 exports.urlIs = function urlIs(url) {
-  return new Condition(
-    'for URL to be ' + JSON.stringify(url),
-    function (driver) {
-      return driver.getCurrentUrl().then(function (u) {
-        return u === url
-      })
-    }
-  )
+  return new Condition('for URL to be ' + JSON.stringify(url), function (
+    driver
+  ) {
+    return driver.getCurrentUrl().then(function (u) {
+      return u === url
+    })
+  })
 }
 
 /**

package/lib/webdriver.js

@@ -258,18 +258,18 @@ class IWebDriver {
   /**
    * @return {!command.Executor} The command executor used by this instance.
    */
-  getExecutor() {}
+  getExecutor() { }
 
   /**
    * @return {!Promise<!Session>} A promise for this client's session.
    */
-  getSession() {}
+  getSession() { }
 
   /**
    * @return {!Promise<!Capabilities>} A promise that will resolve with
    *     the this instance's capabilities.
    */
-  getCapabilities() {}
+  getCapabilities() { }
 
   /**
    * Terminates the browser session. After calling quit, this instance will be
@@ -279,7 +279,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when the
    *     command has completed.
    */
-  quit() {}
+  quit() { }
 
   /**
    * Creates a new action sequence using this driver. The sequence will not be
@@ -458,7 +458,7 @@ class IWebDriver {
     timeout = undefined, // eslint-disable-line
     message = undefined, // eslint-disable-line
     pollTimeout = undefined // eslint-disable-line
-  ) {}
+  ) { }
 
   /**
    * Makes the driver sleep for the given amount of time.
@@ -475,7 +475,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     window handle.
    */
-  getWindowHandle() {}
+  getWindowHandle() { }
 
   /**
    * Retrieves a list of all available window handles.
@@ -483,7 +483,7 @@ class IWebDriver {
    * @return {!Promise<!Array<string>>} A promise that will be resolved with an
    *     array of window handles.
    */
-  getAllWindowHandles() {}
+  getAllWindowHandles() { }
 
   /**
    * Retrieves the current page's source. The returned source is a representation
@@ -493,7 +493,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     page source.
    */
-  getPageSource() {}
+  getPageSource() { }
 
   /**
    * Closes the current window.
@@ -501,7 +501,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when this command
    *     has completed.
    */
-  close() {}
+  close() { }
 
   /**
    * Navigates to the given URL.
@@ -518,7 +518,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the
    *     current URL.
    */
-  getCurrentUrl() {}
+  getCurrentUrl() { }
 
   /**
    * Retrieves the current page title.
@@ -526,7 +526,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     page's title.
    */
-  getTitle() {}
+  getTitle() { }
 
   /**
    * Locates an element on the page. If the element cannot be found, a
@@ -590,23 +590,23 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved to the
    *     screenshot as a base-64 encoded PNG.
    */
-  takeScreenshot() {}
+  takeScreenshot() { }
 
   /**
    * @return {!Options} The options interface for this instance.
    */
-  manage() {}
+  manage() { }
 
   /**
    * @return {!Navigation} The navigation interface for this instance.
    */
-  navigate() {}
+  navigate() { }
 
   /**
    * @return {!TargetLocator} The target locator interface for this
    *     instance.
    */
-  switchTo() {}
+  switchTo() { }
 
   /**
    *
@@ -665,7 +665,7 @@ class WebDriver {
     // If session is a rejected promise, add a no-op rejection handler.
     // This effectively hides setup errors until users attempt to interact
     // with the session.
-    this.session_.catch(function () {})
+    this.session_.catch(function () { })
 
     /** @private {!command.Executor} */
     this.executor_ = executor
@@ -761,12 +761,12 @@ class WebDriver {
       this.session_ = Promise.reject(
         new error.NoSuchSessionError(
           'This driver instance does not have a valid session ID ' +
-            '(did you call WebDriver.quit()?) and may no longer be used.'
+          '(did you call WebDriver.quit()?) and may no longer be used.'
         )
       )
 
       // Only want the session rejection to bubble if accessed.
-      this.session_.catch(function () {})
+      this.session_.catch(function () { })
 
       if (this.onQuit_) {
         return this.onQuit_.call(void 0)
@@ -827,18 +827,15 @@ class WebDriver {
             let timeoutMessage = resolveWaitMessage(message)
             reject(
               new error.TimeoutError(
-                `${timeoutMessage}Timed out waiting for promise to resolve after ${
-                  Date.now() - start
+                `${timeoutMessage}Timed out waiting for promise to resolve after ${Date.now() - start
                 }ms`
               )
             )
           } catch (ex) {
             reject(
               new error.TimeoutError(
-                `${
-                  ex.message
-                }\nTimed out waiting for promise to resolve after ${
-                  Date.now() - start
+                `${ex.message
+                }\nTimed out waiting for promise to resolve after ${Date.now() - start
                 }ms`
               )
             )
@@ -868,7 +865,7 @@ class WebDriver {
     if (typeof fn !== 'function') {
       throw TypeError(
         'Wait condition must be a promise-like object, function, or a ' +
-          'Condition object'
+        'Condition object'
       )
     }
 
@@ -920,7 +917,7 @@ class WebDriver {
           if (!(value instanceof WebElement)) {
             throw TypeError(
               'WebElementCondition did not resolve to a WebElement: ' +
-                Object.prototype.toString.call(value)
+              Object.prototype.toString.call(value)
             )
           }
           return value
@@ -1732,7 +1729,7 @@ class Options {
       } else if (typeof value !== 'undefined') {
         throw TypeError(
           'invalid timeouts configuration:' +
-            ` expected "${key}" to be a number, got ${typeof value}`
+          ` expected "${key}" to be a number, got ${typeof value}`
         )
       }
     }
@@ -1793,7 +1790,7 @@ function legacyTimeout(driver, type, ms) {
  *
  * @record
  */
-Options.Cookie = function () {}
+Options.Cookie = function () { }
 
 /**
  * The name of the cookie.
@@ -2498,18 +2495,18 @@ class WebElement {
    */
   async sendKeys(...args) {
     let keys = []
-    ;(await Promise.all(args)).forEach((key) => {
-      let type = typeof key
-      if (type === 'number') {
-        key = String(key)
-      } else if (type !== 'string') {
-        throw TypeError('each key must be a number of string; got ' + type)
-      }
+      ; (await Promise.all(args)).forEach((key) => {
+        let type = typeof key
+        if (type === 'number') {
+          key = String(key)
+        } else if (type !== 'string') {
+          throw TypeError('each key must be a number of string; got ' + type)
+        }
 
-      // The W3C protocol requires keys to be specified as an array where
-      // each element is a single key.
-      keys.push(...key.split(''))
-    })
+        // The W3C protocol requires keys to be specified as an array where
+        // each element is a single key.
+        keys.push(...key.split(''))
+      })
 
     if (!this.driver_.fileDetector_) {
       return this.execute_(
@@ -2728,18 +2725,12 @@ class WebElement {
    * Take a screenshot of the visible region encompassed by this element's
    * bounding rectangle.
    *
-   * @param {boolean=} scroll Optional argument that indicates whether the
-   *     element should be scrolled into view before taking a screenshot.
-   *     Defaults to false.
    * @return {!Promise<string>} A promise that will be
    *     resolved to the screenshot as a base-64 encoded PNG.
    */
-  takeScreenshot(scroll = false) {
+  takeScreenshot() {
     return this.execute_(
-      new command.Command(command.Name.TAKE_ELEMENT_SCREENSHOT).setParameter(
-        'scroll',
-        scroll
-      )
+      new command.Command(command.Name.TAKE_ELEMENT_SCREENSHOT)
     )
   }
 }

package/opera.js

@@ -383,9 +383,9 @@ class Driver extends webdriver.WebDriver {
       caps = options.toCapabilities(caps)
     }
 
-    return /** @type {!Driver} */ (super.createSession(executor, caps, () =>
-      service.kill()
-    ))
+    return /** @type {!Driver} */ (
+      super.createSession(executor, caps, () => service.kill())
+    )
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.0.0-beta.4",
+  "version": "4.0.0-rc-1",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [
@@ -35,7 +35,7 @@
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^3.4.0",
     "express": "^4.17.1",
-    "jasmine": "^3.6.1",
+    "jasmine": "^3.8.0",
     "mocha": "^8.1.0",
     "multer": "^1.4.2",
     "prettier": "^2.3.0",

package/remote/index.js

@@ -448,7 +448,7 @@ DriverService.Builder = class {
 
 /**
  * Manages the life and death of the
- * <a href="http://selenium-release.storage.googleapis.com/index.html">
+ * <a href="https://www.selenium.dev/downloads/">
  * standalone Selenium server</a>.
  */
 class SeleniumServer extends DriverService {
@@ -562,7 +562,7 @@ SeleniumServer.Options = class {
 /**
  * A {@link webdriver.FileDetector} that may be used when running
  * against a remote
- * [Selenium server](http://selenium-release.storage.googleapis.com/index.html).
+ * [Selenium server](https://www.selenium.dev/downloads/).
  *
  * When a file path on the local machine running this script is entered with
  * {@link webdriver.WebElement#sendKeys WebElement#sendKeys}, this file detector

package/safari.js

@@ -154,9 +154,9 @@ class Driver extends webdriver.WebDriver {
       service.start().then((url) => new http.HttpClient(url))
     )
 
-    return /** @type {!Driver} */ (super.createSession(executor, caps, () =>
-      service.kill()
-    ))
+    return /** @type {!Driver} */ (
+      super.createSession(executor, caps, () => service.kill())
+    )
   }
 }
 

package/testing/index.js

@@ -47,7 +47,7 @@ const { Builder } = require('../index')
  * Describes a browser targeted by a {@linkplain suite test suite}.
  * @record
  */
-function TargetBrowser() { }
+function TargetBrowser() {}
 
 /**
  * The {@linkplain Browser name} of the targeted browser.
@@ -210,7 +210,7 @@ function init(force = false) {
   if (seleniumJar && seleniumUrl) {
     throw Error(
       'Ambiguous test configuration: both SELENIUM_REMOTE_URL' +
-      ' && SELENIUM_SERVER_JAR environment variables are set'
+        ' && SELENIUM_SERVER_JAR environment variables are set'
     )
   }
 
@@ -218,8 +218,8 @@ function init(force = false) {
   if ((seleniumJar || seleniumUrl) && envBrowsers.length === 0) {
     throw Error(
       'Ambiguous test configuration: when either the SELENIUM_REMOTE_URL or' +
-      ' SELENIUM_SERVER_JAR environment variable is set, the' +
-      ' SELENIUM_BROWSER variable must also be set.'
+        ' SELENIUM_SERVER_JAR environment variable is set, the' +
+        ' SELENIUM_BROWSER variable must also be set.'
     )
   }
 
@@ -236,7 +236,8 @@ function init(force = false) {
 }
 
 const TARGET_MAP = /** !WeakMap<!Environment, !TargetBrowser> */ new WeakMap()
-const URL_MAP = /** !WeakMap<!Environment, ?(string|remote.SeleniumServer)> */ new WeakMap()
+const URL_MAP =
+  /** !WeakMap<!Environment, ?(string|remote.SeleniumServer)> */ new WeakMap()
 
 /**
  * Defines the environment a {@linkplain suite test suite} is running against.
@@ -249,9 +250,9 @@ class Environment {
    *     Selenium server to test against.
    */
   constructor(browser, url = undefined) {
-    browser = /** @type {!TargetBrowser} */ (Object.seal(
-      Object.assign({}, browser)
-    ))
+    browser = /** @type {!TargetBrowser} */ (
+      Object.seal(Object.assign({}, browser))
+    )
 
     TARGET_MAP.set(this, browser)
     URL_MAP.set(this, url || null)
@@ -288,7 +289,6 @@ class Environment {
 
     const realBuild = builder.build
     builder.build = function () {
-
       builder.forBrowser(browser.name, browser.version, browser.platform)
 
       if (browser.capabilities) {
@@ -311,7 +311,7 @@ class Environment {
  * Configuration options for a {@linkplain ./index.suite test suite}.
  * @record
  */
-function SuiteOptions() { }
+function SuiteOptions() {}
 
 /**
  * The browsers to run the test suite against.
@@ -486,8 +486,8 @@ function getTestHook(name) {
   if (type !== 'function') {
     throw TypeError(
       `Expected global.${name} to be a function, but is ${type}.` +
-      ' This can happen if you try using this module when running with' +
-      ' node directly instead of using jasmine or mocha'
+        ' This can happen if you try using this module when running with' +
+        ' node directly instead of using jasmine or mocha'
     )
   }
   return fn