selenium-webdriver 4.0.0-alpha.7 → 4.0.0-beta.3

package/lib/capabilities.js

@@ -15,16 +15,14 @@
 // specific language governing permissions and limitations
 // under the License.
 
-'use strict';
+'use strict'
 
 /**
  * @fileoverview Defines types related to describing the capabilities of a
  * WebDriver session.
  */
 
-const proxy = require('./proxy');
-const Symbols = require('./symbols');
-
+const Symbols = require('./symbols')
 
 /**
  * Recognized browser names.
@@ -34,11 +32,10 @@ const Browser = {
   CHROME: 'chrome',
   EDGE: 'MicrosoftEdge',
   FIREFOX: 'firefox',
-  IE: 'internet explorer',
   INTERNET_EXPLORER: 'internet explorer',
   SAFARI: 'safari',
-};
-
+  OPERA: 'opera',
+}
 
 /**
  * Strategies for waiting for [document readiness] after a navigation
@@ -65,9 +62,8 @@ const PageLoadStrategy = {
    * Indicates WebDriver should wait for the document readiness state to
    * be "complete" after navigation. This is the default page loading strategy.
    */
-  NORMAL: 'normal'
-};
-
+  NORMAL: 'normal',
+}
 
 /**
  * Common platform names. These platforms are not explicitly defined by the
@@ -79,30 +75,29 @@ const PageLoadStrategy = {
 const Platform = {
   LINUX: 'linux',
   MAC: 'mac',
-  WINDOWS: 'windows'
-};
-
+  WINDOWS: 'windows',
+}
 
 /**
  * Record object defining the timeouts that apply to certain WebDriver actions.
  *
  * @record
  */
-function Timeouts() {}
+function Timeouts() { }
 
 /**
  * Defines when, in milliseconds, to interrupt a script that is being
  * {@linkplain ./webdriver.IWebDriver#executeScript evaluated}.
  * @type {number}
  */
-Timeouts.prototype.script;
+Timeouts.prototype.script
 
 /**
  * The timeout, in milliseconds, to apply to navigation events along with the
  * {@link PageLoadStrategy}.
  * @type {number}
  */
-Timeouts.prototype.pageLoad;
+Timeouts.prototype.pageLoad
 
 /**
  * The maximum amount of time, in milliseconds, to spend attempting to
@@ -110,8 +105,7 @@ Timeouts.prototype.pageLoad;
  * current page.
  * @type {number}
  */
-Timeouts.prototype.implicit;
-
+Timeouts.prototype.implicit
 
 /**
  * The possible default actions a WebDriver session can take to respond to
@@ -136,9 +130,8 @@ const UserPromptHandler = {
    */
   DISMISS_AND_NOTIFY: 'dismiss and notify',
   /** All prompts should be left unhandled. */
