selenium-webdriver 4.0.0-beta.2 → 4.0.0-beta.3

package/CHANGES.md

@@ -1,3 +1,13 @@
+## v4.0.0-beta.3
+
+* Removed support for legacy actions.
+  This will also remove "Bride Mode" support, which was introduced to translate of action class to legacy API.
+* Remove devtools support for v86,v87 and adding support for v89, v90, v91
+* make isPromise() return boolean value for null and undefined cases (#6785)
+* code cleanup  (#9158)
+* replacing asserts equal with strictEqual and deepEqual with deepStrictEqual
+
+
 ## v4.0.0-beta.2
 
 * Removed support for Edge legacy.

package/io/exec.js

@@ -121,9 +121,9 @@ class Command {
  * @return {!Command} The launched command.
  */
 module.exports = function exec(command, opt_options) {
-  var options = opt_options || {}
+  const options = opt_options || {}
 
-  var proc = childProcess.spawn(command, options.args || [], {
+  let proc = childProcess.spawn(command, options.args || [], {
     env: options.env || process.env,
     stdio: options.stdio || 'ignore',
   })
@@ -133,7 +133,7 @@ module.exports = function exec(command, opt_options) {
   proc.unref()
   process.once('exit', onProcessExit)
 
-  let result = new Promise((resolve) => {
+  const result = new Promise((resolve) => {
     proc.once('exit', (code, signal) => {
       proc = null
       process.removeListener('exit', onProcessExit)

package/io/index.js

@@ -204,13 +204,12 @@ exports.tmpDir = function () {
  */
 exports.tmpFile = function (opt_options) {
   return checkedCall((callback) => {
-    // |tmp.file| checks arguments length to detect options rather than doing a
-    // truthy check, so we must only pass options if there are some to pass.
-    if (opt_options) {
-      tmp.file(opt_options, callback)
-    } else {
-      tmp.file(callback)
-    }
+    /**  check fixed in v > 0.2.1 if
+     * (typeof options === 'function') {
+     *     return [{}, options];
+     * }
+     */
+    tmp.file(opt_options, callback)
   })
 }
 
@@ -224,7 +223,7 @@ exports.tmpFile = function (opt_options) {
  *     not be found.
  */
 exports.findInPath = function (file, opt_checkCwd) {
-  let dirs = []
+  const dirs = []
   if (opt_checkCwd) {
     dirs.push(process.cwd())
   }
@@ -329,7 +328,7 @@ exports.mkdirp = function mkdirp(dir) {
  *     will be relative to `rootPath`.
  */
 exports.walkDir = function (rootPath) {
-  let seen = []
+  const seen = []
   return (function walk(dir) {
     return checkedCall((callback) => fs.readdir(dir, callback)).then((files) =>
       Promise.all(

package/io/zip.js

@@ -180,8 +180,8 @@ function load(path) {
  */
 function unzip(src, dst) {
   return load(src).then((zip) => {
-    let promisedDirs = new Map()
-    let promises = []
+    const promisedDirs = new Map()
+    const promises = []
 
     zip.z_.forEach((relPath, file) => {
       let p
@@ -218,7 +218,6 @@ function unzip(src, dst) {
 }
 
 // PUBLIC API
-
-exports.Zip = Zip
-exports.load = load
-exports.unzip = unzip
+module.exports.Zip = Zip
+module.exports.load = load
+module.exports.unzip = unzip

package/lib/command.js

@@ -177,21 +177,6 @@ const Name = {
 
   ACTIONS: 'actions',
   CLEAR_ACTIONS: 'clearActions',
-
-  LEGACY_ACTION_CLICK: 'legacyAction:click',
-  LEGACY_ACTION_DOUBLE_CLICK: 'legacyAction:doubleclick',
-  LEGACY_ACTION_MOUSE_DOWN: 'legacyAction:mouseDown',
-  LEGACY_ACTION_MOUSE_UP: 'legacyAction:mouseUp',
-  LEGACY_ACTION_MOUSE_MOVE: 'legacyAction:mouseMove',
-  LEGACY_ACTION_SEND_KEYS: 'legacyAction:sendKeys',
-  LEGACY_ACTION_TOUCH_DOWN: 'legacyAction:touchDown',
-  LEGACY_ACTION_TOUCH_UP: 'legacyAction:touchUp',
-  LEGACY_ACTION_TOUCH_MOVE: 'legacyAction:touchMove',
-  LEGACY_ACTION_TOUCH_SCROLL: 'legacyAction:touchScroll',
-  LEGACY_ACTION_TOUCH_LONG_PRESS: 'legacyAction:touchLongPress',
-  LEGACY_ACTION_TOUCH_FLICK: 'legacyAction:touchFlick',
-  LEGACY_ACTION_TOUCH_SINGLE_TAP: 'legacyAction:singleTap',
-  LEGACY_ACTION_TOUCH_DOUBLE_TAP: 'legacyAction:doubleTap',
 }
 
 /**

package/lib/http.js

@@ -305,35 +305,6 @@ const COMMAND_MAP = new Map([
   [cmd.Name.GET_AVAILABLE_LOG_TYPES, get('/session/:sessionId/log/types')],
   [cmd.Name.GET_SESSION_LOGS, post('/logs')],
   [cmd.Name.UPLOAD_FILE, post('/session/:sessionId/se/file')],
-  [cmd.Name.LEGACY_ACTION_CLICK, post('/session/:sessionId/click')],
-  [
-    cmd.Name.LEGACY_ACTION_DOUBLE_CLICK,
-    post('/session/:sessionId/doubleclick'),
-  ],
-  [cmd.Name.LEGACY_ACTION_MOUSE_DOWN, post('/session/:sessionId/buttondown')],
-  [cmd.Name.LEGACY_ACTION_MOUSE_UP, post('/session/:sessionId/buttonup')],
-  [cmd.Name.LEGACY_ACTION_MOUSE_MOVE, post('/session/:sessionId/moveto')],
-  [cmd.Name.LEGACY_ACTION_SEND_KEYS, post('/session/:sessionId/keys')],
-  [cmd.Name.LEGACY_ACTION_TOUCH_DOWN, post('/session/:sessionId/touch/down')],
-  [cmd.Name.LEGACY_ACTION_TOUCH_UP, post('/session/:sessionId/touch/up')],
-  [cmd.Name.LEGACY_ACTION_TOUCH_MOVE, post('/session/:sessionId/touch/move')],
-  [
-    cmd.Name.LEGACY_ACTION_TOUCH_SCROLL,
-    post('/session/:sessionId/touch/scroll'),
-  ],
-  [
-    cmd.Name.LEGACY_ACTION_TOUCH_LONG_PRESS,
-    post('/session/:sessionId/touch/longclick'),
-  ],
-  [cmd.Name.LEGACY_ACTION_TOUCH_FLICK, post('/session/:sessionId/touch/flick')],
-  [
-    cmd.Name.LEGACY_ACTION_TOUCH_SINGLE_TAP,
-    post('/session/:sessionId/touch/click'),
-  ],
-  [
-    cmd.Name.LEGACY_ACTION_TOUCH_DOUBLE_TAP,
-    post('/session/:sessionId/touch/doubleclick'),
-  ],
 ])
 
 /** @const {!Map<string, (CommandSpec|CommandTransformer)>} */

package/lib/input.js

@@ -489,67 +489,6 @@ Pointer.Type = {
  * | Keyboard | pause(100)            | keyDown(SHIFT) |
  * | Mouse    | move({duration: 300}) |                |
  *
- *
- * #### Bridge Mode
- *
- * As of January 2018, only Firefox natively supports this API. For other
- * browsers, you may either use the
- * {@link ./actions.LegacyActionSequence LegacyActionSequence} class, _or_ you
- * can put the Actions class into bridge mode by passing `{bridge: true}` on
- * creation:
- *
- *     const actions = driver.actions({bridge: true});
- *     await actions.click(element).sendKeys('abc').perform();
- *
- * In bridge mode, {@link #perform perform()} will first attempt to execute the
- * configured action sequence using the W3C action protocol. If this is rejected
- * by the remote end, the sequence will be translated to and executed against
- * the legacy protocol.
- *
- * Bridge mode __is not enabled by default__ as there are several notable
- * differences between W3C-specified and legacy protocols. Care must be
- * taken to configure your action sequences to account for these differences:
- *
- * 1.  For W3C actions, the entire action sequence is executed in a single
- *     call to the remote end. For legacy sequences, multiple calls must be
- *     made for each step in the sequence. This introduces additional latency
- *     which may impact how the browser responds to the emulated user actions.
- *
- * 2.  For the legacy actions, {@linkplain #pause pauses} are handled _locally_.
- *
- * 3.  For legacy actions, a {@linkplain #keyDown keyDown()} for a
- *     _non-modifier key_ **must** be followed by a {@linkplain #keyUP keyUp()}
- *     for the same key. This will be handled for you if you use the
- *     {@linkplain #sendKeys sendKeys()} method.
- *
- * 4.  Mouse movements may not be specified relative to
- *     {@linkplain ./input.Origin.VIEWPORT Origin.VIEWPORT}.
- *     All movements must be relative to an element or the mouse's current
- *     position ({@linkplain ./input.Origin.POINTER Origin.POINTER}).
- *     The {@linkplain #move move()} method defaults to viewport relative
- *     offsets, so you must always specify an appropriate origin in bridge mode:
- *
- *         driver.actions({bridge: true})
- *             .move({x: 0, y: 0, origin: Origin.POINTER})
- *             .perform();
- *         driver.actions({bridge: true})
- *             .move({x: 0, y: 0, origin: someWebElement})
- *             .perform();
- *
- * 5.  The legacy protocol does not support specifying the duration of a
- *     {@linkplain #move mouse movement}; any specified duration _is ignored_
- *     when translating actions to the legacy protocol.
- *
- * 6.  For W3C actions, move offsets relative to a
- *     {@linkplain ./webdriver.WebElement WebElement} are interpreted relative
- *     to the center of an element's _first_ [client rect] in the viewport. For
- *     legacy actions, element offsets are relative to the top-left corner of
- *     the element's [bounding client rect]. When translating actions to the
- *     legacy protocol in bridge mode, an extra command must be inserted to
- *     translate move offsets from one frame of reference to the other. This
- *     extra command contributes to the overall latency issue outlined in
- *     point 1.
- *
  * [client rect]: https://developer.mozilla.org/en-US/docs/Web/API/Element/getClientRects
  * [bounding client rect]: https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect
  *
@@ -560,16 +499,10 @@ class Actions {
   /**
    * @param {!Executor} executor The object to execute the configured
    *     actions with.
-   * @param {{async: (boolean|undefined),
-   *          bridge: (boolean|undefined)}} options Options for this action
+   * @param {{async: (boolean|undefined)}} options Options for this action
    *     sequence (see class description for details).
    */
-  constructor(executor, { async = false, bridge = false } = {}) {
-    if (async && bridge) {
-      throw new InvalidArgumentError(
-        'Async sequences not supported with bridge mode'
-      )
-    }
+  constructor(executor, { async = false } = {}) {
 
     /** @private @const */
     this.executor_ = executor
@@ -577,9 +510,6 @@ class Actions {
     /** @private @const */
     this.sync_ = !async
 
-    /** @private @const */
-    this.bridge_ = !!bridge
-
     /** @private @const */
     this.keyboard_ = new Keyboard('default keyboard')
 
@@ -957,13 +887,6 @@ class Actions {
         new Command(Name.ACTIONS).setParameter('actions', _actions)
       )
     } catch (ex) {
-      if (
-        this.bridge_ &&
-        (ex instanceof UnknownCommandError ||
-          ex instanceof UnsupportedOperationError)
-      ) {
-        return executeLegacy(this.executor_, this.sequences_)
-      }
       throw ex
     }
   }
@@ -980,213 +903,6 @@ function isIdle(actions) {
   )
 }
 
-const MODIFIER_KEYS = new Set([Key.ALT, Key.CONTROL, Key.SHIFT, Key.COMMAND])
-
-/**
- * @param {!Executor} executor
- * @param {!Map<!Device, !Array<!Action>>} sequences
- * @return {!Promise<void>}
- * @suppress {deprecated} Ignore warnings about using LegacyActionSequence.
- */
-async function executeLegacy(executor, sequences) {
-  let maxLength = 0
-  sequences.forEach((seq) => (maxLength = Math.max(maxLength, seq.length)))
-
-  const actions = []
-  for (let i = 0; i < maxLength; i++) {
-    let next
-    for (const device of sequences.keys()) {
-      const seq = sequences.get(device)
-
-      if (
-        device instanceof Pointer &&
-        device.pointerType_ !== Pointer.Type.MOUSE
-      ) {
-        throw new UnsupportedOperationError(
-          `${device.pointerType_} pointer not supported in bridge mode`
-        )
-      }
-
-      const action = seq[i]
-      if (!action || (action.type === Action.Type.PAUSE && !action.duration)) {
-        continue
-      }
-
-      // -  If we've already found an action for this tick:
-      //    -  If we have two pauses, use the one with a longer duration
-      //    -  If one is a pause and the other isn't, use the non-pause
-      //    -  Otherwise, two non-pauses is an error.
-      // - Otherwise, we haven't selected an action yet.
-      if (next) {
-        if (next.type === Action.Type.PAUSE) {
-          if (action.type === Action.Type.PAUSE) {
-            next = next.duration > action.duration ? next : action
-          } else {
-            next = action
-          }
-        } else if (action.type !== Action.Type.PAUSE) {
-          throw new UnsupportedOperationError(
-            'parallel actions not supported in bridge mode'
-          )
-        }
-      } else {
-        next = action
-      }
-
-      if (action.type === Action.Type.KEY_DOWN) {
-        // If this action is a keydown for a non-modifier key, the next action
-        // must be a keyup for the same key, otherwise it cannot be translated
-        // to the legacy action API.
-        if (!MODIFIER_KEYS.has(action.value)) {
-          const nextAction = seq[i + 1]
-          if (
-            !nextAction ||
-            nextAction.type !== Action.Type.KEY_UP ||
-            nextAction.value !== action.value
-          ) {
-            throw new UnsupportedOperationError(
-              `in bridge mode, keydown for <${action.value}> must be followed` +
-                ' by a keyup for the same key'
-            )
-          }
-        }
-      } else if (
-        action.type === Action.Type.KEY_UP &&
-        !MODIFIER_KEYS.has(action.value)
-      ) {
-        next = null
-      }
-    }
-
-    if (next) {
-      actions.push(next)
-    }
-  }
-
-  for (let i = 0; i < actions.length; i++) {
-    const action = actions[i]
-    switch (action.type) {
-      case Action.Type.PAUSE: {
-        await promise.delayed(action.duration || 0)
-        break
-      }
-      case Action.Type.KEY_DOWN: {
-        const keys = [action.value]
-        if (!MODIFIER_KEYS.has(action.value)) {
-          // eslint-disable-next-line no-inner-declarations
-          function nextIsKeyDown() {
-            const next = actions[i + 1]
-            return (
-              !!next &&
-              next.type === Action.Type.KEY_DOWN &&
-              !MODIFIER_KEYS.has(next.value)
-            )
-          }
-          for (; nextIsKeyDown(); i++) {
-            keys.push(actions[i + 1].value)
-          }
-        }
-        await executor.execute(
-          new Command(Name.LEGACY_ACTION_SEND_KEYS).setParameter('value', keys)
-        )
-        break
-      }
-      case Action.Type.KEY_UP: {
-        await executor.execute(
-          new Command(Name.LEGACY_ACTION_SEND_KEYS).setParameter('value', [
-            action.value,
-          ])
-        )
-        break
-      }
-      case Action.Type.POINTER_DOWN: {
-        // eslint-disable-next-line no-inner-declarations
-        function isClick(startAt) {
-          const first = actions[startAt]
-          const second = actions[startAt + 1]
-          return (
-            !!first &&
-            !!second &&
-            first.type === Action.Type.POINTER_DOWN &&
-            second.type === Action.Type.POINTER_UP &&
-            first.button === second.button
-          )
-        }
-
-        // eslint-disable-next-line no-inner-declarations
-        function isDoubleClick(startAt) {
-          return (
-            isClick(startAt) &&
-            isClick(startAt + 2) &&
-            actions[startAt].button === actions[(startAt = 2)].button
-          )
-        }
-
-        let cmd
-        if (isDoubleClick(i)) {
-          i += 3 // Consume the pointer up/down/up.
-          cmd = Name.LEGACY_ACTION_DOUBLE_CLICK
-        } else if (isClick(i)) {
-          i++ // Consume the pointer-up.
-          cmd = Name.LEGACY_ACTION_CLICK
-        } else {
-          cmd = Name.LEGACY_ACTION_MOUSE_DOWN
-        }
-        await executor.execute(
-          new Command(cmd).setParameter('button', action.button)
-        )
-        break
-      }
-      case Action.Type.POINTER_UP: {
-        await executor.execute(
-          new Command(Name.LEGACY_ACTION_MOUSE_UP).setParameter(
-            'button',
-            action.button
-          )
-        )
-        break
-      }
-      case Action.Type.POINTER_MOVE: {
-        if (action.origin === Origin.VIEWPORT) {
-          throw new UnsupportedOperationError(
-            `pointer movements relative to ${Origin.VIEWPORT} are not` +
-              ' supported in bridge mode'
-          )
-        }
-
-        let x = action.x
-        let y = action.y
-        const cmd = new Command(Name.LEGACY_ACTION_MOUSE_MOVE)
-        if (action.origin && action.origin !== Origin.POINTER) {
-          const el = /** @type {!./webdriver.WebElement} */ (action.origin)
-
-          // Need to translate frame of reference from center of element's first
-          // client rect to the top-left of its bounding client rect. See:
-          // https://w3c.github.io/webdriver/webdriver-spec.html#dfn-center-point
-          let diff = await executor.execute(
-            new Command(Name.EXECUTE_SCRIPT)
-              .setParameter('script', INTERNAL_COMPUTE_OFFSET_SCRIPT)
-              .setParameter('args', [el])
-          )
-          x += diff[0]
-          y += diff[1]
-
-          const id = await el.getId()
-          cmd.setParameter('element', id)
-        }
-        cmd.setParameter('xoffset', x).setParameter('yoffset', y)
-        await executor.execute(cmd)
-        break
-      }
-      default: {
-        throw new UnsupportedOperationError(
-          `${action.type} actions not supported in bridge mode`
-        )
-      }
-    }
-  }
-}
-
 /**
  * Script used to compute the offset from the center of a DOM element's first
  * client rect from the top-left corner of the element's bounding client rect.

package/lib/promise.js

@@ -30,17 +30,7 @@
  * @return {boolean} Whether the value is a promise.
  */
 function isPromise(value) {
-  try {
-    // Use array notation so the Closure compiler does not obfuscate away our
-    // contract.
-    return (
-      value &&
-      (typeof value === 'object' || typeof value === 'function') &&
-      typeof value['then'] === 'function'
-    )
-  } catch (ex) {
-    return false
-  }
+  return Object.prototype.toString.call(value) === '[object Promise]'
 }
 
 /**
@@ -50,9 +40,7 @@ function isPromise(value) {
  * @return {!Promise<void>} The promise.
  */
 function delayed(ms) {
-  return new Promise((resolve) => {
-    setTimeout(resolve, ms)
-  })
+  return new Promise((resolve) => setTimeout(resolve, ms))
 }
 
 /**
@@ -199,8 +187,8 @@ async function filter(array, fn, self = undefined) {
 
   for (let i = 0; i < n; i++) {
     if (i in arr) {
-      let value = arr[i]
-      let include = await fn.call(self, value, i, arr)
+      const value = arr[i]
+      const include = await fn.call(self, value, i, arr)
       if (include) {
         values[valuesLength++] = value
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "selenium-webdriver",
-  "version": "4.0.0-beta.2",
+  "version": "4.0.0-beta.3",
   "description": "The official WebDriver JavaScript bindings from the Selenium project",
   "license": "Apache-2.0",
   "keywords": [

package/remote/index.js

@@ -210,7 +210,7 @@ class DriverService {
           }
 
           return resolveCommandLineFlags(this.args_).then((args) => {
-            var command = exec(self.executable_, {
+            const command = exec(self.executable_, {
               args: args,
               env: self.env_,
               stdio: self.stdio_,
@@ -218,8 +218,8 @@ class DriverService {
 
             resolveCommand(command)
 
-            var earlyTermination = command.result().then(function (result) {
-              var error =
+            const earlyTermination = command.result().then(function (result) {
+              const error =
                 result.code == null
                   ? Error('Server was killed with ' + result.signal)
                   : Error('Server terminated early with status ' + result.code)
@@ -229,7 +229,7 @@ class DriverService {
               throw error
             })
 
-            var hostname = self.hostname_
+            let hostname = self.hostname_
             if (!hostname) {
               hostname =
                 (!self.loopbackOnly_ && net.getAddress()) ||
@@ -338,9 +338,8 @@ DriverService.Builder = class {
    * @this {THIS}
    * @template THIS
    */
-  addArguments(var_args) { // eslint-disable-line
-    let args = Array.prototype.slice.call(arguments, 0)
-    this.options_.args = this.options_.args.concat(args)
+  addArguments(...arguments_) {
+    this.options_.args = this.options_.args.concat(arguments_)
     return this
   }
 

package/lib/actions.js

@@ -1,627 +0,0 @@
-// Licensed to the Software Freedom Conservancy (SFC) under one
-// or more contributor license agreements.  See the NOTICE file
-// distributed with this work for additional information
-// regarding copyright ownership.  The SFC licenses this file
-// to you under the Apache License, Version 2.0 (the
-// "License"); you may not use this file except in compliance
-// with the License.  You may obtain a copy of the License at
-//
-//   http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing,
-// software distributed under the License is distributed on an
-// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-// KIND, either express or implied.  See the License for the
-// specific language governing permissions and limitations
-// under the License.
-
-'use strict'
-
-const command = require('./command')
-const error = require('./error')
-const input = require('./input')
-
-/**
- * @param {!IArrayLike} args .
- * @return {!Array} .
- */
-function flatten(args) {
-  const result = []
-  for (let i = 0; i < args.length; i++) {
-    const element = args[i]
-    if (Array.isArray(element)) {
-      result.push.apply(result, flatten(element))
-    } else {
-      result.push(element)
-    }
-  }
-  return result
-}
-
-const MODIFIER_KEYS = new Set([
-  input.Key.ALT,
-  input.Key.CONTROL,
-  input.Key.SHIFT,
-  input.Key.COMMAND,
-])
-
-/**
- * Checks that a key is a modifier key.
- * @param {!input.Key} key The key to check.
- * @throws {error.InvalidArgumentError} If the key is not a modifier key.
- * @private
- */
-function checkModifierKey(key) {
-  if (!MODIFIER_KEYS.has(key)) {
-    throw new error.InvalidArgumentError('Not a modifier key')
-  }
-}
-
-/**
- * Class for defining sequences of complex user interactions. Each sequence
- * will not be executed until {@link #perform} is called.
- *
- * This class should not be instantiated directly. Instead, obtain an instance
- * using {@link ./webdriver.WebDriver#actions() WebDriver.actions()}.
- *
- * Sample usage:
- *
- *     new LegacyActions(driver).
- *         keyDown(Key.SHIFT).
- *         click(element1).
- *         click(element2).
- *         dragAndDrop(element3, element4).
- *         keyUp(Key.SHIFT).
- *         perform();
- *
- * @deprecated This class is strongly deprecated and will be removed once
- *     [Google's Chrome][Chrome] and [Microsoft's Edge][Edge] browsers
- *     support the new action sequence API.
- *
- * [Chrome]: https://chromium.googlesource.com/chromium/src/+/master/docs/chromedriver_status.md
- * [Edge]: https://docs.microsoft.com/en-us/microsoft-edge/webdriver
- */
-class LegacyActionSequence {
-  /**
-   * @param {!./webdriver.WebDriver} driver The driver that should be used to
-   *     perform this action sequence.
-   */
-  constructor(driver) {
-    /** @private {!./webdriver.WebDriver} */
-    this.driver_ = driver
-
-    /** @private {!Array<{description: string, command: !command.Command}>} */
-    this.actions_ = []
-  }
-
-  /**
-   * Schedules an action to be executed each time {@link #perform} is called on
-   * this instance.
-   *
-   * @param {string} description A description of the command.
-   * @param {!command.Command} command The command.
-   * @private
-   */
-  schedule_(description, command) {
-    this.actions_.push({
-      description: description,
-      command: command,
-    })
-  }
-
-  /**
-   * Executes this action sequence.
-   *
-   * @return {!Promise} A promise that will be resolved once this sequence has
-   *     completed.
-   */
-  async perform() {
-    // Make a protected copy of the scheduled actions. This will protect against
-    // users defining additional commands before this sequence is actually
-    // executed.
-    const actions = this.actions_.concat()
-    for (const action of actions) {
-      await this.driver_.execute(action.command)
-    }
-  }
-
-  /**
-   * Moves the mouse. The location to move to may be specified in terms of the
-   * mouse's current location, an offset relative to the top-left corner of an
-   * element, or an element (in which case the middle of the element is used).
-   *
-   * @param {(!./webdriver.WebElement|{x: number, y: number})} location The
-   *     location to drag to, as either another WebElement or an offset in
-   *     pixels.
-   * @param {{x: number, y: number}=} opt_offset If the target {@code location}
-   *     is defined as a {@link ./webdriver.WebElement}, this parameter defines
-   *     an offset within that element. The offset should be specified in pixels
-   *     relative to the top-left corner of the element's bounding box. If
-   *     omitted, the element's center will be used as the target offset.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  mouseMove(location, opt_offset) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_MOUSE_MOVE)
-
-    if (typeof location.x === 'number') {
-      setOffset(/** @type {{x: number, y: number}} */ (location))
-    } else {
-      cmd.setParameter('element', location.getId())
-      if (opt_offset) {
-        setOffset(opt_offset)
-      }
-    }
-
-    this.schedule_('mouseMove', cmd)
-    return this
-
-    /** @param {{x: number, y: number}} offset The offset to use. */
-    function setOffset(offset) {
-      cmd.setParameter('xoffset', offset.x || 0)
-      cmd.setParameter('yoffset', offset.y || 0)
-    }
-  }
-
-  /**
-   * Schedules a mouse action.
-   * @param {string} description A simple descriptive label for the scheduled
-   *     action.
-   * @param {!command.Name} commandName The name of the command.
-   * @param {(./webdriver.WebElement|input.Button)=} opt_elementOrButton Either
-   *     the element to interact with or the button to click with.
-   *     Defaults to {@link input.Button.LEFT} if neither an element nor
-   *     button is specified.
-   * @param {input.Button=} opt_button The button to use. Defaults to
-   *     {@link input.Button.LEFT}. Ignored if the previous argument is
-   *     provided as a button.
-   * @return {!LegacyActionSequence} A self reference.
-   * @private
-   */
-  scheduleMouseAction_(
-    description,
-    commandName,
-    opt_elementOrButton,
-    opt_button
-  ) {
-    let button
-    if (typeof opt_elementOrButton === 'number') {
-      button = opt_elementOrButton
-    } else {
-      if (opt_elementOrButton) {
-        this.mouseMove(
-          /** @type {!./webdriver.WebElement} */ (opt_elementOrButton)
-        )
-      }
-      button = opt_button !== void 0 ? opt_button : input.Button.LEFT
-    }
-
-    let cmd = new command.Command(commandName).setParameter('button', button)
-    this.schedule_(description, cmd)
-    return this
-  }
-
-  /**
-   * Presses a mouse button. The mouse button will not be released until
-   * {@link #mouseUp} is called, regardless of whether that call is made in this
-   * sequence or another. The behavior for out-of-order events (e.g. mouseDown,
-   * click) is undefined.
-   *
-   * If an element is provided, the mouse will first be moved to the center
-   * of that element. This is equivalent to:
-   *
-   *     sequence.mouseMove(element).mouseDown()
-   *
-   * Warning: this method currently only supports the left mouse button. See
-   * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
-   *
-   * @param {(./webdriver.WebElement|input.Button)=} opt_elementOrButton Either
-   *     the element to interact with or the button to click with.
-   *     Defaults to {@link input.Button.LEFT} if neither an element nor
-   *     button is specified.
-   * @param {input.Button=} opt_button The button to use. Defaults to
-   *     {@link input.Button.LEFT}. Ignored if a button is provided as the
-   *     first argument.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  mouseDown(opt_elementOrButton, opt_button) {
-    return this.scheduleMouseAction_(
-      'mouseDown',
-      command.Name.LEGACY_ACTION_MOUSE_DOWN,
-      opt_elementOrButton,
-      opt_button
-    )
-  }
-
-  /**
-   * Releases a mouse button. Behavior is undefined for calling this function
-   * without a previous call to {@link #mouseDown}.
-   *
-   * If an element is provided, the mouse will first be moved to the center
-   * of that element. This is equivalent to:
-   *
-   *     sequence.mouseMove(element).mouseUp()
-   *
-   * Warning: this method currently only supports the left mouse button. See
-   * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
-   *
-   * @param {(./webdriver.WebElement|input.Button)=} opt_elementOrButton Either
-   *     the element to interact with or the button to click with.
-   *     Defaults to {@link input.Button.LEFT} if neither an element nor
-   *     button is specified.
-   * @param {input.Button=} opt_button The button to use. Defaults to
-   *     {@link input.Button.LEFT}. Ignored if a button is provided as the
-   *     first argument.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  mouseUp(opt_elementOrButton, opt_button) {
-    return this.scheduleMouseAction_(
-      'mouseUp',
-      command.Name.LEGACY_ACTION_MOUSE_UP,
-      opt_elementOrButton,
-      opt_button
-    )
-  }
-
-  /**
-   * Convenience function for performing a "drag and drop" maneuver. The target
-   * element may be moved to the location of another element, or by an offset (in
-   * pixels).
-   *
-   * @param {!./webdriver.WebElement} element The element to drag.
-   * @param {(!./webdriver.WebElement|{x: number, y: number})} location The
-   *     location to drag to, either as another WebElement or an offset in
-   *     pixels.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  dragAndDrop(element, location) {
-    return this.mouseDown(element).mouseMove(location).mouseUp()
-  }
-
-  /**
-   * Clicks a mouse button.
-   *
-   * If an element is provided, the mouse will first be moved to the center
-   * of that element. This is equivalent to:
-   *
-   *     sequence.mouseMove(element).click()
-   *
-   * @param {(./webdriver.WebElement|input.Button)=} opt_elementOrButton Either
-   *     the element to interact with or the button to click with.
-   *     Defaults to {@link input.Button.LEFT} if neither an element nor
-   *     button is specified.
-   * @param {input.Button=} opt_button The button to use. Defaults to
-   *     {@link input.Button.LEFT}. Ignored if a button is provided as the
-   *     first argument.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  click(opt_elementOrButton, opt_button) {
-    return this.scheduleMouseAction_(
-      'click',
-      command.Name.LEGACY_ACTION_CLICK,
-      opt_elementOrButton,
-      opt_button
-    )
-  }
-
-  /**
-   * Double-clicks a mouse button.
-   *
-   * If an element is provided, the mouse will first be moved to the center of
-   * that element. This is equivalent to:
-   *
-   *     sequence.mouseMove(element).doubleClick()
-   *
-   * Warning: this method currently only supports the left mouse button. See
-   * [issue 4047](http://code.google.com/p/selenium/issues/detail?id=4047).
-   *
-   * @param {(./webdriver.WebElement|input.Button)=} opt_elementOrButton Either
-   *     the element to interact with or the button to click with.
-   *     Defaults to {@link input.Button.LEFT} if neither an element nor
-   *     button is specified.
-   * @param {input.Button=} opt_button The button to use. Defaults to
-   *     {@link input.Button.LEFT}. Ignored if a button is provided as the
-   *     first argument.
-   * @return {!LegacyActionSequence} A self reference.
-   */
-  doubleClick(opt_elementOrButton, opt_button) {
-    return this.scheduleMouseAction_(
-      'doubleClick',
-      command.Name.LEGACY_ACTION_DOUBLE_CLICK,
-      opt_elementOrButton,
-      opt_button
-    )
-  }
-
-  /**
-   * Schedules a keyboard action.
-   *
-   * @param {string} description A simple descriptive label for the scheduled
-   *     action.
-   * @param {!Array<(string|!input.Key)>} keys The keys to send.
-   * @return {!LegacyActionSequence} A self reference.
-   * @private
-   */
-  scheduleKeyboardAction_(description, keys) {
-    let cmd = new command.Command(
-      command.Name.LEGACY_ACTION_SEND_KEYS
-    ).setParameter('value', keys)
-    this.schedule_(description, cmd)
-    return this
-  }
-
-  /**
-   * Performs a modifier key press. The modifier key is <em>not released</em>
-   * until {@link #keyUp} or {@link #sendKeys} is called. The key press will be
-   * targeted at the currently focused element.
-   *
-   * @param {!input.Key} key The modifier key to push. Must be one of
-   *     {ALT, CONTROL, SHIFT, COMMAND, META}.
-   * @return {!LegacyActionSequence} A self reference.
-   * @throws {error.InvalidArgumentError} If the key is not a valid modifier
-   *     key.
-   */
-  keyDown(key) {
-    checkModifierKey(key)
-    return this.scheduleKeyboardAction_('keyDown', [key])
-  }
-
-  /**
-   * Performs a modifier key release. The release is targeted at the currently
-   * focused element.
-   * @param {!input.Key} key The modifier key to release. Must be one of
-   *     {ALT, CONTROL, SHIFT, COMMAND, META}.
-   * @return {!LegacyActionSequence} A self reference.
-   * @throws {error.InvalidArgumentError} If the key is not a valid modifier
-   *     key.
-   */
-  keyUp(key) {
-    checkModifierKey(key)
-    return this.scheduleKeyboardAction_('keyUp', [key])
-  }
-
-  /**
-   * Simulates typing multiple keys. Each modifier key encountered in the
-   * sequence will not be released until it is encountered again. All key events
-   * will be targeted at the currently focused element.
-   *
-   * @param {...(string|!input.Key|!Array<(string|!input.Key)>)} var_args
-   *     The keys to type.
-   * @return {!LegacyActionSequence} A self reference.
-   * @throws {Error} If the key is not a valid modifier key.
-   */
-  sendKeys(_var_args) {
-    // eslint-disable-line
-    const keys = flatten(arguments)
-    return this.scheduleKeyboardAction_('sendKeys', keys)
-  }
-}
-
-/**
- * Class for defining sequences of user touch interactions. Each sequence
- * will not be executed until {@link #perform} is called.
- *
- * This class should not be instantiated directly. Instead, obtain an instance
- * using {@link ./webdriver.WebDriver#touchActions() WebDriver.touchActions()}.
- *
- * Sample usage:
- *
- *     new LegacyActions(driver).
- *         tapAndHold({x: 0, y: 0}).
- *         move({x: 3, y: 4}).
- *         release({x: 10, y: 10}).
- *         perform();
- *
- * @deprecated This class is strongly deprecated and will be removed once
- *     [Google's Chrome][Chrome] and [Microsoft's Edge][Edge] browsers
- *     support the new action sequence API.
- *
- * [Chrome]: https://chromium.googlesource.com/chromium/src/+/master/docs/chromedriver_status.md
- * [Edge]: https://docs.microsoft.com/en-us/microsoft-edge/webdriver
- */
-class LegacyTouchSequence {
-  /**
-   * @param {!./webdriver.WebDriver} driver The driver that should be used to
-   *     perform this action sequence.
-   */
-  constructor(driver) {
-    /** @private {!./webdriver.WebDriver} */
-    this.driver_ = driver
-
-    /** @private {!Array<{description: string, command: !command.Command}>} */
-    this.actions_ = []
-  }
-
-  /**
-   * Schedules an action to be executed each time {@link #perform} is called on
-   * this instance.
-   * @param {string} description A description of the command.
-   * @param {!command.Command} command The command.
-   * @private
-   */
-  schedule_(description, command) {
-    this.actions_.push({
-      description: description,
-      command: command,
-    })
-  }
-
-  /**
-   * Executes this action sequence.
-   * @return {!Promise} A promise that will be resolved once this sequence has
-   *     completed.
-   */
-  async perform() {
-    // Make a protected copy of the scheduled actions. This will protect against
-    // users defining additional commands before this sequence is actually
-    // executed.
-    let actions = this.actions_.concat()
-    for (let action of actions) {
-      await this.driver_.execute(action.command)
-    }
-  }
-
-  /**
-   * Taps an element.
-   *
-   * @param {!./webdriver.WebElement} elem The element to tap.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  tap(elem) {
-    let cmd = new command.Command(
-      command.Name.LEGACY_ACTION_TOUCH_SINGLE_TAP
-    ).setParameter('element', elem.getId())
-
-    this.schedule_('tap', cmd)
-    return this
-  }
-
-  /**
-   * Double taps an element.
-   *
-   * @param {!./webdriver.WebElement} elem The element to double tap.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  doubleTap(elem) {
-    const cmd = new command.Command(
-      command.Name.LEGACY_ACTION_TOUCH_DOUBLE_TAP
-    ).setParameter('element', elem.getId())
-
-    this.schedule_('doubleTap', cmd)
-    return this
-  }
-
-  /**
-   * Long press on an element.
-   *
-   * @param {!./webdriver.WebElement} elem The element to long press.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  longPress(elem) {
-    const cmd = new command.Command(
-      command.Name.LEGACY_ACTION_TOUCH_LONG_PRESS
-    ).setParameter('element', elem.getId())
-
-    this.schedule_('longPress', cmd)
-    return this
-  }
-
-  /**
-   * Touch down at the given location.
-   *
-   * @param {{x: number, y: number}} location The location to touch down at.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  tapAndHold(location) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_DOWN)
-      .setParameter('x', location.x)
-      .setParameter('y', location.y)
-
-    this.schedule_('tapAndHold', cmd)
-    return this
-  }
-
-  /**
-   * Move a held {@linkplain #tapAndHold touch} to the specified location.
-   *
-   * @param {{x: number, y: number}} location The location to move to.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  move(location) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_MOVE)
-      .setParameter('x', location.x)
-      .setParameter('y', location.y)
-
-    this.schedule_('move', cmd)
-    return this
-  }
-
-  /**
-   * Release a held {@linkplain #tapAndHold touch} at the specified location.
-   *
-   * @param {{x: number, y: number}} location The location to release at.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  release(location) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_UP)
-      .setParameter('x', location.x)
-      .setParameter('y', location.y)
-
-    this.schedule_('release', cmd)
-    return this
-  }
-
-  /**
-   * Scrolls the touch screen by the given offset.
-   *
-   * @param {{x: number, y: number}} offset The offset to scroll to.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  scroll(offset) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
-      .setParameter('xoffset', offset.x)
-      .setParameter('yoffset', offset.y)
-
-    this.schedule_('scroll', cmd)
-    return this
-  }
-
-  /**
-   * Scrolls the touch screen, starting on `elem` and moving by the specified
-   * offset.
-   *
-   * @param {!./webdriver.WebElement} elem The element where scroll starts.
-   * @param {{x: number, y: number}} offset The offset to scroll to.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  scrollFromElement(elem, offset) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
-      .setParameter('element', elem.getId())
-      .setParameter('xoffset', offset.x)
-      .setParameter('yoffset', offset.y)
-
-    this.schedule_('scrollFromElement', cmd)
-    return this
-  }
-
-  /**
-   * Flick, starting anywhere on the screen, at speed xspeed and yspeed.
-   *
-   * @param {{xspeed: number, yspeed: number}} speed The speed to flick in each
-         direction, in pixels per second.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  flick(speed) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
-      .setParameter('xspeed', speed.xspeed)
-      .setParameter('yspeed', speed.yspeed)
-
-    this.schedule_('flick', cmd)
-    return this
-  }
-
-  /**
-   * Flick starting at elem and moving by x and y at specified speed.
-   *
-   * @param {!./webdriver.WebElement} elem The element where flick starts.
-   * @param {{x: number, y: number}} offset The offset to flick to.
-   * @param {number} speed The speed to flick at in pixels per second.
-   * @return {!LegacyTouchSequence} A self reference.
-   */
-  flickElement(elem, offset, speed) {
-    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
-      .setParameter('element', elem.getId())
-      .setParameter('xoffset', offset.x)
-      .setParameter('yoffset', offset.y)
-      .setParameter('speed', speed)
-
-    this.schedule_('flickElement', cmd)
-    return this
-  }
-}
-
-// PUBLIC API
-
-module.exports = {
-  LegacyActionSequence,
-  LegacyTouchSequence,
-}