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

package/edge.js

@@ -17,26 +17,37 @@
 
 /**
  * @fileoverview Defines a {@linkplain Driver WebDriver} client for
- * Microsoft's Edge web browser. Before using this module,
- * you must download and install the latest
- * [MicrosoftEdgeDriver](http://go.microsoft.com/fwlink/?LinkId=619687) server.
- * Ensure that the MicrosoftEdgeDriver is on your
- * [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29).
+ * Microsoft's Edge web browser. Both Edge (Chromium), and Edge Legacy (EdgeHTML) are
+ * supported. Before using this module, you must download and install the correct
+ * [WebDriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/)
+ * server.
+ *
+ * Ensure that the either MicrosoftWebDriver (EdgeHTML) or msedgedriver (Chromium)
+ * is on your [PATH](http://en.wikipedia.org/wiki/PATH_%28variable%29). MicrosoftWebDriver
+ * and Edge Legacy (EdgeHTML) will be used by default.
+ *
+ * You may use {@link Options} to specify whether Edge Chromium should be used:
+
+ *     var options = new edge.Options();
+ *     options.useEdgeChromium(true);
+ *     // configure browser options ...
+
+ * Note that Chromium-specific {@link Options} will be ignored when using Edge Legacy.
  *
  * There are three primary classes exported by this module:
  *
  * 1. {@linkplain ServiceBuilder}: configures the
  *     {@link ./remote.DriverService remote.DriverService}
- *     that manages the [MicrosoftEdgeDriver] child process.
+ *     that manages the [WebDriver] child process.
  *
  * 2. {@linkplain Options}: defines configuration options for each new
- *     MicrosoftEdgeDriver session, such as which
+ *     WebDriver session, such as which
  *     {@linkplain Options#setProxy proxy} to use when starting the browser.
  *
  * 3. {@linkplain Driver}: the WebDriver client; each new instance will control
  *     a unique browser session.
  *
- * __Customizing the MicrosoftEdgeDriver Server__ <a id="custom-server"></a>
+ * __Customizing the WebDriver Server__ <a id="custom-server"></a>
  *
  * By default, every MicrosoftEdge session will use a single driver service,
  * which is started the first time a {@link Driver} instance is created and
@@ -65,89 +76,110 @@
  * operation, users should start MicrosoftEdge using the
  * {@link ./builder.Builder selenium-webdriver.Builder}.
  *
- * [MicrosoftEdgeDriver]: https://msdn.microsoft.com/en-us/library/mt188085(v=vs.85).aspx
+ * [WebDriver (EdgeHTML)]: https://docs.microsoft.com/en-us/microsoft-edge/webdriver
+ * [WebDriver (Chromium)]: https://docs.microsoft.com/en-us/microsoft-edge/webdriver-chromium
  */
 
 'use strict';
 
-const fs = require('fs');
-const util = require('util');
-
 const http = require('./http');
 const io = require('./io');
-const portprober = require('./net/portprober');
-const promise = require('./lib/promise');
 const remote = require('./remote');
-const Symbols = require('./lib/symbols');
 const webdriver = require('./lib/webdriver');
 const {Browser, Capabilities} = require('./lib/capabilities');
+const chromium = require('./chromium');
 
-const EDGEDRIVER_EXE = 'MicrosoftWebDriver.exe';
-
+const EDGE_CHROMIUM_BROWSER_NAME = "msedge";
+const EDGEDRIVER_LEGACY_EXE = 'MicrosoftWebDriver.exe';
+const EDGEDRIVER_CHROMIUM_EXE =
+    process.platform === 'win32' ? 'msedgedriver.exe' : 'msedgedriver';
 
 /**
- * _Synchronously_ attempts to locate the edge driver executable on the current
- * system.
+ * _Synchronously_ attempts to locate the Edge driver executable
+ * on the current system. Searches for the legacy MicrosoftWebDriver by default.
  *
+ * @param {string=} browserName Name of the Edge driver executable to locate.
+ *   May be either 'msedge' to locate the Edge Chromium driver, or 'MicrosoftEdge' to
+ *   locate the Edge Legacy driver. If omitted, will attempt to locate Edge Legacy.
  * @return {?string} the located executable, or `null`.
  */