-  IGNORE: 'ignore'
-};
-
+  IGNORE: 'ignore',
+}
 
 /**
  * The standard WebDriver capability keys.
@@ -147,7 +140,6 @@ const UserPromptHandler = {
  * @see <https://w3c.github.io/webdriver/webdriver-spec.html#capabilities>
  */
 const Capability = {
-
   /**
    * Indicates whether a WebDriver session implicitly trusts otherwise untrusted
    * and self-signed TLS certificates during navigation.
@@ -213,13 +205,12 @@ const Capability = {
    */
   UNHANDLED_PROMPT_BEHAVIOR: 'unhandledPromptBehavior',
 
-   /**
-    * Defines the current session’s strict file interactability.
-    * Used to upload a file when strict file interactability is on
-    */
-   STRICT_FILE_INTERACTABILITY: 'strictFileInteractability',
-};
-
+  /**
+   * Defines the current session’s strict file interactability.
+   * Used to upload a file when strict file interactability is on
+   */
+  STRICT_FILE_INTERACTABILITY: 'strictFileInteractability',
+}
 
 /**
  * Converts a generic hash object to a map.
@@ -227,16 +218,15 @@ const Capability = {
  * @return {!Map<string, ?>} The converted map.
  */
 function toMap(hash) {
-  let m = new Map;
+  let m = new Map()
   for (let key in hash) {
-    if (hash.hasOwnProperty(key)) {
-      m.set(key, hash[key]);
+    if (Object.prototype.hasOwnProperty.call(hash, key)) {
+      m.set(key, hash[key])
     }
   }
-  return m;
+  return m
 }
 
-
 /**
  * Describes a set of capabilities for a WebDriver session.
  */
@@ -247,47 +237,47 @@ class Capabilities {
    */
   constructor(other = undefined) {
     if (other instanceof Capabilities) {
-      other = other.map_;
+      other = other.map_
     } else if (other && !(other instanceof Map)) {
-      other = toMap(other);
+      other = toMap(other)
     }
     /** @private @const {!Map<string, ?>} */
-    this.map_ = new Map(other);
+    this.map_ = new Map(other)
   }
 
   /**
    * @return {!Capabilities} A basic set of capabilities for Chrome.
    */
   static chrome() {
-    return new Capabilities().setBrowserName(Browser.CHROME);
+    return new Capabilities().setBrowserName(Browser.CHROME)
   }
 
   /**
    * @return {!Capabilities} A basic set of capabilities for Microsoft Edge.
    */
   static edge() {
-    return new Capabilities().setBrowserName(Browser.EDGE);
+    return new Capabilities().setBrowserName(Browser.EDGE)
   }
 
   /**
    * @return {!Capabilities} A basic set of capabilities for Firefox.
    */
   static firefox() {
-    return new Capabilities().setBrowserName(Browser.FIREFOX);
+    return new Capabilities().setBrowserName(Browser.FIREFOX).set("moz:debuggerAddress", true)
   }
 
   /**
    * @return {!Capabilities} A basic set of capabilities for Internet Explorer.
    */
   static ie() {
-    return new Capabilities().setBrowserName(Browser.INTERNET_EXPLORER);
+    return new Capabilities().setBrowserName(Browser.INTERNET_EXPLORER)
   }
 
   /**
    * @return {!Capabilities} A basic set of capabilities for Safari.
    */
   static safari() {
-    return new Capabilities().setBrowserName(Browser.SAFARI);
+    return new Capabilities().setBrowserName(Browser.SAFARI)
   }
 
   /**
@@ -297,7 +287,7 @@ class Capabilities {
    *     Map).
    */
   [Symbols.serialize]() {
-    return serialize(this);
+    return serialize(this)
   }
 
   /**
@@ -306,7 +296,7 @@ class Capabilities {
    * @template T
    */
   get(key) {
-    return this.map_.get(key);
+    return this.map_.get(key)
   }
 
   /**
@@ -314,19 +304,19 @@ class Capabilities {
    * @return {boolean} whether this capability set has the specified key.
    */
   has(key) {
-    return this.map_.has(key);
+    return this.map_.has(key)
   }
 
   /**
    * @return {!Iterator<string>} an iterator of the keys set.
    */
   keys() {
-    return this.map_.keys();
+    return this.map_.keys()
   }
 
   /** @return {number} The number of capabilities set. */
   get size() {
-    return this.map_.size;
+    return this.map_.size
   }
 
   /**
@@ -337,20 +327,20 @@ class Capabilities {
    */
   merge(other) {
     if (other) {
-      let otherMap;
+      let otherMap
       if (other instanceof Capabilities) {
-        otherMap = other.map_;
+        otherMap = other.map_
       } else if (other instanceof Map) {
-        otherMap = other;
+        otherMap = other
       } else {
-        otherMap = toMap(other);
+        otherMap = toMap(other)
       }
       otherMap.forEach((value, key) => {
-        this.set(key, value);
-      });
-      return this;
+        this.set(key, value)
+      })
+      return this
     } else {
-      throw new TypeError('no capabilities provided for merge');
+      throw new TypeError('no capabilities provided for merge')
     }
   }
 
