selenium-webdriver 4.0.0 → 4.1.2

package/http/util.js

@@ -21,12 +21,12 @@
 
 'use strict'
 
-const Executor = require('./index').Executor,
-  HttpClient = require('./index').HttpClient,
-  HttpRequest = require('./index').Request,
-  Command = require('../lib/command').Command,
-  CommandName = require('../lib/command').Name,
-  error = require('../lib/error')
+const Executor = require('./index').Executor
+const HttpClient = require('./index').HttpClient
+const HttpRequest = require('./index').Request
+const Command = require('../lib/command').Command
+const CommandName = require('../lib/command').Name
+const error = require('../lib/error')
 
 /**
  * Queries a WebDriver server for its current status.
@@ -43,18 +43,6 @@ function getStatus(url) {
 
 class CancellationError {}
 
-// PUBLIC API
-
-/**
- * Queries a WebDriver server for its current status.
- * @param {string} url Base URL of the server to query.
- * @return {!Promise<!Object>} A promise that resolves with
- *     a hash of the server status.
- */
-exports.getStatus = getStatus
-
-exports.CancellationError = CancellationError
-
 /**
  * Waits for a WebDriver server to be healthy and accepting requests.
  * @param {string} url Base URL of the server to query.
@@ -65,7 +53,7 @@ exports.CancellationError = CancellationError
  * @return {!Promise} A promise that will resolve when the server is ready, or
  *     if the wait is cancelled.
  */
