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

package/example/firefox_channels.js

@@ -0,0 +1,84 @@
+// 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.
+
+/**
+ * @fileoverview This is an example of working with the different Firefox
+ * release channels. Before running this example, you will need to have
+ * installed Firefox's release, nightly, and developer editions:
+ *
+ * - https://www.mozilla.org/en-US/firefox/channel/desktop/#aurora
+ * - https://www.mozilla.org/en-US/firefox/channel/desktop/#nightly
+ */
+
+'use strict'
+
+const { Builder, By, Key, promise, until } = require('..')
+const { Channel, Options } = require('../firefox')
+
+let i = 0
+function resposition(driver) {
+  return driver
+    .manage()
+    .window()
+    .setRect({
+      width: 600,
+      height: 400,
+      x: 300 * i++,
+      y: 0,
+    })
+}
+
+async function doSearch(driver) {
+  try {
+    // Start on the base about page.
+    await driver.get('about:')
+    // Reposition so users can see the three windows.
+    await resposition(driver)
+    // Pause so users can see the magic.
+    await promise.delayed(750)
+    // Now do the rest.
+    await driver.get('http://www.google.com/ncr')
+    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
+    await driver.wait(until.titleIs('webdriver - Google Search'), 1000)
+    console.log('Success!')
+  } catch (ex) {
+    console.log('An error occured! ' + ex)
+  } finally {
+    await driver.quit()
+  }
+}
+
+function createDriver(channel) {
+  let options = new Options().setBinary(channel)
+  return new Builder().forBrowser('firefox').setFirefoxOptions(options).build()
+}
+
+Promise.all([
+  doSearch(createDriver(Channel.RELEASE)),
+  doSearch(createDriver(Channel.AURORA)), // Developer Edition.
+  doSearch(createDriver(Channel.NIGHTLY)),
+]).then(
+  (_) => {
+    console.log('All done!')
+  },
+  (err) => {
+    console.error('An error occured! ' + err)
+    setTimeout(() => {
+      throw err
+    }, 0)
+  }
+)

package/example/google_search.js