@@ -360,7 +350,7 @@ class Capabilities {
    * @param {string} key the capability key to delete.
    */
   delete(key) {
-    this.map_.delete(key);
+    this.map_.delete(key)
   }
 
   /**
@@ -371,10 +361,10 @@ class Capabilities {
    */
   set(key, value) {
     if (typeof key !== 'string') {
-      throw new TypeError('Capability keys must be strings: ' + typeof key);
+      throw new TypeError('Capability keys must be strings: ' + typeof key)
     }
-    this.map_.set(key, value);
-    return this;
+    this.map_.set(key, value)
+    return this
   }
 
   /**
@@ -385,7 +375,7 @@ class Capabilities {
    * @return {!Capabilities} a self reference.
    */
   setAcceptInsecureCerts(accept) {
-    return this.set(Capability.ACCEPT_INSECURE_TLS_CERTS, accept);
+    return this.set(Capability.ACCEPT_INSECURE_TLS_CERTS, accept)
   }
 
   /**
@@ -393,7 +383,7 @@ class Capabilities {
    *     TLS certificates.
    */
   getAcceptInsecureCerts() {
-    return this.get(Capability.ACCEPT_INSECURE_TLS_CERTS);
+    return this.get(Capability.ACCEPT_INSECURE_TLS_CERTS)
   }
 
   /**
@@ -403,7 +393,7 @@ class Capabilities {
    * @return {!Capabilities} a self reference.
    */
   setBrowserName(name) {
-    return this.set(Capability.BROWSER_NAME, name);
+    return this.set(Capability.BROWSER_NAME, name)
   }
 
   /**
@@ -411,7 +401,7 @@ class Capabilities {
    *     not set.
    */
   getBrowserName() {
-    return this.get(Capability.BROWSER_NAME);
+    return this.get(Capability.BROWSER_NAME)
   }
 
   /**
@@ -421,7 +411,7 @@ class Capabilities {
    * @return {!Capabilities} a self reference.
    */
   setBrowserVersion(version) {
-    return this.set(Capability.BROWSER_VERSION, version);
+    return this.set(Capability.BROWSER_VERSION, version)
   }
 
   /**
@@ -429,7 +419,7 @@ class Capabilities {
    *     if not set.
    */
   getBrowserVersion() {
-    return this.get(Capability.BROWSER_VERSION);
+    return this.get(Capability.BROWSER_VERSION)
   }
 
   /**
@@ -439,7 +429,7 @@ class Capabilities {
    * @return {!Capabilities} a self reference.
    */
   setPageLoadStrategy(strategy) {
-    return this.set(Capability.PAGE_LOAD_STRATEGY, strategy);
+    return this.set(Capability.PAGE_LOAD_STRATEGY, strategy)
   }
 
   /**
@@ -448,7 +438,7 @@ class Capabilities {
    * @return {(string|undefined)} the page load strategy.
    */
   getPageLoadStrategy() {
-    return this.get(Capability.PAGE_LOAD_STRATEGY);
+    return this.get(Capability.PAGE_LOAD_STRATEGY)
   }
 
   /**
@@ -458,7 +448,7 @@ class Capabilities {
    * @return {!Capabilities} a self reference.
    */
   setPlatform(platform) {
-    return this.set(Capability.PLATFORM_NAME, platform);
+    return this.set(Capability.PLATFORM_NAME, platform)
   }
 
   /**
@@ -466,7 +456,7 @@ class Capabilities {
    *     set.
    */
   getPlatform() {
-    return this.get(Capability.PLATFORM_NAME);
+    return this.get(Capability.PLATFORM_NAME)
   }
 
   /**
@@ -478,7 +468,7 @@ class Capabilities {
    * @return {!Capabilities} A self reference.
    */
   setLoggingPrefs(prefs) {
-    return this.set(Capability.LOGGING_PREFS, prefs);
+    return this.set(Capability.LOGGING_PREFS, prefs)
   }
 
   /**
@@ -487,7 +477,7 @@ class Capabilities {
    * @return {!Capabilities} A self reference.
    */
   setProxy(proxy) {
-    return this.set(Capability.PROXY, proxy);
+    return this.set(Capability.PROXY, proxy)
   }
 
   /**
@@ -495,7 +485,7 @@ class Capabilities {
    *     undefined if not set.
    */
   getProxy() {
-    return this.get(Capability.PROXY);
+    return this.get(Capability.PROXY)
   }
 
   /**
@@ -508,7 +498,7 @@ class Capabilities {
    * @return {!Capabilities} A self reference.
    */
   setAlertBehavior(behavior) {
-    return this.set(Capability.UNHANDLED_PROMPT_BEHAVIOR, behavior);
+    return this.set(Capability.UNHANDLED_PROMPT_BEHAVIOR, behavior)
   }
 
   /**
@@ -516,18 +506,20 @@ class Capabilities {
    *     to unhandled user prompts, or undefined if not set.
    */
   getAlertBehavior() {
-    return this.get(Capability.UNHANDLED_PROMPT_BEHAVIOR);
+    return this.get(Capability.UNHANDLED_PROMPT_BEHAVIOR)
   }
 
-   /**
-    * Sets the boolean flag configuration for this instance.
-    */
+  /**
+   * Sets the boolean flag configuration for this instance.
+   */
   setStrictFileInteractability(strictFileInteractability) {
-    return this.set(Capability.STRICT_FILE_INTERACTABILITY, strictFileInteractability);
+    return this.set(
+      Capability.STRICT_FILE_INTERACTABILITY,
+      strictFileInteractability
+    )
   }
 }
 