-exports.waitForServer = function (url, timeout, opt_cancelToken) {
+function waitForServer(url, timeout, opt_cancelToken) {
   return new Promise((onResolve, onReject) => {
     let start = Date.now()
 
@@ -120,7 +108,7 @@ exports.waitForServer = function (url, timeout, opt_cancelToken) {
  * @return {!Promise} A promise that will resolve when a 2xx is received from
  *     the given URL, or if the wait is cancelled.
  */
-exports.waitForUrl = function (url, timeout, opt_cancelToken) {
+function waitForUrl(url, timeout, opt_cancelToken) {
   return new Promise((onResolve, onReject) => {
     let client = new HttpClient(url)
     let request = new HttpRequest('GET', '')
@@ -170,3 +158,9 @@ exports.waitForUrl = function (url, timeout, opt_cancelToken) {
     }
   })
 }
+
+// PUBLIC API
+module.exports.getStatus = getStatus
+module.exports.CancellationError = CancellationError
+module.exports.waitForServer = waitForServer
+module.exports.waitForUrl = waitForUrl

package/index.js

@@ -45,7 +45,7 @@ const Capabilities = capabilities.Capabilities
 const Capability = capabilities.Capability
 const WebDriver = webdriver.WebDriver
 
-var seleniumServer
+let seleniumServer
 
 /**
  * Starts an instance of the Selenium server if not yet running.
@@ -76,13 +76,12 @@ function startSeleniumServer(jar) {
  * @return {function(new: webdriver.WebDriver, ...?)}
  */
 function ensureFileDetectorsAreEnabled(ctor) {
-  const mixin = class extends ctor {
+  return class extends ctor {
     /** @param {input.FileDetector} detector */
-    setFileDetector(detector) {
+    setFileDetector (detector) {
       webdriver.WebDriver.prototype.setFileDetector.call(this, detector)
     }
   }
-  return mixin
 }
 
 /**
@@ -103,7 +102,7 @@ function ensureFileDetectorsAreEnabled(ctor) {
  */
 class ThenableWebDriver {
   /** @param {...?} args */
-  static createSession(...args) { } // eslint-disable-line
+  static createSession(...args) {} // eslint-disable-line
 }
 
 /**
@@ -339,10 +338,10 @@ class Builder {
   getCapabilities() {
     return this.capabilities_
   }
-  
+
   /**
-   * Sets the desired capability when requesting a new session. 
-   * If there is already a capability named key, its value will be overwritten with value. 
+   * Sets the desired capability when requesting a new session.
+   * If there is already a capability named key, its value will be overwritten with value.
    * This is a convenience wrapper around builder.getCapabilities().set(key, value) to support Builder method chaining.
    * @param {string} key The capability key.
    * @param {*} value The capability value.
@@ -630,7 +629,7 @@ class Builder {
     if (typeof browser !== 'string') {
       throw TypeError(
         `Target browser must be a string, but is <${typeof browser}>;` +
-        ' did you forget to call forBrowser()?'
+          ' did you forget to call forBrowser()?'
       )
     }
 
@@ -751,8 +750,8 @@ class Builder {
       default:
         throw new Error(
           'Do not know how to build driver: ' +
-          browser +
-          '; did you forget to call usingServer(url)?'
+            browser +
+            '; did you forget to call usingServer(url)?'
         )
     }
   }
@@ -808,9 +807,9 @@ function checkOptions(caps, key, optionType, setMethod) {
   if (val instanceof optionType) {
     throw new error.InvalidArgumentError(
       'Options class extends Capabilities and should not be set as key ' +
-      `"${key}"; set browser-specific options with ` +
-      `Builder.${setMethod}(). For more information, see the ` +
-      'documentation attached to the function that threw this error'
+        `"${key}"; set browser-specific options with ` +
+        `Builder.${setMethod}(). For more information, see the ` +
+        'documentation attached to the function that threw this error'
     )
   }
 }
@@ -821,8 +820,9 @@ exports.Browser = capabilities.Browser
 exports.Builder = Builder
 exports.Button = input.Button
 exports.By = by.By
+exports.RelativeBy = by.RelativeBy
 exports.withTagName = by.withTagName
-exports.withLocator = by.withLocator
+exports.locateWith = by.locateWith
 exports.Capabilities = capabilities.Capabilities
 exports.Capability = capabilities.Capability
 exports.Condition = webdriver.Condition

package/io/index.js

@@ -19,7 +19,6 @@
 
 const fs = require('fs')
 const path = require('path')
-const rimraf = require('rimraf')
 const tmp = require('tmp')
 
 /**
@@ -43,8 +42,6 @@ function checkedCall(fn) {
   })
 }
 
-// PUBLIC API
-
 /**
  * Recursively removes a directory and all of its contents. This is equivalent
  * to {@code rm -rf} on a POSIX system.
@@ -52,24 +49,16 @@ function checkedCall(fn) {
  * @return {!Promise} A promise to be resolved when the operation has
  *     completed.
  */
-exports.rmDir = function (dirPath) {
+function rmDir(dirPath) {
   return new Promise(function (fulfill, reject) {
-    var numAttempts = 0
-    attemptRm()
-    function attemptRm() {
-      numAttempts += 1
-      rimraf(dirPath, function (err) {
-        if (err) {
-          if (err.code && err.code === 'ENOTEMPTY' && numAttempts < 2) {
-            attemptRm()
-            return
-          }
-          reject(err)
-        } else {
-          fulfill()
-        }
-      })
-    }
+    fs.rm(dirPath, { recursive: true, maxRetries: 2 }, function (err) {
+      if (err && err.code === 'ENOENT') {
+        fulfill()
+      } else if (err) {
+        reject(err)
+      }
+      fulfill()
+    })
   })
 }
 
@@ -79,12 +68,12 @@ exports.rmDir = function (dirPath) {
  * @param {string} dst The destination file.
  * @return {!Promise<string>} A promise for the copied file's path.
  */
-exports.copy = function (src, dst) {
+function copy(src, dst) {
   return new Promise(function (fulfill, reject) {
-    var rs = fs.createReadStream(src)
+    const rs = fs.createReadStream(src)
     rs.on('error', reject)
 
-    var ws = fs.createWriteStream(dst)
+    const ws = fs.createWriteStream(dst)
     ws.on('error', reject)
     ws.on('close', () => fulfill(dst))
 
@@ -102,20 +91,19 @@ exports.copy = function (src, dst) {
  * @return {!Promise<string>} A promise for the destination
  *     directory's path once all files have been copied.
  */
-exports.copyDir = function (src, dst, opt_exclude) {
-  var predicate = opt_exclude
+function copyDir(src, dst, opt_exclude) {
+  let predicate = opt_exclude
   if (opt_exclude && typeof opt_exclude !== 'function') {
     predicate = function (p) {
       return !opt_exclude.test(p)
     }
   }
 
-  // TODO(jleyba): Make this function completely async.
   if (!fs.existsSync(dst)) {
     fs.mkdirSync(dst)
   }
 
-  var files = fs.readdirSync(src)
+  let files = fs.readdirSync(src)
   files = files.map(function (file) {
     return path.join(src, file)
   })
@@ -124,18 +112,18 @@ exports.copyDir = function (src, dst, opt_exclude) {
     files = files.filter(/** @type {function(string): boolean} */ (predicate))
   }
 
-  var results = []
+  const results = []
   files.forEach(function (file) {
-    var stats = fs.statSync(file)
-    var target = path.join(dst, path.basename(file))
+    const stats = fs.statSync(file)
+    const target = path.join(dst, path.basename(file))
 
     if (stats.isDirectory()) {
       if (!fs.existsSync(target)) {
         fs.mkdirSync(target, stats.mode)
       }
-      results.push(exports.copyDir(file, target, predicate))
+      results.push(copyDir(file, target, predicate))
     } else {
-      results.push(exports.copy(file, target))
+      results.push(copy(file, target))
     }
   })
 
@@ -147,14 +135,13 @@ exports.copyDir = function (src, dst, opt_exclude) {
  * @param {string} aPath The path to test.
  * @return {!Promise<boolean>} A promise for whether the file exists.
  */
-exports.exists = function (aPath) {
+function exists(aPath) {
   return new Promise(function (fulfill, reject) {
     let type = typeof aPath
     if (type !== 'string') {
       reject(TypeError(`expected string path, but got ${type}`))
     } else {
-      // eslint-disable-next-line node/no-deprecated-api
-      fs.exists(aPath, fulfill)
+      fulfill(fs.existsSync(aPath))
     }
   })
 }
@@ -164,7 +151,7 @@ exports.exists = function (aPath) {
  * @param {string} aPath The path to stat.
  * @return {!Promise<!fs.Stats>} A promise for the file stats.
  */
-exports.stat = function stat(aPath) {
+function stat(aPath) {
   return checkedCall((callback) => fs.stat(aPath, callback))
 }
 
@@ -174,18 +161,16 @@ exports.stat = function stat(aPath) {
  * @param {string} aPath The path to remove.
  * @return {!Promise} A promise for when the file has been removed.
  */
-exports.unlink = function (aPath) {
+function unlink(aPath) {
   return new Promise(function (fulfill, reject) {
-    // eslint-disable-next-line node/no-deprecated-api
-    fs.exists(aPath, function (exists) {
-      if (exists) {
-        fs.unlink(aPath, function (err) {
-          ;(err && reject(err)) || fulfill()
-        })
-      } else {
-        fulfill()
-      }
-    })
+    const exists = fs.existsSync(aPath)
+    if (exists) {
+      fs.unlink(aPath, function (err) {
+        ;(err && reject(err)) || fulfill()
+      })
+    } else {
+      fulfill()
+    }
   })
 }
 
@@ -193,7 +178,7 @@ exports.unlink = function (aPath) {
  * @return {!Promise<string>} A promise for the path to a temporary directory.
  * @see https://www.npmjs.org/package/tmp
  */
-exports.tmpDir = function () {
+function tmpDir() {
   return checkedCall((callback) => tmp.dir({ unsafeCleanup: true }, callback))
 }
 
@@ -202,7 +187,7 @@ exports.tmpDir = function () {
  * @return {!Promise<string>} A promise for the path to a temporary file.
  * @see https://www.npmjs.org/package/tmp
  */
-exports.tmpFile = function (opt_options) {
+function tmpFile(opt_options) {
   return checkedCall((callback) => {
     /**  check fixed in v > 0.2.1 if
      * (typeof options === 'function') {
@@ -222,7 +207,7 @@ exports.tmpFile = function (opt_options) {
  * @return {?string} Path to the located file, or {@code null} if it could
  *     not be found.
  */
-exports.findInPath = function (file, opt_checkCwd) {
+function findInPath(file, opt_checkCwd) {
   const dirs = []
   if (opt_checkCwd) {
     dirs.push(process.cwd())
@@ -249,7 +234,7 @@ exports.findInPath = function (file, opt_checkCwd) {
  * @return {!Promise<!Buffer>} A promise that will resolve with a buffer of the
  *     file contents.
  */
-exports.read = function (aPath) {
+function read(aPath) {
   return checkedCall((callback) => fs.readFile(aPath, callback))
 }
 
@@ -261,7 +246,7 @@ exports.read = function (aPath) {
  * @return {!Promise} A promise that will resolve when the operation has
  *     completed.
  */
-exports.write = function (aPath, data) {
+function write(aPath, data) {
   return checkedCall((callback) => fs.writeFile(aPath, data, callback))
 }
 
@@ -272,7 +257,7 @@ exports.write = function (aPath, data) {
  * @return {!Promise<string>} A promise that will resolve with the path of the
  *     created directory.
  */
-exports.mkdir = function (aPath) {
+function mkdir(aPath) {
   return checkedCall((callback) => {
     fs.mkdir(aPath, undefined, (err) => {
       if (err && err.code !== 'EEXIST') {
@@ -291,7 +276,7 @@ exports.mkdir = function (aPath) {
  * @return {!Promise<string>} A promise that will resolve with the path of the
  *     created directory.
  */
-exports.mkdirp = function mkdirp(dir) {
+function mkdirp(dir) {
   return checkedCall((callback) => {
     fs.mkdir(dir, undefined, (err) => {
       if (!err) {
@@ -327,7 +312,7 @@ exports.mkdirp = function mkdirp(dir) {
  *     resolve with a list of entries seen. For each entry, the recorded path
  *     will be relative to `rootPath`.
  */
-exports.walkDir = function (rootPath) {
+function walkDir(rootPath) {
   const seen = []
   return (function walk(dir) {
     return checkedCall((callback) => fs.readdir(dir, callback)).then((files) =>
@@ -346,3 +331,21 @@ exports.walkDir = function (rootPath) {
     )
   })(rootPath).then(() => seen)
 }
+
+// PUBLIC API
+module.exports = {
+  walkDir,
+  rmDir,
+  mkdirp,
+  mkdir,
+  write,
+  read,
+  findInPath,
+  tmpFile,
+  tmpDir,
+  unlink,
+  copy,
+  copyDir,
+  exists,
+  stat,
+}

package/io/zip.js

@@ -218,6 +218,4 @@ function unzip(src, dst) {
 }
 
 // PUBLIC API
-module.exports.Zip = Zip
-module.exports.load = load
-module.exports.unzip = unzip
+module.exports = { Zip, load, unzip }

package/lib/atoms/find-elements.js

@@ -109,8 +109,8 @@ function gd(a){var b=a.shape.toLowerCase();a=a.coords.split(",");if("rect"==b&&4
 function hd(a){return a.replace(/^[^\S\xa0]+|[^\S\xa0]+$/g,"")}function id(a){var b=[];Yc?jd(a,b):kd(a,b);a=qa(b,hd);return hd(a.join("\n")).replace(/\xa0/g," ")}
 function ld(a,b,c){if(S(a,"BR"))b.push("");else{var d=S(a,"TD"),e=V(a,"display"),f=!d&&!(0<=oa(md,e)),g=void 0!==a.previousElementSibling?a.previousElementSibling:gb(a.previousSibling);g=g?V(g,"display"):"";var h=V(a,"float")||V(a,"cssFloat")||V(a,"styleFloat");!f||"run-in"==g&&"none"==h||/^[\s\xa0]*$/.test(b[b.length-1]||"")||b.push("");var n=ed(a),u=null,p=null;n&&(u=V(a,"white-space"),p=V(a,"text-transform"));l(a.childNodes,function(G){c(G,b,n,u,p)});a=b[b.length-1]||"";!d&&"table-cell"!=e||!a||
 za(a)||(b[b.length-1]+=" ");f&&"run-in"!=e&&!/^[\s\xa0]*$/.test(a)&&b.push("")}}function kd(a,b){ld(a,b,function(c,d,e,f,g){3==c.nodeType&&e?nd(c,d,f,g):S(c)&&kd(c,d)})}var md="inline inline-block inline-table none table-cell table-column table-column-group".split(" ");
-function nd(a,b,c,d){a=a.nodeValue.replace(/[\u200b\u200e\u200f]/g,"");a=a.replace(/(\r\n|\r|\n)/g,"\n");if("normal"==c||"nowrap"==c)a=a.replace(/\n/g," ");a="pre"==c||"pre-wrap"==c?a.replace(/[ \f\t\v\u2028\u2029]/g,"\u00a0"):a.replace(/[ \f\t\v\u2028\u2029]+/g," ");"capitalize"==d?a=a.replace(/(^|[^\d\p{L}\p{S}])([\p{Ll}|\p{S}])/gu,function(e,f,g){return f+g.toUpperCase()}):"uppercase"==d?a=a.toUpperCase():"lowercase"==d&&(a=a.toLowerCase());c=b.pop()||"";za(c)&&0==a.lastIndexOf(" ",0)&&(a=a.substr(1));
-b.push(c+a)}function dd(a){if(Mc){if("relative"==V(a,"position"))return 1;a=V(a,"filter");return(a=a.match(/^alpha\(opacity=(\d*)\)/)||a.match(/^progid:DXImageTransform.Microsoft.Alpha\(Opacity=(\d*)\)/))?Number(a[1])/100:1}return od(a)}function od(a){var b=1,c=V(a,"opacity");c&&(b=Number(c));(a=Zc(a))&&(b*=od(a));return b}
+function nd(a,b,c,d){a=a.nodeValue.replace(/[\u200b\u200e\u200f]/g,"");a=a.replace(/(\r\n|\r|\n)/g,"\n");if("normal"==c||"nowrap"==c)a=a.replace(/\n/g," ");a="pre"==c||"pre-wrap"==c?a.replace(/[ \f\t\v\u2028\u2029]/g,"\u00a0"):a.replace(/[ \f\t\v\u2028\u2029]+/g," ");"capitalize"==d?a=a.replace(t?/(^|\s|\b)(\S)/g:/(^|[^\d\p{L}\p{S}])([\p{Ll}|\p{S}])/gu,function(e,f,g){return f+g.toUpperCase()}):"uppercase"==d?a=a.toUpperCase():"lowercase"==d&&(a=a.toLowerCase());c=b.pop()||"";za(c)&&0==a.lastIndexOf(" ",
+0)&&(a=a.substr(1));b.push(c+a)}function dd(a){if(Mc){if("relative"==V(a,"position"))return 1;a=V(a,"filter");return(a=a.match(/^alpha\(opacity=(\d*)\)/)||a.match(/^progid:DXImageTransform.Microsoft.Alpha\(Opacity=(\d*)\)/))?Number(a[1])/100:1}return od(a)}function od(a){var b=1,c=V(a,"opacity");c&&(b=Number(c));(a=Zc(a))&&(b*=od(a));return b}
 function pd(a,b,c,d,e){if(3==a.nodeType&&c)nd(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(),l(a,function(g){pd(g,b,c,d,e)})):jd(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;)l(a.childNodes,function(g){pd(g,b,c,d,e)}),a=a.olderShadowRoot}else jd(a,b)}
 function jd(a,b){a.shadowRoot&&l(a.shadowRoot.childNodes,function(c){pd(c,b,!0,null,null)});ld(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)||pd(c,d,e,f,g)})};var qd={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?Uc(d,"id")==a&&b!=d&&hb(b,d)?d:ua(mb(c,"*"),function(e){return Uc(e,"id")==a&&b!=e&&hb(b,e)}):null},j:function(a,b){if(!a)return[];if(qd.C(b,a))try{return b.querySelectorAll("#"+qd.T(a))}catch(c){return[]}b=mb(eb(b),"*",null,b);return pa(b,function(c){return Uc(c,"id")==a})},T:function(a){return a.replace(/([\s'"\\#.:;,!?+<>=~*^$|%&@`{}\-\/\[\]\(\)])/g,
 "\\$1")}};var Y={},rd={};Y.N=function(a,b,c){try{var d=Nc.j("a",b)}catch(e){d=mb(eb(b),"A",null,b)}return ua(d,function(e){e=id(e);e=e.replace(/^[\s]+|[\s]+$/g,"");return c&&-1!=e.indexOf(a)||e==a})};Y.K=function(a,b,c){try{var d=Nc.j("a",b)}catch(e){d=mb(eb(b),"A",null,b)}return pa(d,function(e){e=id(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)};rd.o=function(a,b){return Y.N(a,b,!0)};

package/lib/by.js

@@ -190,11 +190,9 @@ class By {
    * @return {function(!./webdriver.WebDriver): !Promise}
    *     A new JavaScript-based locator function.
    */
-  static js(script, var_args) { // eslint-disable-line
-    // eslint-disable-line
-    let args = Array.prototype.slice.call(arguments, 0)
+  static js(script, ...var_args) {
     return function (driver) {
-      return driver.executeScript.apply(driver, args)
+      return driver.executeScript.call(driver, script, ...var_args)
     }
   }
 
@@ -227,7 +225,7 @@ class By {
    * @return {!By} The new locator.
    */
   static tagName(name) {
-    return By.css(name)
+    return new By('tag name', name)
   }
 
   /**
@@ -277,7 +275,7 @@ function withTagName(tagName) {
  * @returns {RelativeBy}
  */
 function locateWith(by) {
-  return new RelativeBy(getLocator(by));
+  return new RelativeBy(getLocator(by))
 }
 
 function getLocator(locatorOrElement) {
@@ -426,9 +424,10 @@ function check(locator) {
 // PUBLIC API
 
 module.exports = {
-  By: By,
-  RelativeBy: RelativeBy,
-  withTagName: withTagName,
-  locateWith: locateWith,
+  By,
+  RelativeBy,
+  withTagName,
+  locateWith,
+  escapeCss,
   checkedLocator: check,
 }

package/lib/capabilities.js

@@ -83,7 +83,7 @@ const Platform = {
  *
  * @record
  */
-function Timeouts() { }
+function Timeouts() {}
 
 /**
  * Defines when, in milliseconds, to interrupt a script that is being

package/lib/command.js

@@ -83,7 +83,6 @@ class Command {
  * will support.
  * @enum {string}
  */
-// TODO: Delete obsolete command names.
 const Name = {
   GET_SERVER_STATUS: 'getStatus',
 
@@ -115,14 +114,9 @@ const Name = {
   CLEAR_ELEMENT: 'clearElement',
   CLICK_ELEMENT: 'clickElement',
   SEND_KEYS_TO_ELEMENT: 'sendKeysToElement',
-  SUBMIT_ELEMENT: 'submitElement',
 
   GET_CURRENT_WINDOW_HANDLE: 'getCurrentWindowHandle',
   GET_WINDOW_HANDLES: 'getWindowHandles',
-  GET_WINDOW_POSITION: 'getWindowPosition',
-  SET_WINDOW_POSITION: 'setWindowPosition',
-  GET_WINDOW_SIZE: 'getWindowSize',
-  SET_WINDOW_SIZE: 'setWindowSize',
   GET_WINDOW_RECT: 'getWindowRect',
   SET_WINDOW_RECT: 'setWindowRect',
   MAXIMIZE_WINDOW: 'maximizeWindow',
@@ -146,17 +140,14 @@ const Name = {
   IS_ELEMENT_SELECTED: 'isElementSelected',
   IS_ELEMENT_ENABLED: 'isElementEnabled',
   IS_ELEMENT_DISPLAYED: 'isElementDisplayed',
-  GET_ELEMENT_LOCATION: 'getElementLocation',
-  GET_ELEMENT_LOCATION_IN_VIEW: 'getElementLocationOnceScrolledIntoView',
   GET_ELEMENT_RECT: 'getElementRect',
-  GET_ELEMENT_SIZE: 'getElementSize',
   GET_ELEMENT_ATTRIBUTE: 'getElementAttribute',
+  GET_DOM_ATTRIBUTE: 'getDomAttribute',
   GET_ELEMENT_VALUE_OF_CSS_PROPERTY: 'getElementValueOfCssProperty',
   GET_ELEMENT_PROPERTY: 'getElementProperty',
 
   SCREENSHOT: 'screenshot',
   TAKE_ELEMENT_SCREENSHOT: 'takeElementScreenshot',
-  SET_SCRIPT_TIMEOUT: 'setScriptTimeout',
 
   PRINT_PAGE: 'printPage',
 
@@ -168,9 +159,13 @@ const Name = {
   GET_ALERT_TEXT: 'getAlertText',
   SET_ALERT_TEXT: 'setAlertValue',
 
+  // Shadow DOM Commands
+  GET_SHADOW_ROOT: 'getShadowRoot',
+  FIND_ELEMENT_FROM_SHADOWROOT: 'findElementFromShadowRoot',
+  FIND_ELEMENTS_FROM_SHADOWROOT: 'findElementsFromShadowRoot',
+
   GET_AVAILABLE_LOG_TYPES: 'getAvailableLogTypes',
   GET_LOG: 'getLog',
-  GET_SESSION_LOGS: 'getSessionLogs',
 
   // Non-standard commands used by the standalone Selenium server.
   UPLOAD_FILE: 'uploadFile',

package/lib/error.js

@@ -39,6 +39,16 @@ class WebDriverError extends Error {
   }
 }
 
+/**
+ * Indicates the shadow root is no longer attached to the DOM
+ */
+class DetachedShadowRootError extends WebDriverError {
+  /** @param {string=} opt_error the error message, if any. */
+  constructor(opt_error) {
+    super(opt_error)
+  }
+}
+
 /**
  * Indicates a {@linkplain ./webdriver.WebElement#click click command} could not
  * completed because the click target is obscured by other elements on the
@@ -201,6 +211,16 @@ class NoSuchElementError extends WebDriverError {
   }
 }
 
+/**
+ * A ShadowRoot could not be located on the element
+ */
+class NoSuchShadowRootError extends WebDriverError {
+  /** @param {string=} opt_error the error message, if any. */
+  constructor(opt_error) {
+    super(opt_error)
+  }
+}
+
 /**
  * A request to switch to a frame could not be satisfied because the frame
  * could not be found.
@@ -420,6 +440,7 @@ const LEGACY_ERROR_CODE_TO_TYPE = new Map([
 
 const ERROR_CODE_TO_TYPE = new Map([
   ['unknown error', WebDriverError],
+  ['detached shadow root', DetachedShadowRootError],
   ['element click intercepted', ElementClickInterceptedError],
   ['element not interactable', ElementNotInteractableError],
   ['element not selectable', ElementNotSelectableError],
@@ -436,6 +457,7 @@ const ERROR_CODE_TO_TYPE = new Map([
   ['no such cookie', NoSuchCookieError],
   ['no such element', NoSuchElementError],
   ['no such frame', NoSuchFrameError],
+  ['no such shadow root', NoSuchShadowRootError],
   ['no such window', NoSuchWindowError],
   ['script timeout', ScriptTimeoutError],
   ['session not created', SessionNotCreatedError],
@@ -473,23 +495,6 @@ function encodeError(err) {
   return { error: code, message: message }
 }
 
-/**
- * Checks a response object from a server that adheres to the W3C WebDriver
- * protocol.
- * @param {*} data The response data to check.
- * @return {*} The response data if it was not an encoded error.
- * @throws {WebDriverError} the decoded error, if present in the data object.
- * @deprecated Use {@link #throwDecodedError(data)} instead.
- * @see https://w3c.github.io/webdriver/webdriver-spec.html#protocol
- */
-function checkResponse(data) {
-  if (data && typeof data.error === 'string') {
-    let ctor = ERROR_CODE_TO_TYPE.get(data.error) || WebDriverError
-    throw new ctor(data.message)
-  }
-  return data
-}
-
 /**
  * Tests if the given value is a valid error response object according to the
  * W3C WebDriver spec.
@@ -569,6 +574,7 @@ module.exports = {
   ErrorCode,
 
   WebDriverError,
+  DetachedShadowRootError,
   ElementClickInterceptedError,
   ElementNotInteractableError,
   ElementNotSelectableError,
@@ -584,6 +590,7 @@ module.exports = {
   NoSuchCookieError,
   NoSuchElementError,
   NoSuchFrameError,
+  NoSuchShadowRootError,
   NoSuchSessionError,
   NoSuchWindowError,
   ScriptTimeoutError,
@@ -596,8 +603,6 @@ module.exports = {
   UnknownCommandError,
   UnknownMethodError,
   UnsupportedOperationError,
-
-  checkResponse,
   checkLegacyResponse,
   encodeError,
   isErrorResponse,