@@ -0,0 +1,50 @@
+// 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.
+
+/**
+ * @fileoverview An example WebDriver script.
+ *
+ * Before running this script, ensure that Mozilla's geckodriver is present on
+ * your system PATH: <https://github.com/mozilla/geckodriver/releases>
+ *
+ * Usage:
+ *   // Default behavior
+ *   node selenium-webdriver/example/google_search.js
+ *
+ *   // Target Chrome locally; the chromedriver must be on your PATH
+ *   SELENIUM_BROWSER=chrome node selenium-webdriver/example/google_search.js
+ *
+ *   // Use a local copy of the standalone Selenium server
+ *   SELENIUM_SERVER_JAR=/path/to/selenium-server-standalone.jar \
+ *     node selenium-webdriver/example/google_search.js
+ *
+ *   // Target a remote Selenium server
+ *   SELENIUM_REMOTE_URL=http://www.example.com:4444/wd/hub \
+ *     node selenium-webdriver/example/google_search.js
+ */
+
+const { Builder, By, Key, until } = require('..')
+
+var driver = new Builder().forBrowser('firefox').build()
+
+driver
+  .get('http://www.google.com/ncr')
+  .then((_) =>
+    driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
+  )
+  .then((_) => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
+  .then((_) => driver.quit())

package/example/google_search_test.js

@@ -0,0 +1,70 @@
+// 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.
+
+/**
+ * @fileoverview An example test that may be run using Mocha.
+ *
+ * This example uses the `selenium-webdriver/testing.suite` function, which will
+ * automatically run tests against every available WebDriver browser on the
+ * current system. Alternatively, you may use the `SELENIUM_BROWSER`
+ * environment variable to narrow the scope at runtime.
+ *
+ * Usage:
+ *
+ *     # Automatically determine which browsers to run against.
+ *     mocha -t 10000 selenium-webdriver/example/google_search_test.js
+ *
+ *     # Configure tests to only run against Google Chrome.
+ *     SELENIUM_BROWSER=chrome \
+ *         mocha -t 10000 selenium-webdriver/example/google_search_test.js
+ */
+
+const { Browser, By, Key, until } = require('..')
+const { ignore, suite } = require('../testing')
+
+suite(function (env) {
+  describe('Google Search', function () {
+    let driver
+
+    before(async function () {
+      // env.builder() returns a Builder instance preconfigured for the
+      // envrionment's target browser (you may still define browser specific
+      // options if necessary (i.e. firefox.Options or chrome.Options)).
+      driver = await env.builder().build()
+    })
+
+    it('demo', async function () {
+      await driver.get('https://www.google.com/ncr')
+      await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
+      await driver.wait(until.titleIs('webdriver - Google Search'), 1000)
+    })
+
+    // The ignore function returns wrappers around describe & it that will
+    // suppress tests if the provided predicate returns true. You may provide
+    // any synchronous predicate. The env.browsers(...) function generates a
+    // predicate that will suppress tests if the  env targets one of the
+    // specified browsers.
+    //
+    // This example is always configured to skip Chrome.
+    ignore(env.browsers(Browser.CHROME)).it('demo 2', async function () {
+      await driver.get('https://www.google.com/ncr')
+      await driver.wait(until.urlIs('https://www.google.com/'), 1500)
+    })
+
+    after(() => driver && driver.quit())
+  })
+})

package/example/headless.js

@@ -0,0 +1,63 @@
+// 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.
+
+/**
+ * @fileoverview An example of running Chrome or Firefox in headless mode.
+ *
+ * To run with Chrome, ensure you have Chrome 59+ installed and that
+ * chromedriver 2.30+ is present on your system PATH:
+ * <https://chromedriver.chromium.org/downloads>
+ *
+ *     SELENIUM_BROWSER=chrome node selenium-webdriver/example/headless.js
+ *
+ * To run with Firefox, ensure you have Firefox 57+ installed and that
+ * geckodriver 0.19.0+ is present on your system PATH:
+ * <https://github.com/mozilla/geckodriver/releases>
+ *
+ *     SELENIUM_BROWSER=firefox node selenium-webdriver/example/headless.js
+ */
+
+const chrome = require('../chrome')
+const firefox = require('../firefox')
+const { Builder, By, Key, until } = require('..')
+
+const width = 640
+const height = 480
+
+let driver = new Builder()
+  .forBrowser('chrome')
+  .setChromeOptions(
+    new chrome.Options().headless().windowSize({ width, height })
+  )
+  .setFirefoxOptions(
+    new firefox.Options().headless().windowSize({ width, height })
+  )
+  .build()
+
+driver
+  .get('http://www.google.com/ncr')
+  .then((_) =>
+    driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
+  )
+  .then((_) => driver.wait(until.titleIs('webdriver - Google Search'), 1000))
+  .then(
+    (_) => driver.quit(),
+    (e) =>
+      driver.quit().then(() => {
+        throw e
+      })
+  )

package/example/logging.js

@@ -0,0 +1,64 @@
+// 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.
+
+/**
+ * @fileoverview Demonstrates how to use WebDriver's logging sysem.
+ */
+
+'use strict'
+
+const chrome = require('../chrome')
+const firefox = require('../firefox')
+const edge = require('../edge')
+const { Builder, By, Key, logging, until } = require('..')
+
+logging.installConsoleHandler()
+logging.getLogger('webdriver.http').setLevel(logging.Level.ALL)
+;(async function () {
+  let driver
+  try {
+    driver = await new Builder()
+      // Default to using Firefox. This can be overridden at runtime by
+      // setting the SELENIUM_BROWSER environment variable:
+      //
+      //   SELENIUM_BROWSER=chrome node selenium-webdriver/example/logging.js
+      .forBrowser('firefox')
+      // Configure the service for each browser to enable verbose logging and
+      // to inherit the stdio settings from the current process. The builder
+      // will only start the service if needed for the selected browser.
+      .setChromeService(
+        new chrome.ServiceBuilder().enableVerboseLogging().setStdio('inherit')
+      )
+      .setEdgeService(
+        process.platform === 'win32'
+          ? new edge.ServiceBuilder().enableVerboseLogging().setStdio('inherit')
+          : null
+      )
+      .setFirefoxService(
+        new firefox.ServiceBuilder().enableVerboseLogging().setStdio('inherit')
+      )
+      .build()
+
+    await driver.get('http://www.google.com/ncr')
+    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
+    await driver.wait(until.titleIs('webdriver - Google Search'), 1000)
+  } finally {
+    if (driver) {
+      await driver.quit()
+    }
+  }
+})()

package/firefox.js

@@ -124,6 +124,7 @@ const io = require('./io')
 const remote = require('./remote')
 const webdriver = require('./lib/webdriver')
 const zip = require('./io/zip')
+const cdp = require('./devtools/CDPConnection')
 const { Browser, Capabilities } = require('./lib/capabilities')
 const { Zip } = require('./io/zip')
 
@@ -222,7 +223,7 @@ async function buildProfile(template, extensions) {
     dir = await io.tmpDir()
     if (template) {
       await io.copyDir(
-        /** @type {string} */ (template),
+        /** @type {string} */(template),
         dir,
         /(parent\.lock|lock|\.parentlock)/
       )
@@ -432,11 +433,11 @@ function findGeckoDriver() {
   if (!exe) {
     throw Error(
       'The ' +
-        GECKO_DRIVER_EXE +
-        ' executable could not be found on the current ' +
-        'PATH. Please download the latest version from ' +
-        'https://github.com/mozilla/geckodriver/releases/ ' +
-        'and ensure it can be found on your PATH.'
+      GECKO_DRIVER_EXE +
+      ' executable could not be found on the current ' +
+      'PATH. Please download the latest version from ' +
+      'https://github.com/mozilla/geckodriver/releases/ ' +
+      'and ensure it can be found on your PATH.'
     )
   }
   return exe
@@ -457,8 +458,8 @@ function findInProgramFiles(file) {
     return exists
       ? files[0]
       : io.exists(files[1]).then(function (exists) {
-          return exists ? files[1] : null
-        })
+        return exists ? files[1] : null
+      })
   })
 }
 
