selenium-webdriver 4.0.0-alpha.5 → 4.0.0-beta.1

package/lib/promise.js

@@ -20,9 +20,7 @@
  * with promises.
  */
 
-'use strict';
-
-
+'use strict'
 
 /**
  * Determines whether a {@code value} should be treated as a promise.
@@ -35,15 +33,16 @@ 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';
+    return (
+      value &&
+      (typeof value === 'object' || typeof value === 'function') &&
+      typeof value['then'] === 'function'
+    )
   } catch (ex) {
-    return false;
+    return false
   }
 }
 
-
 /**
  * Creates a promise that will be resolved at a set time in the future.
  * @param {number} ms The amount of time, in milliseconds, to wait before
@@ -51,12 +50,11 @@ 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)
+  })
 }
 
-
 /**
  * Wraps a function that expects a node-style callback as its final
  * argument. This callback expects two arguments: an error value (which will be
@@ -70,15 +68,15 @@ function delayed(ms) {
  *     result of the provided function's callback.
  */
 function checkedNodeCall(fn, ...args) {
-  return new Promise(function(fulfill, reject) {
+  return new Promise(function (fulfill, reject) {
     try {
-      fn(...args, function(error, value) {
-        error ? reject(error) : fulfill(value);
-      });
+      fn(...args, function (error, value) {
+        error ? reject(error) : fulfill(value)
+      })
     } catch (ex) {
-      reject(ex);
+      reject(ex)
     }
-  });
+  })
 }
 
 /**
@@ -120,15 +118,14 @@ function checkedNodeCall(fn, ...args) {
  */
 async function thenFinally(promise, callback) {
   try {
-    await Promise.resolve(promise);
-    return callback();
+    await Promise.resolve(promise)
+    return callback()
   } catch (e) {
-    await callback();
-    throw e;
+    await callback()
+    throw e
   }
 }
 
-
 /**
  * Calls a function for each element in an array and inserts the result into a
  * new array, which is used as the fulfillment value of the promise returned
@@ -151,24 +148,23 @@ async function thenFinally(promise, callback) {
  * @template TYPE, SELF
  */
 async function map(array, fn, self = undefined) {
-  const v = await Promise.resolve(array);
+  const v = await Promise.resolve(array)
   if (!Array.isArray(v)) {
-    throw TypeError('not an array');
+    throw TypeError('not an array')
   }
 
-  const arr = /** @type {!Array} */(v);
-  const n = arr.length;
-  const values = new Array(n);
+  const arr = /** @type {!Array} */ (v)
+  const n = arr.length
+  const values = new Array(n)
 
   for (let i = 0; i < n; i++) {
     if (i in arr) {
-      values[i] = await Promise.resolve(fn.call(self, arr[i], i, arr));
+      values[i] = await Promise.resolve(fn.call(self, arr[i], i, arr))
     }
   }
-  return values;
+  return values
 }
 
-
 /**
  * Calls a function for each element in an array, and if the function returns
  * true adds the element to a new array.
@@ -191,29 +187,28 @@ async function map(array, fn, self = undefined) {
  * @template TYPE, SELF
  */
 async function filter(array, fn, self = undefined) {
-  const v = await Promise.resolve(array);
+  const v = await Promise.resolve(array)
   if (!Array.isArray(v)) {
-    throw TypeError('not an array');
+    throw TypeError('not an array')
   }
 
-  const arr = /** @type {!Array} */(v);
-  const n = arr.length;
-  const values = [];
-  let valuesLength = 0;
+  const arr = /** @type {!Array} */ (v)
+  const n = arr.length
+  const values = []
+  let valuesLength = 0
 
   for (let i = 0; i < n; i++) {
     if (i in arr) {
-      let value = arr[i];
-      let include = await fn.call(self, value, i, arr);
+      let value = arr[i]
+      let include = await fn.call(self, value, i, arr)
       if (include) {
-        values[valuesLength++] = value;
+        values[valuesLength++] = value
       }
     }
   }
-  return values;
+  return values
 }
 
-
 /**
  * Returns a promise that will be resolved with the input value in a
  * fully-resolved state. If the value is an array, each element will be fully
@@ -234,64 +229,63 @@ async function filter(array, fn, self = undefined) {
  *     of the input value.
  */
 async function fullyResolved(value) {
-  value = await Promise.resolve(value);
+  value = await Promise.resolve(value)
   if (Array.isArray(value)) {
-    return fullyResolveKeys(/** @type {!Array} */ (value));
+    return fullyResolveKeys(/** @type {!Array} */ (value))
   }
 
   if (value && typeof value === 'object') {
-    return fullyResolveKeys(/** @type {!Object} */ (value));
+    return fullyResolveKeys(/** @type {!Object} */ (value))
   }
 
   if (typeof value === 'function') {
-    return fullyResolveKeys(/** @type {!Object} */ (value));
+    return fullyResolveKeys(/** @type {!Object} */ (value))
   }
 
-  return value;
+  return value
 }
 