-function locateSynchronously() {
+function locateSynchronously(browserName) {
+  browserName = browserName || Browser.EDGE;
+
+  if (browserName === EDGE_CHROMIUM_BROWSER_NAME) {
+    return io.findInPath(EDGEDRIVER_CHROMIUM_EXE, true);
+  }
+
   return process.platform === 'win32'
-      ? io.findInPath(EDGEDRIVER_EXE, true) : null;
+      ? io.findInPath(EDGEDRIVER_LEGACY_EXE, true) : null;
 }
 
 
 /**
- * Class for managing MicrosoftEdgeDriver specific options.
+ * Class for managing Edge specific options.
  */
-class Options extends Capabilities {
+class Options extends chromium.Options {
   /**
-   * @param {(Capabilities|Map<string, ?>|Object)=} other Another set of
-   *     capabilities to initialize this instance from.
+   * Instruct the EdgeDriver to use Edge Chromium if true.
+   * Otherwise, use Edge Legacy (EdgeHTML). Defaults to using Edge Legacy.
+   *
+   * @param {boolean} useEdgeChromium
+   * @return {!Options} A self reference.
    */
-  constructor(other = undefined) {
-    super(other);
-    this.setBrowserName(Browser.EDGE);
+  setEdgeChromium(useEdgeChromium) {
+    this.set(Options.USE_EDGE_CHROMIUM, !!useEdgeChromium);
+    return this;
+  }
+}
+
+Options.USE_EDGE_CHROMIUM = 'ms:edgeChromium';
+Options.prototype.BROWSER_NAME_VALUE = Browser.EDGE;
+Options.prototype.CAPABILITY_KEY = 'ms:edgeOptions';
+Options.prototype.VENDOR_CAPABILITY_PREFIX = 'ms';
+
+/**
+ * @param  {(Capabilities|Object<string, *>)=} o The options object
+ * @return {boolean}
+ */
+function useEdgeChromium(o) {
+  if (o instanceof Capabilities) {
+    return !!o.get(Options.USE_EDGE_CHROMIUM);
+  }
+
+  if (o && typeof o === 'object') {
+    return !!o[Options.USE_EDGE_CHROMIUM];
   }
+
+  return false;
 }
 
 
 /**
  * Creates {@link remote.DriverService} instances that manage a
- * MicrosoftEdgeDriver server in a child process.
+ * WebDriver server in a child process. Used for driving both
+ * Microsoft Edge Legacy and Chromium. A ServiceBuilder constructed
+ * with default parameters will launch a MicrosoftWebDriver child
+ * process for driving Edge Legacy. You may pass in a path to
+ * msedgedriver.exe to use Edge Chromium instead.
  */
-class ServiceBuilder extends remote.DriverService.Builder {
+class ServiceBuilder extends chromium.ServiceBuilder {
   /**
    * @param {string=} opt_exe Path to the server executable to use. If omitted,
-   *   the builder will attempt to locate the MicrosoftEdgeDriver on the current
+   *   the builder will attempt to locate MicrosoftWebDriver on the current
    *   PATH.
    * @throws {Error} If provided executable does not exist, or the
-   *   MicrosoftEdgeDriver cannot be found on the PATH.
+   *   MicrosoftWebDriver cannot be found on the PATH.
    */
   constructor(opt_exe) {
     let exe = opt_exe || locateSynchronously();
     if (!exe) {
-      throw Error(
-        'The ' + EDGEDRIVER_EXE + ' could not be found on the current PATH. ' +
-        'Please download the latest version of the MicrosoftEdgeDriver from ' +
-        'https://www.microsoft.com/en-us/download/details.aspx?id=48212 and ' +
-        'ensure it can be found on your PATH.');
+      throw Error('The WebDriver for Edge could not be found on the current PATH. Please ' +
+                  'download the latest version of ' + EDGEDRIVER_LEGACY_EXE + ' from ' +
+                  'https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/ and ' +
+                  'ensure it can be found on your PATH.');
     }
 
     super(exe);
-
-    // Binding to the loopback address will fail if not running with
-    // administrator privileges. Since we cannot test for that in script
-    // (or can we?), force the DriverService to use "localhost".
-    this.setHostname('localhost');
-  }
-
-  /**
-   * Enables verbose logging.
-   * @return {!ServiceBuilder} A self reference.
-   */
-  enableVerboseLogging() {
-    return this.addArguments('--verbose');
   }
 }
 
@@ -157,7 +189,7 @@ var defaultService = null;
 
 
 /**
- * Sets the default service to use for new MicrosoftEdgeDriver instances.
+ * Sets the default service to use for new Edge instances.
  * @param {!remote.DriverService} service The service to use.
  * @throws {Error} If the default service is currently running.
  */
@@ -172,10 +204,10 @@ function setDefaultService(service) {
 
 
 /**
- * Returns the default MicrosoftEdgeDriver service. If such a service has
+  * Returns the default Microsoft Edge driver service. If such a service has
  * not been configured, one will be constructed using the default configuration
- * for an MicrosoftEdgeDriver executable found on the system PATH.
- * @return {!remote.DriverService} The default MicrosoftEdgeDriver service.
+ * for a MicrosoftWebDriver executable found on the system PATH.
+ * @return {!remote.DriverService} The default Microsoft Edge driver service.
  */
 function getDefaultService() {
   if (!defaultService) {
@@ -184,6 +216,13 @@ function getDefaultService() {
   return defaultService;
 }
 
+function createServiceFromCapabilities(options) {
+  let exe;
+  if (useEdgeChromium(options)) {
+    exe = locateSynchronously(EDGE_CHROMIUM_BROWSER_NAME);
+  }
+  return new ServiceBuilder(exe).build();
+}
 
 /**
  * Creates a new WebDriver client for Microsoft's Edge.
@@ -193,16 +232,16 @@ class Driver extends webdriver.WebDriver {
    * Creates a new browser session for Microsoft's Edge browser.
    *
    * @param {(Capabilities|Options)=} options The configuration options.
-   * @param {remote.DriverService=} service The session to use; will use
-   *     the {@linkplain #getDefaultService default service} by default.
+   * @param {remote.DriverService=} service 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) {
-    let service = opt_service || getDefaultService();
+    options = options || new Options();
+    let service = opt_service || createServiceFromCapabilities(options);
     let client = service.start().then(url => new http.HttpClient(url));
     let executor = new http.Executor(client);
 
-    options = options || new Options();
     return /** @type {!Driver} */(super.createSession(
         executor, options, () => service.kill()));
   }

package/firefox.js

@@ -156,8 +156,9 @@ class AddonFormatError extends Error {
  *     installed.
  */
 async function installExtension(extension, dir) {
-  if (extension.slice(-4) !== '.xpi') {
-    throw Error('Path ath is not a xpi file: ' + extension);
+  const ext = extension.slice(-4);
+  if (ext !== '.xpi' && ext !== '.zip') {
+    throw Error('File name does not end in ".zip" or ".xpi": ' + ext);
   }
 
   let archive = await zip.load(extension);
@@ -166,9 +167,26 @@ async function installExtension(extension, dir) {
   }
 
   let buf = await archive.getFile('manifest.json');
-  let {applications} =
-      /** @type {{applications:{gecko:{id:string}}}} */(
-          JSON.parse(buf.toString('utf8')));
+  let parsedJSON = JSON.parse(buf.toString('utf8'));
+  
+  let { browser_specific_settings } =
+    /** @type {{browser_specific_settings:{gecko:{id:string}}}} */
+    parsedJSON; 
+
+  if (
+    browser_specific_settings &&
+    browser_specific_settings.gecko
+  ) {
+    /* browser_specific_settings is an alternative to applications
+     * It is meant to facilitate cross-browser plugins since Firefox48
+     * see https://bugzilla.mozilla.org/show_bug.cgi?id=1262005
+     */
+    parsedJSON.applications = browser_specific_settings;
+  }
+
+  let { applications } =
+    /** @type {{applications:{gecko:{id:string}}}} */
+    parsedJSON;
   if (!(applications && applications.gecko && applications.gecko.id)) {
     throw new AddonFormatError(`Could not find add-on ID for ${extension}`);
   }

package/http/index.js

@@ -187,6 +187,10 @@ function sendRequest(options, onOk, onError, opt_data, opt_proxy, opt_retries) {
     options.hostname = proxy.hostname;
     options.port = proxy.port;
 
+    // Update the protocol to avoid EPROTO errors when the webdriver proxy
+    // uses a different protocol from the remote selenium server.
+    options.protocol = opt_proxy.protocol;
+
     if (proxy.auth) {
       options.headers['Proxy-Authorization'] =
           'Basic ' + new Buffer(proxy.auth).toString('base64');

package/io/index.js

@@ -203,7 +203,7 @@ exports.unlink = function(aPath) {
  * @see https://www.npmjs.org/package/tmp
  */
 exports.tmpDir = function() {
-  return checkedCall(tmp.dir);
+  return checkedCall(callback => tmp.dir({ unsafeCleanup : true }, callback));
 };
 
 

package/lib/actions.js

@@ -255,7 +255,7 @@ class LegacyActionSequence {
   }
 
   /**
-   * Convenience function for performing a "drag and drop" manuever. The target
+   * 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).
    *

package/lib/atoms/get-attribute.js

@@ -2,8 +2,7 @@
 module.exports = function(){return (function(){var g=this;function l(a){return"string"==typeof a}function aa(a,b){a=a.split(".");var c=g;a[0]in c||"undefined"==typeof c.execScript||c.execScript("var "+a[0]);for(var d;a.length&&(d=a.shift());)a.length||void 0===b?c[d]&&c[d]!==Object.prototype[d]?c=c[d]:c=c[d]={}:c[d]=b}
 function ba(a){var b=typeof a;if("object"==b)if(a){if(a instanceof Array)return"array";if(a instanceof Object)return b;var c=Object.prototype.toString.call(a);if("[object Window]"==c)return"object";if("[object Array]"==c||"number"==typeof a.length&&"undefined"!=typeof a.splice&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("splice"))return"array";if("[object Function]"==c||"undefined"!=typeof a.call&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("call"))return"function"}else return"null";
 else if("function"==b&&"undefined"==typeof a.call)return"object";return b}function ca(a){var b=typeof a;return"object"==b&&null!=a||"function"==b}function da(a,b,c){return a.call.apply(a.bind,arguments)}function ea(a,b,c){if(!a)throw Error();if(2<arguments.length){var d=Array.prototype.slice.call(arguments,2);return function(){var e=Array.prototype.slice.call(arguments);Array.prototype.unshift.apply(e,d);return a.apply(b,e)}}return function(){return a.apply(b,arguments)}}
-function fa(a,b,c){Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?fa=da:fa=ea;return fa.apply(null,arguments)}function ha(a,b){var c=Array.prototype.slice.call(arguments,1);return function(){var d=c.slice();d.push.apply(d,arguments);return a.apply(this,d)}}
-function m(a,b){function c(){}c.prototype=b.prototype;a.M=b.prototype;a.prototype=new c;a.prototype.constructor=a;a.L=function(d,e,f){for(var h=Array(arguments.length-2),k=2;k<arguments.length;k++)h[k-2]=arguments[k];return b.prototype[e].apply(d,h)}};/*
+function fa(a,b,c){Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?fa=da:fa=ea;return fa.apply(null,arguments)}function ha(a,b){var c=Array.prototype.slice.call(arguments,1);return function(){var d=c.slice();d.push.apply(d,arguments);return a.apply(this,d)}}function m(a,b){function c(){}c.prototype=b.prototype;a.prototype=new c;a.prototype.constructor=a};/*
 
  The MIT License
 

package/lib/atoms/is-displayed.js

@@ -2,8 +2,7 @@
 module.exports = function(){return (function(){var k=this;function l(a){return void 0!==a}function n(a){return"string"==typeof a}function aa(a,b){a=a.split(".");var c=k;a[0]in c||"undefined"==typeof c.execScript||c.execScript("var "+a[0]);for(var d;a.length&&(d=a.shift());)!a.length&&l(b)?c[d]=b:c[d]&&c[d]!==Object.prototype[d]?c=c[d]:c=c[d]={}}
 function ba(a){var b=typeof a;if("object"==b)if(a){if(a instanceof Array)return"array";if(a instanceof Object)return b;var c=Object.prototype.toString.call(a);if("[object Window]"==c)return"object";if("[object Array]"==c||"number"==typeof a.length&&"undefined"!=typeof a.splice&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("splice"))return"array";if("[object Function]"==c||"undefined"!=typeof a.call&&"undefined"!=typeof a.propertyIsEnumerable&&!a.propertyIsEnumerable("call"))return"function"}else return"null";
 else if("function"==b&&"undefined"==typeof a.call)return"object";return b}function ca(a,b,c){return a.call.apply(a.bind,arguments)}function da(a,b,c){if(!a)throw Error();if(2<arguments.length){var d=Array.prototype.slice.call(arguments,2);return function(){var e=Array.prototype.slice.call(arguments);Array.prototype.unshift.apply(e,d);return a.apply(b,e)}}return function(){return a.apply(b,arguments)}}
-function ea(a,b,c){Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?ea=ca:ea=da;return ea.apply(null,arguments)}function fa(a,b){var c=Array.prototype.slice.call(arguments,1);return function(){var d=c.slice();d.push.apply(d,arguments);return a.apply(this,d)}}
-function t(a,b){function c(){}c.prototype=b.prototype;a.K=b.prototype;a.prototype=new c;a.prototype.constructor=a;a.J=function(d,e,f){for(var g=Array(arguments.length-2),h=2;h<arguments.length;h++)g[h-2]=arguments[h];return b.prototype[e].apply(d,g)}};/*
+function ea(a,b,c){Function.prototype.bind&&-1!=Function.prototype.bind.toString().indexOf("native code")?ea=ca:ea=da;return ea.apply(null,arguments)}function fa(a,b){var c=Array.prototype.slice.call(arguments,1);return function(){var d=c.slice();d.push.apply(d,arguments);return a.apply(this,d)}}function t(a,b){function c(){}c.prototype=b.prototype;a.prototype=new c;a.prototype.constructor=a};/*
 
  The MIT License
 
@@ -83,7 +82,7 @@ ghostwhite:"#f8f8ff",gold:"#ffd700",goldenrod:"#daa520",gray:"#808080",green:"#0
 lightseagreen:"#20b2aa",lightskyblue:"#87cefa",lightslategray:"#778899",lightslategrey:"#778899",lightsteelblue:"#b0c4de",lightyellow:"#ffffe0",lime:"#00ff00",limegreen:"#32cd32",linen:"#faf0e6",magenta:"#ff00ff",maroon:"#800000",mediumaquamarine:"#66cdaa",mediumblue:"#0000cd",mediumorchid:"#ba55d3",mediumpurple:"#9370db",mediumseagreen:"#3cb371",mediumslateblue:"#7b68ee",mediumspringgreen:"#00fa9a",mediumturquoise:"#48d1cc",mediumvioletred:"#c71585",midnightblue:"#191970",mintcream:"#f5fffa",mistyrose:"#ffe4e1",
 moccasin:"#ffe4b5",navajowhite:"#ffdead",navy:"#000080",oldlace:"#fdf5e6",olive:"#808000",olivedrab:"#6b8e23",orange:"#ffa500",orangered:"#ff4500",orchid:"#da70d6",palegoldenrod:"#eee8aa",palegreen:"#98fb98",paleturquoise:"#afeeee",palevioletred:"#db7093",papayawhip:"#ffefd5",peachpuff:"#ffdab9",peru:"#cd853f",pink:"#ffc0cb",plum:"#dda0dd",powderblue:"#b0e0e6",purple:"#800080",red:"#ff0000",rosybrown:"#bc8f8f",royalblue:"#4169e1",saddlebrown:"#8b4513",salmon:"#fa8072",sandybrown:"#f4a460",seagreen:"#2e8b57",
 seashell:"#fff5ee",sienna:"#a0522d",silver:"#c0c0c0",skyblue:"#87ceeb",slateblue:"#6a5acd",slategray:"#708090",slategrey:"#708090",snow:"#fffafa",springgreen:"#00ff7f",steelblue:"#4682b4",tan:"#d2b48c",teal:"#008080",thistle:"#d8bfd8",tomato:"#ff6347",turquoise:"#40e0d0",violet:"#ee82ee",wheat:"#f5deb3",white:"#ffffff",whitesmoke:"#f5f5f5",yellow:"#ffff00",yellowgreen:"#9acd32"};var oc="backgroundColor borderTopColor borderRightColor borderBottomColor borderLeftColor color outlineColor".split(" "),pc=/#([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])/,qc=/^#(?:[0-9a-f]{3}){1,2}$/i,rc=/^(?:rgba)?\((\d{1,3}),\s?(\d{1,3}),\s?(\d{1,3}),\s?(0|1|0\.\d*)\)$/i,sc=/^(?:rgb)?\((0|[1-9]\d{0,2}),\s?(0|[1-9]\d{0,2}),\s?(0|[1-9]\d{0,2})\)$/i;function tc(a,b){this.code=a;this.a=V[a]||uc;this.message=b||"";a=this.a.replace(/((?:^|\s+)[a-z])/g,function(c){return c.toUpperCase().replace(/^[\s\xa0]+/g,"")});b=a.length-5;if(0>b||a.indexOf("Error",b)!=b)a+="Error";this.name=a;a=Error(this.message);a.name=this.name;this.stack=a.stack||""}t(tc,Error);var uc="unknown error",V={15:"element not selectable",11:"element not visible"};V[31]=uc;V[30]=uc;V[24]="invalid cookie domain";V[29]="invalid element coordinates";V[12]="invalid element state";
-V[32]="invalid selector";V[51]="invalid selector";V[52]="invalid selector";V[17]="javascript error";V[405]="unsupported operation";V[34]="move target out of bounds";V[27]="no such alert";V[7]="no such element";V[8]="no such frame";V[23]="no such window";V[28]="script timeout";V[33]="session not created";V[10]="stale element reference";V[21]="timeout";V[25]="unable to set cookie";V[26]="unexpected alert open";V[13]=uc;V[9]="unknown command";var vc=ua(),wc=xa()||x("iPod"),xc=x("iPad"),yc=x("Android")&&!(va()||ua()||x("Opera")||x("Silk")),zc=va(),Ac=x("Safari")&&!(va()||x("Coast")||x("Opera")||x("Edge")||ua()||x("Silk")||x("Android"))&&!(xa()||x("iPad")||x("iPod"));function Bc(a){return(a=a.exec(v))?a[1]:""}(function(){if(vc)return Bc(/Firefox\/([0-9.]+)/);if(y||Ba||Aa)return Fa;if(zc)return xa()||x("iPad")||x("iPod")?Bc(/CriOS\/([0-9.]+)/):Bc(/Chrome\/([0-9.]+)/);if(Ac&&!(xa()||x("iPad")||x("iPod")))return Bc(/Version\/([0-9.]+)/);if(wc||xc){var a=/Version\/(\S+).*Mobile\/(\S+)/.exec(v);if(a)return a[1]+"."+a[2]}else if(yc)return(a=Bc(/Android\s+([0-9.]+)/))?a:Bc(/Version\/([0-9.]+)/);return""})();var Cc,Dc=function(){if(!Ca)return!1;var a=k.Components;if(!a)return!1;try{if(!a.classes)return!1}catch(e){return!1}var b=a.classes;a=a.interfaces;var c=b["@mozilla.org/xpcom/version-comparator;1"].getService(a.nsIVersionComparator),d=b["@mozilla.org/xre/app-info;1"].getService(a.nsIXULAppInfo).version;Cc=function(e){c.compare(d,""+e)};return!0}(),Ec=y&&!(9<=Number(Ka));yc&&Dc&&Cc(2.3);yc&&Dc&&Cc(4);Ac&&Dc&&Cc(6);function W(a,b){b&&"string"!==typeof b&&(b=b.toString());return!!a&&1==a.nodeType&&(!b||a.tagName.toUpperCase()==b)};var Fc=function(){var a={L:"http://www.w3.org/2000/svg"};return function(b){return a[b]||null}}();
+V[32]="invalid selector";V[51]="invalid selector";V[52]="invalid selector";V[17]="javascript error";V[405]="unsupported operation";V[34]="move target out of bounds";V[27]="no such alert";V[7]="no such element";V[8]="no such frame";V[23]="no such window";V[28]="script timeout";V[33]="session not created";V[10]="stale element reference";V[21]="timeout";V[25]="unable to set cookie";V[26]="unexpected alert open";V[13]=uc;V[9]="unknown command";var vc=ua(),wc=xa()||x("iPod"),xc=x("iPad"),yc=x("Android")&&!(va()||ua()||x("Opera")||x("Silk")),zc=va(),Ac=x("Safari")&&!(va()||x("Coast")||x("Opera")||x("Edge")||ua()||x("Silk")||x("Android"))&&!(xa()||x("iPad")||x("iPod"));function Bc(a){return(a=a.exec(v))?a[1]:""}(function(){if(vc)return Bc(/Firefox\/([0-9.]+)/);if(y||Ba||Aa)return Fa;if(zc)return xa()||x("iPad")||x("iPod")?Bc(/CriOS\/([0-9.]+)/):Bc(/Chrome\/([0-9.]+)/);if(Ac&&!(xa()||x("iPad")||x("iPod")))return Bc(/Version\/([0-9.]+)/);if(wc||xc){var a=/Version\/(\S+).*Mobile\/(\S+)/.exec(v);if(a)return a[1]+"."+a[2]}else if(yc)return(a=Bc(/Android\s+([0-9.]+)/))?a:Bc(/Version\/([0-9.]+)/);return""})();var Cc,Dc=function(){if(!Ca)return!1;var a=k.Components;if(!a)return!1;try{if(!a.classes)return!1}catch(e){return!1}var b=a.classes;a=a.interfaces;var c=b["@mozilla.org/xpcom/version-comparator;1"].getService(a.nsIVersionComparator),d=b["@mozilla.org/xre/app-info;1"].getService(a.nsIXULAppInfo).version;Cc=function(e){c.compare(d,""+e)};return!0}(),Ec=y&&!(9<=Number(Ka));yc&&Dc&&Cc(2.3);yc&&Dc&&Cc(4);Ac&&Dc&&Cc(6);function W(a,b){b&&"string"!==typeof b&&(b=b.toString());return!!a&&1==a.nodeType&&(!b||a.tagName.toUpperCase()==b)};var Fc=function(){var a={J:"http://www.w3.org/2000/svg"};return function(b){return a[b]||null}}();
 function Gc(a,b){var c=C(a);if(!c.documentElement)return null;(y||yc)&&mc(c?c.parentWindow||c.defaultView:window);try{var d=c.createNSResolver?c.createNSResolver(c.documentElement):Fc;if(y&&!Ja(7))return c.evaluate.call(c,b,a,d,9,null);if(!y||9<=Number(Ka)){for(var e={},f=c.getElementsByTagName("*"),g=0;g<f.length;++g){var h=f[g],m=h.namespaceURI;if(m&&!e[m]){var w=h.lookupPrefix(m);if(!w){var r=m.match(".*/(\\w+)/?$");w=r?r[1]:"xhtml"}e[m]=w}}var D={},M;for(M in e)D[e[M]]=M;d=function(N){return D[N]||
 null}}try{return c.evaluate(b,a,d,9,null)}catch(N){if("TypeError"===N.name)return d=c.createNSResolver?c.createNSResolver(c.documentElement):Fc,c.evaluate(b,a,d,9,null);throw N;}}catch(N){if(!Ca||"NS_ERROR_ILLEGAL_VALUE"!=N.name)throw new tc(32,"Unable to locate an element with the xpath expression "+b+" because of the following error:\n"+N);}}
 function Hc(a,b){var c=function(){var d=Gc(b,a);return d?d.singleNodeValue||null:b.selectSingleNode?(d=C(b),d.setProperty&&d.setProperty("SelectionLanguage","XPath"),b.selectSingleNode(a)):null}();if(null!==c&&(!c||1!=c.nodeType))throw new tc(32,'The result of the xpath expression "'+a+'" is: '+c+". It should be an element.");return c};function Ic(a,b,c,d){this.c=a;this.a=b;this.b=c;this.f=d}Ic.prototype.ceil=function(){this.c=Math.ceil(this.c);this.a=Math.ceil(this.a);this.b=Math.ceil(this.b);this.f=Math.ceil(this.f);return this};Ic.prototype.floor=function(){this.c=Math.floor(this.c);this.a=Math.floor(this.a);this.b=Math.floor(this.b);this.f=Math.floor(this.f);return this};Ic.prototype.round=function(){this.c=Math.round(this.c);this.a=Math.round(this.a);this.b=Math.round(this.b);this.f=Math.round(this.f);return this};function X(a,b,c,d){this.a=a;this.b=b;this.width=c;this.height=d}X.prototype.ceil=function(){this.a=Math.ceil(this.a);this.b=Math.ceil(this.b);this.width=Math.ceil(this.width);this.height=Math.ceil(this.height);return this};X.prototype.floor=function(){this.a=Math.floor(this.a);this.b=Math.floor(this.b);this.width=Math.floor(this.width);this.height=Math.floor(this.height);return this};
@@ -91,12 +90,12 @@ X.prototype.round=function(){this.a=Math.round(this.a);this.b=Math.round(this.b)
 function Y(a,b){b=wa(b);if("float"==b||"cssFloat"==b||"styleFloat"==b)b=Ec?"styleFloat":"cssFloat";a:{var c=b;var d=C(a);if(d.defaultView&&d.defaultView.getComputedStyle&&(d=d.defaultView.getComputedStyle(a,null))){c=d[c]||d.getPropertyValue(c)||"";break a}c=""}a=c||Lc(a,b);if(null===a)a=null;else if(0<=ia(oc,b)){b:{var e=a.match(rc);if(e&&(b=Number(e[1]),c=Number(e[2]),d=Number(e[3]),e=Number(e[4]),0<=b&&255>=b&&0<=c&&255>=c&&0<=d&&255>=d&&0<=e&&1>=e)){b=[b,c,d,e];break b}b=null}if(!b)b:{if(d=a.match(sc))if(b=
 Number(d[1]),c=Number(d[2]),d=Number(d[3]),0<=b&&255>=b&&0<=c&&255>=c&&0<=d&&255>=d){b=[b,c,d,1];break b}b=null}if(!b)b:{b=a.toLowerCase();c=nc[b.toLowerCase()];if(!c&&(c="#"==b.charAt(0)?b:"#"+b,4==c.length&&(c=c.replace(pc,"#$1$1$2$2$3$3")),!qc.test(c))){b=null;break b}b=[parseInt(c.substr(1,2),16),parseInt(c.substr(3,2),16),parseInt(c.substr(5,2),16),1]}a=b?"rgba("+b.join(", ")+")":a}return a}
 function Lc(a,b){var c=a.currentStyle||a.style,d=c[b];!l(d)&&"function"==ba(c.getPropertyValue)&&(d=c.getPropertyValue(b));return"inherit"!=d?l(d)?d:null:(a=Kc(a))?Lc(a,b):null}
-function Mc(a,b,c){function d(g){var h=Nc(g);return 0<h.height&&0<h.width?!0:W(g,"PATH")&&(0<h.height||0<h.width)?(g=Y(g,"stroke-width"),!!g&&0<parseInt(g,10)):"hidden"!=Y(g,"overflow")&&la(g.childNodes,function(m){return 3==m.nodeType||W(m)&&d(m)})}function e(g){return Oc(g)==Z&&ma(g.childNodes,function(h){return!W(h)||e(h)||!d(h)})}if(!W(a))throw Error("Argument to isShown must be of type Element");if(W(a,"BODY"))return!0;var f=Kc(a);if(f&&W(f,"DETAILS")&&!f.open&&!W(a,"SUMMARY"))return!1;if(W(a,
-"OPTION")||W(a,"OPTGROUP"))return a=$a(a,function(g){return W(g,"SELECT")}),!!a&&Mc(a,!0,c);if(f=Pc(a))return!!f.image&&0<f.rect.width&&0<f.rect.height&&Mc(f.image,b,c);if(W(a,"INPUT")&&"hidden"==a.type.toLowerCase()||W(a,"NOSCRIPT"))return!1;f=Y(a,"visibility");return"collapse"!=f&&"hidden"!=f&&c(a)&&(b||0!=Qc(a))&&d(a)?!e(a):!1}var Z="hidden";
+function Mc(a,b,c){function d(g){var h=Nc(g);return 0<h.height&&0<h.width?!0:W(g,"PATH")&&(0<h.height||0<h.width)?(g=Y(g,"stroke-width"),!!g&&0<parseInt(g,10)):"hidden"!=Y(g,"overflow")&&la(g.childNodes,function(m){return 3==m.nodeType||W(m)&&d(m)})}function e(g){return Oc(g)==Z&&ma(g.childNodes,function(h){return!W(h)||e(h)||!d(h)})}if(!W(a))throw Error("Argument to isShown must be of type Element");if(W(a,"BODY"))return!0;if(W(a,"OPTION")||W(a,"OPTGROUP"))return a=$a(a,function(g){return W(g,"SELECT")}),
+!!a&&Mc(a,!0,c);var f=Pc(a);if(f)return!!f.image&&0<f.rect.width&&0<f.rect.height&&Mc(f.image,b,c);if(W(a,"INPUT")&&"hidden"==a.type.toLowerCase()||W(a,"NOSCRIPT"))return!1;f=Y(a,"visibility");return"collapse"!=f&&"hidden"!=f&&c(a)&&(b||0!=Qc(a))&&d(a)?!e(a):!1}var Z="hidden";
 function Oc(a){function b(p){function q(kb){if(kb==g)return!0;var ac=Y(kb,"display");return 0==ac.lastIndexOf("inline",0)||"contents"==ac||"absolute"==bc&&"static"==Y(kb,"position")?!1:!0}var bc=Y(p,"position");if("fixed"==bc)return w=!0,p==g?null:g;for(p=Kc(p);p&&!q(p);)p=Kc(p);return p}function c(p){var q=p;if("visible"==m)if(p==g&&h)q=h;else if(p==h)return{x:"visible",y:"visible"};q={x:Y(q,"overflow-x"),y:Y(q,"overflow-y")};p==g&&(q.x="visible"==q.x?"auto":q.x,q.y="visible"==q.y?"auto":q.y);return q}
 function d(p){if(p==g){var q=(new ab(f)).a;p=q.scrollingElement?q.scrollingElement:Da||"CSS1Compat"!=q.compatMode?q.body||q.documentElement:q.documentElement;q=q.parentWindow||q.defaultView;p=y&&Ja("10")&&q.pageYOffset!=p.scrollTop?new Ua(p.scrollLeft,p.scrollTop):new Ua(q.pageXOffset||p.scrollLeft,q.pageYOffset||p.scrollTop)}else p=new Ua(p.scrollLeft,p.scrollTop);return p}var e=Rc(a),f=C(a),g=f.documentElement,h=f.body,m=Y(g,"overflow"),w;for(a=b(a);a;a=b(a)){var r=c(a);if("visible"!=r.x||"visible"!=
 r.y){var D=Nc(a);if(0==D.width||0==D.height)return Z;var M=e.a<D.a,N=e.b<D.b;if(M&&"hidden"==r.x||N&&"hidden"==r.y)return Z;if(M&&"visible"!=r.x||N&&"visible"!=r.y){M=d(a);N=e.b<D.b-M.y;if(e.a<D.a-M.x&&"visible"!=r.x||N&&"visible"!=r.x)return Z;e=Oc(a);return e==Z?Z:"scroll"}M=e.f>=D.a+D.width;D=e.c>=D.b+D.height;if(M&&"hidden"==r.x||D&&"hidden"==r.y)return Z;if(M&&"visible"!=r.x||D&&"visible"!=r.y){if(w&&(r=d(a),e.f>=g.scrollWidth-r.x||e.a>=g.scrollHeight-r.y))return Z;e=Oc(a);return e==Z?Z:"scroll"}}}return"none"}
 function Nc(a){var b=Pc(a);if(b)return b.rect;if(W(a,"HTML"))return a=C(a),a=((a?a.parentWindow||a.defaultView:window)||window).document,a="CSS1Compat"==a.compatMode?a.documentElement:a.body,a=new Va(a.clientWidth,a.clientHeight),new X(0,0,a.width,a.height);try{var c=a.getBoundingClientRect()}catch(d){return new X(0,0,0,0)}b=new X(c.left,c.top,c.right-c.left,c.bottom-c.top);y&&a.ownerDocument.body&&(a=C(a),b.a-=a.documentElement.clientLeft+a.body.clientLeft,b.b-=a.documentElement.clientTop+a.body.clientTop);
 return b}function Pc(a){var b=W(a,"MAP");if(!b&&!W(a,"AREA"))return null;var c=b?a:W(a.parentNode,"MAP")?a.parentNode:null,d=null,e=null;c&&c.name&&(d=Hc('/descendant::*[@usemap = "#'+c.name+'"]',C(c)))&&(e=Nc(d),b||"default"==a.shape.toLowerCase()||(a=Sc(a),b=Math.min(Math.max(a.a,0),e.width),c=Math.min(Math.max(a.b,0),e.height),e=new X(b+e.a,c+e.b,Math.min(a.width,e.width-b),Math.min(a.height,e.height-c))));return{image:d,rect:e||new X(0,0,0,0)}}
 function Sc(a){var b=a.shape.toLowerCase();a=a.coords.split(",");if("rect"==b&&4==a.length){b=a[0];var c=a[1];return new X(b,c,a[2]-b,a[3]-c)}if("circle"==b&&3==a.length)return b=a[2],new X(a[0]-b,a[1]-b,2*b,2*b);if("poly"==b&&2<a.length){b=a[0];c=a[1];for(var d=b,e=c,f=2;f+1<a.length;f+=2)b=Math.min(b,a[f]),d=Math.max(d,a[f]),c=Math.min(c,a[f+1]),e=Math.max(e,a[f+1]);return new X(b,c,d-b,e-c)}return new X(0,0,0,0)}function Rc(a){a=Nc(a);return new Ic(a.b,a.a+a.width,a.b+a.height,a.a)}
-function Qc(a){if(Ec){if("relative"==Y(a,"position"))return 1;a=Y(a,"filter");return(a=a.match(/^alpha\(opacity=(\d*)\)/)||a.match(/^progid:DXImageTransform.Microsoft.Alpha\(Opacity=(\d*)\)/))?Number(a[1])/100:1}return Tc(a)}function Tc(a){var b=1,c=Y(a,"opacity");c&&(b=Number(c));(a=Kc(a))&&(b*=Tc(a));return b};aa("_",function(a,b){function c(d){if(W(d)&&"none"==Y(d,"display"))return!1;var e;(e=d.parentNode)&&e.shadowRoot&&void 0!==d.assignedSlot?e=d.assignedSlot?d.assignedSlot.parentNode:null:d.getDestinationInsertionPoints&&(d=d.getDestinationInsertionPoints(),0<d.length&&(e=d[d.length-1]));if(Jc&&e instanceof ShadowRoot){if(e.host.shadowRoot!==e)return!1;e=e.host}return!e||9!=e.nodeType&&11!=e.nodeType?e&&c(e):!0}return Mc(a,!!b,c)});; return this._.apply(null,arguments);}).apply({navigator:typeof window!='undefined'?window.navigator:null,document:typeof window!='undefined'?window.document:null}, arguments);};
+function Qc(a){if(Ec){if("relative"==Y(a,"position"))return 1;a=Y(a,"filter");return(a=a.match(/^alpha\(opacity=(\d*)\)/)||a.match(/^progid:DXImageTransform.Microsoft.Alpha\(Opacity=(\d*)\)/))?Number(a[1])/100:1}return Tc(a)}function Tc(a){var b=1,c=Y(a,"opacity");c&&(b=Number(c));(a=Kc(a))&&(b*=Tc(a));return b};aa("_",function(a,b){function c(d){if(W(d)&&"none"==Y(d,"display"))return!1;var e;if((e=d.parentNode)&&e.shadowRoot&&void 0!==d.assignedSlot)e=d.assignedSlot?d.assignedSlot.parentNode:null;else if(d.getDestinationInsertionPoints){var f=d.getDestinationInsertionPoints();0<f.length&&(e=f[f.length-1])}if(Jc&&e instanceof ShadowRoot){if(e.host.shadowRoot!==e)return!1;e=e.host}return!e||9!=e.nodeType&&11!=e.nodeType?e&&W(e,"DETAILS")&&!e.open&&!W(d,"SUMMARY")?!1:e&&c(e):!0}return Mc(a,!!b,c)});; return this._.apply(null,arguments);}).apply({navigator:typeof window!='undefined'?window.navigator:null,document:typeof window!='undefined'?window.document:null}, arguments);};

package/lib/atoms/make-atoms-module.js

@@ -1,3 +1,20 @@
+// 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.
+
 const fs = require('fs');
 const path = require('path');
 

package/lib/capabilities.js

@@ -91,7 +91,7 @@ const Platform = {
 function Timeouts() {}
 
 /**
- * Defines when, in milliseconds, to interupt a script that is being
+ * Defines when, in milliseconds, to interrupt a script that is being
  * {@linkplain ./webdriver.IWebDriver#executeScript evaluated}.
  * @type {number}
  */
@@ -105,7 +105,7 @@ Timeouts.prototype.script;
 Timeouts.prototype.pageLoad;
 
 /**
- * The maximimum amount of time, in milliseconds, to spend attempting to
+ * The maximum amount of time, in milliseconds, to spend attempting to
  * {@linkplain ./webdriver.IWebDriver#findElement locate} an element on the
  * current page.
  * @type {number}
@@ -149,7 +149,7 @@ const UserPromptHandler = {
 const Capability = {
 
   /**
-   * Indicates whether a WebDriver session implicity trusts otherwise untrusted
+   * Indicates whether a WebDriver session implicitly trusts otherwise untrusted
    * and self-signed TLS certificates during navigation.
    */
   ACCEPT_INSECURE_TLS_CERTS: 'acceptInsecureCerts',
@@ -168,7 +168,7 @@ const Capability = {
    * The browser name. Common browser names are defined in the
    * {@link ./capabilities.Browser Browser} enum.
    */
-  LOGGING_PREFS: 'loggingPrefs',
+  LOGGING_PREFS: 'goog:loggingPrefs',
 
   /**
    * Defines the session's
@@ -212,6 +212,12 @@ const Capability = {
    * prompts.
    */
   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',
 };
 
 
@@ -512,6 +518,13 @@ class Capabilities {
   getAlertBehavior() {
     return this.get(Capability.UNHANDLED_PROMPT_BEHAVIOR);
   }
+
+   /**
+    * Sets the boolean flag configuration for this instance.
+    */
+  setStrictFileInteractability(strictFileInteractability) {
+    return this.set(Capability.STRICT_FILE_INTERACTABILITY, strictFileInteractability);
+  }
 }
 
 

package/lib/command.js

@@ -150,6 +150,7 @@ const Name = {
   GET_ELEMENT_SIZE: 'getElementSize',
   GET_ELEMENT_ATTRIBUTE: 'getElementAttribute',
   GET_ELEMENT_VALUE_OF_CSS_PROPERTY: 'getElementValueOfCssProperty',
+  GET_ELEMENT_PROPERTY: 'getElementProperty',
 
   SCREENSHOT: 'screenshot',
   TAKE_ELEMENT_SCREENSHOT: 'takeElementScreenshot',

package/lib/http.js

@@ -33,10 +33,10 @@ const {Session} = require('./session');
 const {WebElement} = require('./webdriver');
 
 const getAttribute = requireAtom(
-    './atoms/get-attribute.js',
+    'get-attribute.js',
     '//javascript/node/selenium-webdriver/lib/atoms:get-attribute.js');
 const isDisplayed = requireAtom(
-    './atoms/is-displayed.js',
+    'is-displayed.js',
     '//javascript/node/selenium-webdriver/lib/atoms:is-displayed.js');
 
 /**
@@ -46,7 +46,7 @@ const isDisplayed = requireAtom(
  */
 function requireAtom(module, bazelTarget) {
   try {
-    return require(module);
+    return require('./atoms/' + module);
   } catch (ex) {
     try {
       const file = bazelTarget.slice(2).replace(':', '/');
@@ -221,6 +221,7 @@ const COMMAND_MAP = new Map([
     [cmd.Name.GET_ELEMENT_LOCATION, get('/session/:sessionId/element/:id/location')],
     [cmd.Name.GET_ELEMENT_SIZE, get('/session/:sessionId/element/:id/size')],
     [cmd.Name.GET_ELEMENT_ATTRIBUTE, get('/session/:sessionId/element/:id/attribute/:name')],
+    [cmd.Name.GET_ELEMENT_PROPERTY, get('/session/:sessionId/element/:id/property/:name')],
     [cmd.Name.GET_ELEMENT_VALUE_OF_CSS_PROPERTY, get('/session/:sessionId/element/:id/css/:propertyName')],
     [cmd.Name.TAKE_ELEMENT_SCREENSHOT, get('/session/:sessionId/element/:id/screenshot')],
     [cmd.Name.SWITCH_TO_WINDOW, post('/session/:sessionId/window')],
@@ -309,6 +310,7 @@ const W3C_COMMAND_MAP = new Map([
   [cmd.Name.FIND_CHILD_ELEMENTS, post('/session/:sessionId/element/:id/elements')],
   // Element interaction.
   [cmd.Name.GET_ELEMENT_TAG_NAME, get('/session/:sessionId/element/:id/name')],
+  [cmd.Name.GET_ELEMENT_PROPERTY, get('/session/:sessionId/element/:id/property/:name')],
   [cmd.Name.GET_ELEMENT_VALUE_OF_CSS_PROPERTY, get('/session/:sessionId/element/:id/css/:propertyName')],
   [cmd.Name.GET_ELEMENT_RECT, get('/session/:sessionId/element/:id/rect')],
   [cmd.Name.CLEAR_ELEMENT, post('/session/:sessionId/element/:id/clear')],
@@ -336,6 +338,9 @@ const W3C_COMMAND_MAP = new Map([
   // Screenshots.
   [cmd.Name.SCREENSHOT, get('/session/:sessionId/screenshot')],
   [cmd.Name.TAKE_ELEMENT_SCREENSHOT, get('/session/:sessionId/element/:id/screenshot')],
+  // Log extensions.
+  [cmd.Name.GET_LOG, post('/session/:sessionId/se/log')],
+  [cmd.Name.GET_AVAILABLE_LOG_TYPES, get('/session/:sessionId/se/log/types')],
 ]);
 
 

package/lib/input.js

@@ -152,7 +152,7 @@ Key.chord = function(...keys) {
  * elements. Of particular note is the
  * {@link selenium-webdriver/remote.FileDetector}, which should be used when
  * running against a remote
- * [Selenium Server](http://docs.seleniumhq.org/download/).
+ * [Selenium Server](https://selenium.dev/downloads/).
  */
 class FileDetector {
 
@@ -478,7 +478,7 @@ Pointer.Type = {
  *
  * The length of each action tick is however long it takes the remote end to
  * execute the actions for every device in that tick. Most actions are
- * "instaneous", however, {@linkplain #pause pause} and
+ * "instantaneous", however, {@linkplain #pause pause} and
  * {@linkplain #move pointer move} actions allow you to specify a duration for
  * how long that action should take. The remote end will always wait for all
  * actions within a tick to finish before starting the next tick, so a device
@@ -495,7 +495,7 @@ Pointer.Type = {
  *
  * This implicit waiting also applies to pauses. In the table below, even though
  * the keyboard only defines a pause of 100 ms, the remote end will wait an
- * additional 200 ms for the mouse mmove to finish before moving to Tick 2.
+ * additional 200 ms for the mouse move to finish before moving to Tick 2.
  *
  * | Device   | Tick 1                | Tick 2         |
  * | -------- | --------------------- | -------------- |
@@ -554,13 +554,13 @@ Pointer.Type = {
  *     when translating actions to the legacy protocol.
  *
  * 6.  For W3C actions, move offsets relative to a
- *     {@linkplain ./webdriver.WebElement WebElement} are interpretted relative
+ *     {@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 conributes to the overall latency issue outlined in
+ *     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
@@ -692,7 +692,7 @@ class Actions {
    * If no devices are specified, a pause action will be created (using the same
    * duration) for every device.
    *
-   * When device synchroniation is enabled (the default for new {@link Actions}
+   * When device synchronization is enabled (the default for new {@link Actions}
    * objects), there is no need to specify devices as pausing one automatically
    * pauses the others for the same duration. In other words, the following are
    * all equivalent:

package/lib/logging.js

@@ -56,7 +56,7 @@
  * **NOTE:** Only a few browsers support the remote logging API (notably
  * Firefox and Chrome). Firefox supports basic logging functionality, while
  * Chrome exposes robust
- * [performance logging](https://sites.google.com/a/chromium.org/chromedriver/logging)
+ * [performance logging](https://chromedriver.chromium.org/logging)
  * options. Remote logging is still considered a non-standard feature, and the
  * APIs exposed by this module for it are non-frozen. This module will be
  * updated, possibly breaking backwards-compatibility, once logging is