@@ -592,7 +593,7 @@ class Driver extends webdriver.WebDriver {
    * implementation.
    * @override
    */
-  setFileDetector() {}
+  setFileDetector() { }
 
   /**
    * Get the context that is currently in effect.

package/http/util.js

@@ -35,9 +35,9 @@ const Executor = require('./index').Executor,
  *     a hash of the server status.
  */
 function getStatus(url) {
-  var client = new HttpClient(url)
-  var executor = new Executor(client)
-  var command = new Command(CommandName.GET_SERVER_STATUS)
+  const client = new HttpClient(url)
+  const executor = new Executor(client)
+  const command = new Command(CommandName.GET_SERVER_STATUS)
   return executor.execute(command)
 }
 

package/index.js

@@ -598,9 +598,9 @@ class Builder {
   build() {
     // Create a copy for any changes we may need to make based on the current
     // environment.
-    var capabilities = new Capabilities(this.capabilities_)
+    const capabilities = new Capabilities(this.capabilities_)
 
-    var browser
+    let browser
     if (!this.ignoreEnv_ && process.env.SELENIUM_BROWSER) {
       this.log_.fine(`SELENIUM_BROWSER=${process.env.SELENIUM_BROWSER}`)
       browser = process.env.SELENIUM_BROWSER.split(/:/, 3)

package/io/index.js

@@ -17,10 +17,10 @@
 
 'use strict'
 
-var fs = require('fs'),
-  path = require('path'),
-  rimraf = require('rimraf'),
-  tmp = require('tmp')
+const fs = require('fs')
+const path = require('path')
+const rimraf = require('rimraf')
+const tmp = require('tmp')
 
 /**
  * @param {!Function} fn .

package/lib/actions.js

@@ -26,9 +26,9 @@ const input = require('./input')
  * @return {!Array} .
  */
 function flatten(args) {
-  let result = []
+  const result = []
   for (let i = 0; i < args.length; i++) {
-    let element = args[i]
+    const element = args[i]
     if (Array.isArray(element)) {
       result.push.apply(result, flatten(element))
     } else {
@@ -119,8 +119,8 @@ class LegacyActionSequence {
     // 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) {
+    const actions = this.actions_.concat()
+    for (const action of actions) {
       await this.driver_.execute(action.command)
     }
   }
@@ -141,7 +141,7 @@ class LegacyActionSequence {
    * @return {!LegacyActionSequence} A self reference.
    */
   mouseMove(location, opt_offset) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_MOUSE_MOVE)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_MOUSE_MOVE)
 
     if (typeof location.x === 'number') {
       setOffset(/** @type {{x: number, y: number}} */ (location))
@@ -389,8 +389,9 @@ class LegacyActionSequence {
    * @return {!LegacyActionSequence} A self reference.
    * @throws {Error} If the key is not a valid modifier key.
    */
-  sendKeys(var_args) { // eslint-disable-line
-    let keys = flatten(arguments)
+  sendKeys(_var_args) {
+    // eslint-disable-line
+    const keys = flatten(arguments)
     return this.scheduleKeyboardAction_('sendKeys', keys)
   }
 }
@@ -481,7 +482,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   doubleTap(elem) {
-    let cmd = new command.Command(
+    const cmd = new command.Command(
       command.Name.LEGACY_ACTION_TOUCH_DOUBLE_TAP
     ).setParameter('element', elem.getId())
 
@@ -496,7 +497,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   longPress(elem) {
-    let cmd = new command.Command(
+    const cmd = new command.Command(
       command.Name.LEGACY_ACTION_TOUCH_LONG_PRESS
     ).setParameter('element', elem.getId())
 
@@ -511,7 +512,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   tapAndHold(location) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_DOWN)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_DOWN)
       .setParameter('x', location.x)
       .setParameter('y', location.y)
 
@@ -526,7 +527,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   move(location) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_MOVE)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_MOVE)
       .setParameter('x', location.x)
       .setParameter('y', location.y)
 
@@ -556,7 +557,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   scroll(offset) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
       .setParameter('xoffset', offset.x)
       .setParameter('yoffset', offset.y)
 
@@ -573,7 +574,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   scrollFromElement(elem, offset) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_SCROLL)
       .setParameter('element', elem.getId())
       .setParameter('xoffset', offset.x)
       .setParameter('yoffset', offset.y)
@@ -590,7 +591,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   flick(speed) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
       .setParameter('xspeed', speed.xspeed)
       .setParameter('yspeed', speed.yspeed)
 
@@ -607,7 +608,7 @@ class LegacyTouchSequence {
    * @return {!LegacyTouchSequence} A self reference.
    */
   flickElement(elem, offset, speed) {
-    let cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
+    const cmd = new command.Command(command.Name.LEGACY_ACTION_TOUCH_FLICK)
       .setParameter('element', elem.getId())
       .setParameter('xoffset', offset.x)
       .setParameter('yoffset', offset.y)

package/lib/atoms/find-elements.js

@@ -115,9 +115,10 @@ b.push(c+a)}function gd(a){if(Pc){if("relative"==V(a,"position"))return 1;a=V(a,
 function sd(a,b,c,d,e){if(3==a.nodeType&&c)qd(a,b,d,e);else if(S(a))if(S(a,"CONTENT")||S(a,"SLOT")){for(var f=a;f.parentNode;)f=f.parentNode;f instanceof ShadowRoot?(a=S(a,"CONTENT")?a.getDistributedNodes():a.assignedNodes(),q(a,function(g){sd(g,b,c,d,e)})):md(a,b)}else if(S(a,"SHADOW")){for(f=a;f.parentNode;)f=f.parentNode;if(f instanceof ShadowRoot&&(a=f))for(a=a.olderShadowRoot;a;)q(a.childNodes,function(g){sd(g,b,c,d,e)}),a=a.olderShadowRoot}else md(a,b)}
 function md(a,b){a.shadowRoot&&q(a.shadowRoot.childNodes,function(c){sd(c,b,!0,null,null)});od(a,b,function(c,d,e,f,g){var h=null;1==c.nodeType?h=c:3==c.nodeType&&(h=c);null!=h&&(null!=h.assignedSlot||h.getDestinationInsertionPoints&&0<h.getDestinationInsertionPoints().length)||sd(c,d,e,f,g)})};var td={C:function(a,b){return!(!a.querySelectorAll||!a.querySelector)&&!/^\d.*/.test(b)},o:function(a,b){var c=eb(b),d="string"===typeof a?c.a.getElementById(a):a;return d?Xc(d,"id")==a&&b!=d&&hb(b,d)?d:ta(mb(c,"*"),function(e){return Xc(e,"id")==a&&b!=e&&hb(b,e)}):null},j:function(a,b){if(!a)return[];if(td.C(b,a))try{return b.querySelectorAll("#"+td.T(a))}catch(c){return[]}b=mb(eb(b),"*",null,b);return oa(b,function(c){return Xc(c,"id")==a})},T:function(a){return a.replace(/([\s'"\\#.:;,!?+<>=~*^$|%&@`{}\-\/\[\]\(\)])/g,
 "\\$1")}};var Y={},ud={};Y.N=function(a,b,c){try{var d=Qc.j("a",b)}catch(e){d=mb(eb(b),"A",null,b)}return ta(d,function(e){e=ld(e);e=e.replace(/^[\s]+|[\s]+$/g,"");return c&&-1!=e.indexOf(a)||e==a})};Y.K=function(a,b,c){try{var d=Qc.j("a",b)}catch(e){d=mb(eb(b),"A",null,b)}return oa(d,function(e){e=ld(e);e=e.replace(/^[\s]+|[\s]+$/g,"");return c&&-1!=e.indexOf(a)||e==a})};Y.o=function(a,b){return Y.N(a,b,!1)};Y.j=function(a,b){return Y.K(a,b,!1)};ud.o=function(a,b){return Y.N(a,b,!0)};
-ud.j=function(a,b){return Y.K(a,b,!0)};var Z={F:function(a,b){return function(c){var d=Z.u(a);d=W(d);c=W(c);return b.call(null,d,c)}},R:function(a){return Z.F(a,function(b,c){return c.b+c.height<b.b})},S:function(a){return Z.F(a,function(b,c){return b.b+b.height<c.b})},V:function(a){return Z.F(a,function(b,c){return c.a+c.width<b.a})},aa:function(a){return Z.F(a,function(b,c){return b.a+b.width<c.a})},W:function(a,b){if(b)var c=b;else"number"==typeof a.distance&&(c=a.distance,delete a.distance);c||(c=50);return function(d){var e=Z.u(a);
-if(e===d)return!1;e=W(e);d=W(d);var f=d.a+d.width,g=e.b-e.height,h=d.b-d.height;return Math.abs(e.a+e.width-d.a)<=c||Math.abs(f-e.a)<=c?Math.abs(g-d.b)<=c||Math.abs(h-e.b)<=c:!1}},u:function(a){if(ea(a)&&1==a.nodeType)return a;if(da(a))return Z.u(a.call(null));if(ea(a)){var b;a:{if(b=vd(a)){var c=wd[b];if(c&&da(c.o)){b=c.o(a[b],Bc.document);break a}}throw new P(61,"Unsupported locator strategy: "+b);}if(!b)throw new P(7,"No element has been found by "+JSON.stringify(a));return b}throw new P(61,"Selector is of wrong type: "+
-JSON.stringify(a));}};Z.P={left:Z.V,right:Z.aa,above:Z.R,below:Z.S,near:Z.W};Z.O={left:Z.u,right:Z.u,above:Z.u,below:Z.u,near:Z.u};Z.U=function(a,b){var c=[];q(a,function(e){e&&sa(b,function(f){var g=f.kind,h=Z.P[g];if(!h)throw new P(61,"Cannot find filter suitable for "+g);return h.apply(null,f.args)(e)},null)&&c.push(e)},null);a=b[b.length-1];var d=Z.O[a?a.kind:"unknown"];return d?(a=d.apply(null,a.args))?Z.ba(a,c):c:c};
+ud.j=function(a,b){return Y.K(a,b,!0)};var Z={F:function(a,b){return function(c){var d=Z.u(a);d=W(d);c=W(c);return b.call(null,d,c)}},R:function(a){return Z.F(a,function(b,c){return c.b+c.height<b.b})},S:function(a){return Z.F(a,function(b,c){return b.b+b.height<c.b})},V:function(a){return Z.F(a,function(b,c){return c.a+c.width<b.a})},aa:function(a){return Z.F(a,function(b,c){return b.a+b.width<c.a})},W:function(a,b){var c;b?c=b:"number"==typeof a.distance&&(c=a.distance);c||(c=100);return function(d){var e=Z.u(a);if(e===d)return!1;e=
+W(e);d=W(d);var f=Math.abs(e.a+e.width-d.a),g=Math.abs(e.b+e.height-d.b);g=Math.abs(e.b-(d.b+d.height))<=c||g<=c;return(Math.abs(e.a-(d.a+d.width))<=c||f<=c)&&g?!0:Math.sqrt(Math.pow(Math.abs(e.a+e.width/2-(d.a+d.width/2)),2)+Math.pow(Math.abs(e.b+e.height/2-(d.b+d.height/2)),2))<=c}},u:function(a){if(ea(a)&&1==a.nodeType)return a;if(da(a))return Z.u(a.call(null));if(ea(a)){var b;a:{if(b=vd(a)){var c=wd[b];if(c&&da(c.o)){b=c.o(a[b],Bc.document);break a}}throw new P(61,"Unsupported locator strategy: "+
+b);}if(!b)throw new P(7,"No element has been found by "+JSON.stringify(a));return b}throw new P(61,"Selector is of wrong type: "+JSON.stringify(a));}};Z.P={left:Z.V,right:Z.aa,above:Z.R,below:Z.S,near:Z.W};Z.O={left:Z.u,right:Z.u,above:Z.u,below:Z.u,near:Z.u};
+Z.U=function(a,b){var c=[];q(a,function(e){e&&sa(b,function(f){var g=f.kind,h=Z.P[g];if(!h)throw new P(61,"Cannot find filter suitable for "+g);return h.apply(null,f.args)(e)},null)&&c.push(e)},null);a=b[b.length-1];var d=Z.O[a?a.kind:"unknown"];return d?(a=d.apply(null,a.args))?Z.ba(a,c):c:c};
 Z.ba=function(a,b){function c(f){f=W(f);return Math.sqrt(Math.pow(d-(f.a+Math.max(1,f.width)/2),2)+Math.pow(e-(f.b+Math.max(1,f.height)/2),2))}a=W(a);var d=a.a+Math.max(1,a.width)/2,e=a.b+Math.max(1,a.height)/2;wa(b,function(f,g){return c(f)-c(g)});return b};Z.o=function(a,b){a=Z.j(a,b);return 0==a.length?null:a[0]};
 Z.j=function(a,b){if(!a.hasOwnProperty("root")||!a.hasOwnProperty("filters"))throw new P(61,"Locator not suitable for relative locators: "+JSON.stringify(a));var c=a.filters,d=ca(c);if("array"!=d&&("object"!=d||"number"!=typeof c.length))throw new P(61,"Targets should be an array: "+JSON.stringify(a));var e;S(a.root)?e=[a.root]:e=xd(a.root,b);return 0==e.length?[]:Z.U(e,a.filters)};var yd={o:function(a,b){if(""===a)throw new P(32,'Unable to locate an element with the tagName ""');return b.getElementsByTagName(a)[0]||null},j:function(a,b){if(""===a)throw new P(32,'Unable to locate an element with the tagName ""');return b.getElementsByTagName(a)}};var wd={className:Dc,"class name":Dc,css:Qc,"css selector":Qc,relative:Z,id:td,linkText:Y,"link text":Y,name:{o:function(a,b){b=mb(eb(b),"*",null,b);return ta(b,function(c){return Xc(c,"name")==a})},j:function(a,b){b=mb(eb(b),"*",null,b);return oa(b,function(c){return Xc(c,"name")==a})}},partialLinkText:ud,"partial link text":ud,tagName:yd,"tag name":yd,xpath:T};function vd(a){for(var b in a)if(a.hasOwnProperty(b))return b;return null}
 function xd(a,b){var c=vd(a);if(c){var d=wd[c];if(d&&da(d.j))return d.j(a[c],b||Bc.document)}throw new P(61,"Unsupported locator strategy: "+c);};ba("_",xd);; return this._.apply(null,arguments);}).apply({navigator:typeof window!='undefined'?window.navigator:null,document:typeof window!='undefined'?window.document:null}, arguments);};

package/lib/atoms/mutation-listener.js

@@ -0,0 +1,38 @@
+(function () {
+  const observer = new MutationObserver((mutations) => {
+    for (const mutation of mutations) {
+      switch (mutation.type) {
+        case 'attributes':
+          // Don't report our own attribute has changed.
+          if (mutation.attributeName === "data-__webdriver_id") {
+            break;
+          }
+          const curr = mutation.target.getAttribute(mutation.attributeName);
+          var id = mutation.target.dataset.__webdriver_id
+          if (!id) {
+            id = Math.random().toString(36).substring(2) + Date.now().toString(36);
+            mutation.target.dataset.__webdriver_id = id;
+          }
+          const json = JSON.stringify({
+            'target': id,
+            'name': mutation.attributeName,
+            'value': curr,
+            'oldValue': mutation.oldValue
+          });
+          __webdriver_attribute(json);
+          break;
+        default:
+          break;
+      }
+    }
+  });
+
+  observer.observe(document, {
+    'attributes': true,
+    'attributeOldValue': true,
+    'characterData': true,
+    'characterDataOldValue': true,
+    'childList': true,
+    'subtree': true
+  });
+})();

package/lib/by.js

@@ -252,7 +252,7 @@ class By {
   }
 
   toObject() {
-    var tmp = {}
+    const tmp = {}
     tmp[this.using] = this.value
     return tmp
   }

package/lib/capabilities.js

@@ -84,7 +84,7 @@ const Platform = {
  *
  * @record
  */
-function Timeouts() {}
+function Timeouts() { }
 
 /**
  * Defines when, in milliseconds, to interrupt a script that is being
@@ -264,7 +264,7 @@ class Capabilities {
    * @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)
   }
 
   /**

package/lib/command.js

@@ -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',