-
 /**
  * @param {!(Array|Object)} obj the object to resolve.
  * @return {!Thenable} A promise that will be resolved with the
  *     input object once all of its values have been fully resolved.
  */
 async function fullyResolveKeys(obj) {
-  const isArray = Array.isArray(obj);
-  const numKeys = isArray ? obj.length : Object.keys(obj).length;
+  const isArray = Array.isArray(obj)
+  const numKeys = isArray ? obj.length : Object.keys(obj).length
 
   if (!numKeys) {
-    return obj;
+    return obj
   }
 
   async function forEachProperty(obj, fn) {
     for (let key in obj) {
-      await fn(obj[key], key);
+      await fn(obj[key], key)
     }
   }
 
   async function forEachElement(arr, fn) {
     for (let i = 0; i < arr.length; i++) {
-      await fn(arr[i], i);
+      await fn(arr[i], i)
     }
   }
 
-  const forEachKey = isArray ? forEachElement : forEachProperty;
-  await forEachKey(obj, async function(partialValue, key) {
-    if (!Array.isArray(partialValue)
-        && (!partialValue || typeof partialValue !== 'object')) {
-      return;
+  const forEachKey = isArray ? forEachElement : forEachProperty
+  await forEachKey(obj, async function (partialValue, key) {
+    if (
+      !Array.isArray(partialValue) &&
+      (!partialValue || typeof partialValue !== 'object')
+    ) {
+      return
     }
-    let resolvedValue = await fullyResolved(partialValue);
-    obj[key] = resolvedValue;
-  });
-  return obj;
+    let resolvedValue = await fullyResolved(partialValue)
+    obj[key] = resolvedValue
+  })
+  return obj
 }
 
-
 // PUBLIC API
 
-
 module.exports = {
   checkedNodeCall,
   delayed,
@@ -299,5 +293,5 @@ module.exports = {
   finally: thenFinally,
   fullyResolved,
   isPromise,
-  map
-};
+  map,
+}

package/lib/proxy.js

@@ -25,7 +25,7 @@
  *     capabilities.setProxy(proxy.manual({http: 'host:1234'});
  */
 
-'use strict';
+'use strict'
 
 /**
  * Supported {@linkplain Config proxy configuration} types.
@@ -38,8 +38,7 @@ const Type = {
   MANUAL: 'manual',
   PAC: 'pac',
   SYSTEM: 'system',
-};
-
+}
 
 /**
  * Describes how a proxy should be configured for a WebDriver session.
@@ -51,8 +50,7 @@ function Config() {}
  * The proxy type.
  * @type {Type}
  */
-Config.prototype.proxyType;
-
+Config.prototype.proxyType
 
 /**
  * Describes how to configure a PAC proxy.
@@ -66,8 +64,7 @@ function PacConfig() {}
  *
  * @type {string}
  */
-PacConfig.prototype.proxyAutoconfigUrl;
-
+PacConfig.prototype.proxyAutoconfigUrl
 
 /**
  * Record object that defines a manual proxy configuration. Manual
@@ -85,61 +82,57 @@ function ManualConfig() {}
  *
  * @type {(string|undefined)}
  */
-ManualConfig.prototype.ftpProxy;
+ManualConfig.prototype.ftpProxy
 
 /**
  * The proxy host for HTTP requests.
  *
  * @type {(string|undefined)}
  */
-ManualConfig.prototype.httpProxy;
+ManualConfig.prototype.httpProxy
 
 /**
  * An array of hosts which should bypass all proxies.
  *
  * @type {(Array<string>|undefined)}
  */
-ManualConfig.prototype.noProxy;
+ManualConfig.prototype.noProxy
 
 /**
  * The proxy host for HTTPS requests.
  *
  * @type {(string|undefined)}
  */
-ManualConfig.prototype.sslProxy;
+ManualConfig.prototype.sslProxy
 
 /**
  * Defines the host and port for the SOCKS proxy to use.
  *
  * @type {(number|undefined)}
  */
-ManualConfig.prototype.socksProxy;
+ManualConfig.prototype.socksProxy
 
 /**
  * Defines the SOCKS proxy version. Must be a number in the range [0, 255].
  *
  * @type {(number|undefined)}
  */
-ManualConfig.prototype.socksVersion;
-
+ManualConfig.prototype.socksVersion
 
 // PUBLIC API
 
-
-/** @const */ exports.Config = Config;
-/** @const */ exports.ManualConfig = ManualConfig;
-/** @const */ exports.PacConfig = PacConfig;
-/** @const */ exports.Type = Type;
-
+/** @const */ exports.Config = Config
+/** @const */ exports.ManualConfig = ManualConfig
+/** @const */ exports.PacConfig = PacConfig
+/** @const */ exports.Type = Type
 
 /**
  * Configures WebDriver to bypass all browser proxies.
  * @return {!Config} A new proxy configuration object.
  */
-exports.direct = function() {
-  return {proxyType: Type.DIRECT};
-};
-
+exports.direct = function () {
+  return { proxyType: Type.DIRECT }
+}
 
 /**
  * Manually configures the browser proxy.  The following options are
@@ -162,16 +155,15 @@ exports.direct = function() {
  *     configuration options.
  * @return {!ManualConfig} A new proxy configuration object.
  */
-exports.manual = function({ftp, http, https, bypass}) {
+exports.manual = function ({ ftp, http, https, bypass }) {
   return {
     proxyType: Type.MANUAL,
     ftpProxy: ftp,
     httpProxy: http,
     sslProxy: https,
     noProxy: bypass,
-  };
-};
-
+  }
+}
 
 /**
  * Creates a proxy configuration for a socks proxy.
@@ -193,14 +185,13 @@ exports.manual = function({ftp, http, https, bypass}) {
  * @return {!ManualConfig} A new proxy configuration object.
  * @see https://en.wikipedia.org/wiki/SOCKS
  */
-exports.socks = function(socksProxy, socksVersion = undefined) {
-  return /** @type {!Config} */({
+exports.socks = function (socksProxy, socksVersion = undefined) {
+  return /** @type {!Config} */ ({
     proxyType: Type.MANUAL,
     socksProxy,
-    socksVersion
-  });
-};
-
+    socksVersion,
+  })
+}
 
 /**
  * Configures WebDriver to configure the browser proxy using the PAC file at
@@ -208,15 +199,14 @@ exports.socks = function(socksProxy, socksVersion = undefined) {
  * @param {string} proxyAutoconfigUrl URL for the PAC proxy to use.
  * @return {!PacConfig} A new proxy configuration object.
  */
-exports.pac = function(proxyAutoconfigUrl) {
-  return {proxyType: Type.PAC, proxyAutoconfigUrl};
-};
-
+exports.pac = function (proxyAutoconfigUrl) {
+  return { proxyType: Type.PAC, proxyAutoconfigUrl }
+}
 
 /**
  * Configures WebDriver to use the current system's proxy.
  * @return {!Config} A new proxy configuration object.
  */
-exports.system = function() {
-  return {proxyType: Type.SYSTEM};
-};
+exports.system = function () {
+  return { proxyType: Type.SYSTEM }
+}

package/lib/session.js

@@ -15,16 +15,14 @@
 // specific language governing permissions and limitations
 // under the License.
 
-'use strict';
-
-const {Capabilities} = require('./capabilities');
+'use strict'
 
+const { Capabilities } = require('./capabilities')
 
 /**
  * Contains information about a single WebDriver session.
  */
 class Session {
-
   /**
    * @param {string} id The session ID.
    * @param {!./capabilities.Capabilities} capabilities
@@ -32,26 +30,27 @@ class Session {
    */
   constructor(id, capabilities) {
     /** @private {string} */
-    this.id_ = id;
+    this.id_ = id
 
     /** @private {!Capabilities} */
-    this.caps_ = capabilities instanceof Capabilities
-        ? /** @type {!Capabilities} */(capabilities)
-        : new Capabilities(capabilities);
+    this.caps_ =
+      capabilities instanceof Capabilities
+        ? /** @type {!Capabilities} */ (capabilities)
+        : new Capabilities(capabilities)
   }
 
   /**
    * @return {string} This session's ID.
    */
   getId() {
-    return this.id_;
+    return this.id_
   }
 
   /**
    * @return {!Capabilities} This session's capabilities.
    */
   getCapabilities() {
-    return this.caps_;
+    return this.caps_
   }
 
   /**
@@ -60,7 +59,7 @@ class Session {
    * @return {*} The capability value.
    */
   getCapability(key) {
-    return this.caps_.get(key);
+    return this.caps_.get(key)
   }
 
   /**
@@ -69,12 +68,10 @@ class Session {
    * @return {string} The JSON representation of this Session.
    */
   toJSON() {
-    return this.getId();
+    return this.getId()
   }
 }
 
-
 // PUBLIC API
 
-
-module.exports = {Session: Session};
+module.exports = { Session: Session }

package/lib/symbols.js

@@ -15,14 +15,13 @@
 // specific language governing permissions and limitations
 // under the License.
 
-'use strict';
+'use strict'
 
 /**
  * @fileoverview Defines well-known symbols used within the selenium-webdriver
  * library.
  */
 
-
 module.exports = {
   /**
    * The serialize symbol specifies a method that returns an object's serialized
@@ -34,5 +33,5 @@ module.exports = {
    * `toJSON()` method, except the serialized result may be a promise, or
    * another object with a promised property.
    */
-  serialize: Symbol('serialize')
-};
+  serialize: Symbol('serialize'),
+}