-
 /**
  * Serializes a capabilities object. This is defined as a standalone function
  * so it may be type checked (where Capabilities[Symbols.serialize] has type
@@ -538,20 +530,18 @@ class Capabilities {
  *     Note, the returned object may contain nested promised values.
  */
 function serialize(caps) {
-  let ret = {};
+  let ret = {}
   for (let key of caps.keys()) {
-    let cap = caps.get(key);
+    let cap = caps.get(key)
     if (cap !== undefined && cap !== null) {
-      ret[key] = cap;
+      ret[key] = cap
     }
   }
-  return ret;
+  return ret
 }
 
-
 // PUBLIC API
 
-
 module.exports = {
   Browser,
   Capabilities,
@@ -560,4 +550,4 @@ module.exports = {
   Platform,
   Timeouts,
   UserPromptHandler,
-};
+}

package/lib/command.js

@@ -19,7 +19,7 @@
  * @fileoverview Contains several classes for handling commands.
  */
 
-'use strict';
+'use strict'
 
 /**
  * Describes a command to execute.
@@ -29,15 +29,15 @@ class Command {
   /** @param {string} name The name of this command. */
   constructor(name) {
     /** @private {string} */
-    this.name_ = name;
+    this.name_ = name
 
     /** @private {!Object<*>} */
-    this.parameters_ = {};
+    this.parameters_ = {}
   }
 
   /** @return {string} This command's name. */
   getName() {
-    return this.name_;
+    return this.name_
   }
 
   /**
@@ -47,8 +47,8 @@ class Command {
    * @return {!Command} A self reference.
    */
   setParameter(name, value) {
-    this.parameters_[name] = value;
-    return this;
+    this.parameters_[name] = value
+    return this
   }
 
   /**
@@ -57,8 +57,8 @@ class Command {
    * @return {!Command} A self reference.
    */
   setParameters(parameters) {
-    this.parameters_ = parameters;
-    return this;
+    this.parameters_ = parameters
+    return this
   }
 
   /**
@@ -67,18 +67,17 @@ class Command {
    * @return {*} The parameter value, or undefined if it has not been set.
    */
   getParameter(key) {
-    return this.parameters_[key];
+    return this.parameters_[key]
   }
 
   /**
    * @return {!Object<*>} The parameters to send with this command.
    */
   getParameters() {
-    return this.parameters_;
+    return this.parameters_
   }
 }
 
-
 /**
  * Enumeration of predefined names command names that all command processors
  * will support.
@@ -109,6 +108,7 @@ const Name = {
   GET_ACTIVE_ELEMENT: 'getActiveElement',
   FIND_ELEMENT: 'findElement',
   FIND_ELEMENTS: 'findElements',
+  FIND_ELEMENTS_RELATIVE: 'findElementsRelative',
   FIND_CHILD_ELEMENT: 'findChildElement',
   FIND_CHILD_ELEMENTS: 'findChildElements',
 
@@ -140,6 +140,8 @@ const Name = {
   EXECUTE_ASYNC_SCRIPT: 'executeAsyncScript',
 
   GET_ELEMENT_TEXT: 'getElementText',
+  GET_COMPUTED_ROLE: 'getAriaRole',
+  GET_COMPUTED_LABEL: 'getAccessibleName',
   GET_ELEMENT_TAG_NAME: 'getElementTagName',
   IS_ELEMENT_SELECTED: 'isElementSelected',
   IS_ELEMENT_ENABLED: 'isElementEnabled',
@@ -156,6 +158,8 @@ const Name = {
   TAKE_ELEMENT_SCREENSHOT: 'takeElementScreenshot',
   SET_SCRIPT_TIMEOUT: 'setScriptTimeout',
 
+  PRINT_PAGE: 'printPage',
+
   GET_TIMEOUT: 'getTimeout',
   SET_TIMEOUT: 'setTimeout',
 
@@ -173,24 +177,7 @@ 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',
-};
-
-
+}
 
 /**
  * Handles the execution of WebDriver {@link Command commands}.
@@ -207,16 +194,13 @@ class Executor {
    * @return {!Promise<?>} A promise that will be fulfilled with the command
    *     result.
    */
-  execute(command) {}
+  execute(command) {} // eslint-disable-line
 }
 
-
-
 // PUBLIC API
 
-
 module.exports = {
   Command: Command,
   Name: Name,
-  Executor: Executor
-};
+  Executor: Executor,
+}