selenium-webdriver 4.0.0-rc-1 → 4.1.1

package/lib/webdriver.js

@@ -29,7 +29,6 @@ const input = require('./input')
 const logging = require('./logging')
 const promise = require('./promise')
 const Symbols = require('./symbols')
-const cdpTargets = ['page', 'browser']
 const cdp = require('../devtools/CDPConnection')
 const WebSocket = require('ws')
 const http = require('../http/index')
@@ -37,19 +36,21 @@ const fs = require('fs')
 const { Capabilities } = require('./capabilities')
 const path = require('path')
 const { NoSuchElementError } = require('./error')
+const cdpTargets = ['page', 'browser']
 
 // Capability names that are defined in the W3C spec.
 const W3C_CAPABILITY_NAMES = new Set([
   'acceptInsecureCerts',
   'browserName',
   'browserVersion',
-  'platformName',
   'pageLoadStrategy',
+  'platformName',
   'proxy',
   'setWindowRect',
-  'timeouts',
   'strictFileInteractability',
+  'timeouts',
   'unhandledPromptBehavior',
+  'webSocketUrl',
 ])
 
 /**
@@ -208,6 +209,9 @@ function fromWireValue(driver, value) {
   } else if (WebElement.isId(value)) {
     let id = WebElement.extractId(value)
     value = new WebElement(driver, id)
+  } else if (ShadowRoot.isId(value)) {
+    let id = ShadowRoot.extractId(value)
+    value = new ShadowRoot(driver, id)
   } else if (value && typeof value === 'object') {
     let result = {}
     for (let key in value) {
@@ -246,30 +250,30 @@ class IWebDriver {
    *     result.
    * @template T
    */
-  execute(command) { } // eslint-disable-line
+  execute(command) {} // eslint-disable-line
 
   /**
    * Sets the {@linkplain input.FileDetector file detector} that should be
    * used with this instance.
    * @param {input.FileDetector} detector The detector to use or `null`.
    */
-  setFileDetector(detector) { } // eslint-disable-line
+  setFileDetector(detector) {} // eslint-disable-line
 
   /**
    * @return {!command.Executor} The command executor used by this instance.
    */
-  getExecutor() { }
+  getExecutor() {}
 
   /**
    * @return {!Promise<!Session>} A promise for this client's session.
    */
-  getSession() { }
+  getSession() {}
 
   /**
    * @return {!Promise<!Capabilities>} A promise that will resolve with
    *     the this instance's capabilities.
    */
-  getCapabilities() { }
+  getCapabilities() {}
 
   /**
    * Terminates the browser session. After calling quit, this instance will be
@@ -279,7 +283,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when the
    *     command has completed.
    */
-  quit() { }
+  quit() {}
 
   /**
    * Creates a new action sequence using this driver. The sequence will not be
@@ -292,7 +296,7 @@ class IWebDriver {
    *     for details).
    * @return {!input.Actions} A new action sequence for this instance.
    */
-  actions(options) { } // eslint-disable-line
+  actions(options) {} // eslint-disable-line
 
   /**
    * Executes a snippet of JavaScript in the context of the currently selected
@@ -330,7 +334,7 @@ class IWebDriver {
    *    scripts return value.
    * @template T
    */
-  executeScript(script, ...args) { } // eslint-disable-line
+  executeScript(script, ...args) {} // eslint-disable-line
 
   /**
    * Executes a snippet of asynchronous JavaScript in the context of the
@@ -407,7 +411,7 @@ class IWebDriver {
    *     value.
    * @template T
    */
-  executeAsyncScript(script, ...args) { } // eslint-disable-line
+  executeAsyncScript(script, ...args) {} // eslint-disable-line
 
   /**
    * Waits for a condition to evaluate to a "truthy" value. The condition may be
@@ -458,7 +462,7 @@ class IWebDriver {
     timeout = undefined, // eslint-disable-line
     message = undefined, // eslint-disable-line
     pollTimeout = undefined // eslint-disable-line
-  ) { }
+  ) {}
 
   /**
    * Makes the driver sleep for the given amount of time.
@@ -467,7 +471,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when the sleep has
    *     finished.
    */
-  sleep(ms) { } // eslint-disable-line
+  sleep(ms) {} // eslint-disable-line
 
   /**
    * Retrieves the current window handle.
@@ -475,7 +479,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     window handle.
    */
-  getWindowHandle() { }
+  getWindowHandle() {}
 
   /**
    * Retrieves a list of all available window handles.
@@ -483,7 +487,7 @@ class IWebDriver {
    * @return {!Promise<!Array<string>>} A promise that will be resolved with an
    *     array of window handles.
    */
-  getAllWindowHandles() { }
+  getAllWindowHandles() {}
 
   /**
    * Retrieves the current page's source. The returned source is a representation
@@ -493,7 +497,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     page source.
    */
-  getPageSource() { }
+  getPageSource() {}
 
   /**
    * Closes the current window.
@@ -501,7 +505,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when this command
    *     has completed.
    */
-  close() { }
+  close() {}
 
   /**
    * Navigates to the given URL.
@@ -510,7 +514,7 @@ class IWebDriver {
    * @return {!Promise<void>} A promise that will be resolved when the document
    *     has finished loading.
    */
-  get(url) { } // eslint-disable-line
+  get(url) {} // eslint-disable-line
 
   /**
    * Retrieves the URL for the current page.
@@ -518,7 +522,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the
    *     current URL.
    */
-  getCurrentUrl() { }
+  getCurrentUrl() {}
 
   /**
    * Retrieves the current page title.
@@ -526,7 +530,7 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved with the current
    *     page's title.
    */
-  getTitle() { }
+  getTitle() {}
 
   /**
    * Locates an element on the page. If the element cannot be found, a
@@ -566,7 +570,7 @@ class IWebDriver {
    *     commands against the located element. If the element is not found, the
    *     element will be invalidated and all scheduled commands aborted.
    */
-  findElement(locator) { } // eslint-disable-line
+  findElement(locator) {} // eslint-disable-line
 
   /**
    * Search for multiple elements on the page. Refer to the documentation on
@@ -576,7 +580,7 @@ class IWebDriver {
    * @return {!Promise<!Array<!WebElement>>} A promise that will resolve to an
    *     array of WebElements.
    */
-  findElements(locator) { } // eslint-disable-line
+  findElements(locator) {} // eslint-disable-line
 
   /**
    * Takes a screenshot of the current page. The driver makes a best effort to
@@ -590,23 +594,23 @@ class IWebDriver {
    * @return {!Promise<string>} A promise that will be resolved to the
    *     screenshot as a base-64 encoded PNG.
    */
-  takeScreenshot() { }
+  takeScreenshot() {}
 
   /**
    * @return {!Options} The options interface for this instance.
    */
-  manage() { }
+  manage() {}
 
   /**
    * @return {!Navigation} The navigation interface for this instance.
    */
-  navigate() { }
+  navigate() {}
 
   /**
    * @return {!TargetLocator} The target locator interface for this
    *     instance.
    */
-  switchTo() { }
+  switchTo() {}
 
   /**
    *
@@ -625,7 +629,7 @@ class IWebDriver {
    *         shrinkToFit: (boolean|undefined)
    *         pageRanges: (<Array>|undefined)}} options.
    */
-  printPage(options) { } // eslint-disable-line
+  printPage(options) {} // eslint-disable-line
 }
 
 /**
@@ -665,7 +669,7 @@ class WebDriver {
     // If session is a rejected promise, add a no-op rejection handler.
     // This effectively hides setup errors until users attempt to interact
     // with the session.
-    this.session_.catch(function () { })
+    this.session_.catch(function () {})
 
     /** @private {!command.Executor} */
     this.executor_ = executor
@@ -761,12 +765,12 @@ class WebDriver {
       this.session_ = Promise.reject(
         new error.NoSuchSessionError(
           'This driver instance does not have a valid session ID ' +
-          '(did you call WebDriver.quit()?) and may no longer be used.'
+            '(did you call WebDriver.quit()?) and may no longer be used.'
         )
       )
 
       // Only want the session rejection to bubble if accessed.
-      this.session_.catch(function () { })
+      this.session_.catch(function () {})
 
       if (this.onQuit_) {
         return this.onQuit_.call(void 0)
@@ -827,15 +831,18 @@ class WebDriver {
             let timeoutMessage = resolveWaitMessage(message)
             reject(
               new error.TimeoutError(
-                `${timeoutMessage}Timed out waiting for promise to resolve after ${Date.now() - start
+                `${timeoutMessage}Timed out waiting for promise to resolve after ${
+                  Date.now() - start
                 }ms`
               )
             )
           } catch (ex) {
             reject(
               new error.TimeoutError(
-                `${ex.message
-                }\nTimed out waiting for promise to resolve after ${Date.now() - start
+                `${
+                  ex.message
+                }\nTimed out waiting for promise to resolve after ${
+                  Date.now() - start
                 }ms`
               )
             )
@@ -865,7 +872,7 @@ class WebDriver {
     if (typeof fn !== 'function') {
       throw TypeError(
         'Wait condition must be a promise-like object, function, or a ' +
-        'Condition object'
+          'Condition object'
       )
     }
 
@@ -917,7 +924,7 @@ class WebDriver {
           if (!(value instanceof WebElement)) {
             throw TypeError(
               'WebElementCondition did not resolve to a WebElement: ' +
-              Object.prototype.toString.call(value)
+                Object.prototype.toString.call(value)
             )
           }
           return value
@@ -1198,19 +1205,43 @@ class WebDriver {
       caps['map_'].get('moz:debuggerAddress') ||
       new Map()
     const debuggerUrl = seCdp || vendorInfo['debuggerAddress'] || vendorInfo
-    this._wsUrl = await this.getWsUrl(debuggerUrl, target)
-
+    this._wsUrl = await this.getWsUrl(debuggerUrl, target, caps)
     return new Promise((resolve, reject) => {
       try {
         this._wsConnection = new WebSocket(this._wsUrl)
+        this._cdpConnection = new cdp.CdpConnection(this._wsConnection)
       } catch (err) {
         reject(err)
         return
       }
 
-      this._wsConnection.on('open', () => {
-        this._cdpConnection = new cdp.CdpConnection(this._wsConnection)
-        resolve(this._cdpConnection)
+      this._wsConnection.on('open', async () => {
+        await this.getCdpTargets()
+      })
+
+      this._wsConnection.on('message', async (message) => {
+        const params = JSON.parse(message)
+        if (params.result) {
+          if (params.result.targetInfos) {
+            const targets = params.result.targetInfos
+            const page = targets.find((info) => info.type === 'page')
+            if (page) {
+              this.targetID = page.targetId
+              this._cdpConnection.execute(
+                'Target.attachToTarget',
+                { targetId: this.targetID, flatten: true },
+                null
+              )
+            } else {
+              reject('Unable to find Page target.')
+            }
+          }
+          if (params.result.sessionId) {
+            this.sessionId = params.result.sessionId
+            this._cdpConnection.sessionId = this.sessionId
+            resolve(this._cdpConnection)
+          }
+        }
       })
 
       this._wsConnection.on('error', (error) => {
@@ -1219,33 +1250,47 @@ class WebDriver {
     })
   }
 
+  async getCdpTargets() {
+    this._cdpConnection.execute('Target.getTargets')
+  }
+
   /**
    * Retrieves 'webSocketDebuggerUrl' by sending a http request using debugger address
    * @param {string} debuggerAddress
-   * @param {string} target
+   * @param target
+   * @param caps
    * @return {string} Returns parsed webSocketDebuggerUrl obtained from the http request
    */
-  async getWsUrl(debuggerAddress, target) {
+  async getWsUrl(debuggerAddress, target, caps) {
     if (target && cdpTargets.indexOf(target.toLowerCase()) === -1) {
       throw new error.InvalidArgumentError('invalid target value')
     }
+
+    if (debuggerAddress.match(/\/se\/cdp/)) {
+      return debuggerAddress
+    }
+
     let path
-    if (target === 'page') {
+    if (target === 'page' && caps['map_'].get('browserName') !== 'firefox') {
       path = '/json'
+    } else if (
+      target === 'page' &&
+      caps['map_'].get('browserName') === 'firefox'
+    ) {
+      path = '/json/list'
     } else {
       path = '/json/version'
     }
+
     let request = new http.Request('GET', path)
     let client = new http.HttpClient('http://' + debuggerAddress)
     let response = await client.send(request)
-    let url
+
     if (target.toLowerCase() === 'page') {
-      url = JSON.parse(response.body)[0]['webSocketDebuggerUrl']
+      return JSON.parse(response.body)[0]['webSocketDebuggerUrl']
     } else {
-      url = JSON.parse(response.body)['webSocketDebuggerUrl']
+      return JSON.parse(response.body)['webSocketDebuggerUrl']
     }
-
-    return url
   }
 
   /**
@@ -1257,54 +1302,81 @@ class WebDriver {
    * @param connection CDP Connection
    */
   async register(username, password, connection) {
+    this._wsConnection.on('message', (message) => {
+      const params = JSON.parse(message)
+
+      if (params.method === 'Fetch.authRequired') {
+        const requestParams = params['params']
+        connection.execute('Fetch.continueWithAuth', {
+          requestId: requestParams['requestId'],
+          authChallengeResponse: {
+            response: 'ProvideCredentials',
+            username: username,
+            password: password,
+          },
+        })
+      } else if (params.method === 'Fetch.requestPaused') {
+        const requestPausedParams = params['params']
+        connection.execute('Fetch.continueRequest', {
+          requestId: requestPausedParams['requestId'],
+        })
+      }
+    })
+
+    await connection.execute(
+      'Fetch.enable',
+      {
+        handleAuthRequests: true,
+      },
+      null
+    )
     await connection.execute(
       'Network.setCacheDisabled',
-      this.getRandomNumber(1, 10),
       {
         cacheDisabled: true,
       },
       null
     )
+  }
 
+  /**
+   * Handle Network interception requests
+   * @param connection WebSocket connection to the browser
+   * @param httpResponse Object representing what we are intercepting
+   *                     as well as what should be returned.
+   * @param callback callback called when we intercept requests.
+   */
+  async onIntercept(connection, httpResponse, callback) {
     this._wsConnection.on('message', (message) => {
       const params = JSON.parse(message)
-
-      if (params.method === 'Fetch.authRequired') {
-        const requestParams = params['params']
-        connection.execute(
-          'Fetch.continueWithAuth',
-          this.getRandomNumber(1, 10),
-          {
-            requestId: requestParams['requestId'],
-            authChallengeResponse: {
-              response: 'ProvideCredentials',
-              username: username,
-              password: password,
-            },
-          }
-        )
-      } else if (params.method === 'Fetch.requestPaused') {
+      if (params.method === 'Fetch.requestPaused') {
         const requestPausedParams = params['params']
-        connection.execute(
-          'Fetch.continueRequest',
-          this.getRandomNumber(1, 10),
-          {
+        if (requestPausedParams.request.url == httpResponse.urlToIntercept) {
+          connection.execute('Fetch.continueRequest', {
             requestId: requestPausedParams['requestId'],
-          }
-        )
+            url: httpResponse.urlToIntercept,
+            method: httpResponse.method,
+            headers: httpResponse.headers,
+            postData: httpResponse.body,
+          })
+          callback()
+        } else {
+          connection.execute('Fetch.continueRequest', {
+            requestId: requestPausedParams['requestId'],
+          })
+        }
       }
     })
 
+    await connection.execute('Fetch.enable', {}, null)
     await connection.execute(
-      'Fetch.enable',
-      1,
+      'Network.setCacheDisabled',
       {
-        handleAuthRequests: true,
+        cacheDisabled: true,
       },
       null
     )
   }
-
   /**
    *
    * @param connection
@@ -1312,16 +1384,8 @@ class WebDriver {
    * @returns {Promise<void>}
    */
   async onLogEvent(connection, callback) {
-    await connection.execute(
-      'Runtime.enable',
-      this.getRandomNumber(1, 10),
-      {},
-      null
-    )
-
     this._wsConnection.on('message', (message) => {
       const params = JSON.parse(message)
-
       if (params.method === 'Runtime.consoleAPICalled') {
         const consoleEventParams = params['params']
         let event = {
@@ -1332,7 +1396,20 @@ class WebDriver {
 
         callback(event)
       }
+
+      if (params.method === 'Log.entryAdded') {
+        const logEventParams = params['params']
+        const logEntry = logEventParams['entry']
+        let event = {
+          level: logEntry['level'],
+          timestamp: new Date(logEntry['timestamp']),
+          message: logEntry['text'],
+        }
+
+        callback(event)
+      }
     })
+    await connection.execute('Runtime.enable', {}, null)
   }
 
   /**
@@ -1342,12 +1419,7 @@ class WebDriver {
    * @returns {Promise<void>}
    */
   async onLogException(connection, callback) {
-    await connection.execute(
-      'Runtime.enable',
-      this.getRandomNumber(1, 10),
-      {},
-      null
-    )
+    await connection.execute('Runtime.enable', {}, null)
 
     this._wsConnection.on('message', (message) => {
       const params = JSON.parse(message)
@@ -1370,22 +1442,11 @@ class WebDriver {
    * @returns {Promise<void>}
    */
   async logMutationEvents(connection, callback) {
-    await connection.execute(
-      'Runtime.enable',
-      this.getRandomNumber(1, 10),
-      {},
-      null
-    )
-    await connection.execute(
-      'Page.enable',
-      this.getRandomNumber(1, 10),
-      {},
-      null
-    )
+    await connection.execute('Runtime.enable', {}, null)
+    await connection.execute('Page.enable', {}, null)
 
     await connection.execute(
       'Runtime.addBinding',
-      this.getRandomNumber(1, 10),
       {
         name: '__webdriver_attribute',
       },
@@ -1415,7 +1476,6 @@ class WebDriver {
 
     await connection.execute(
       'Page.addScriptToEvaluateOnNewDocument',
-      this.getRandomNumber(1, 10),
       {
         source: mutationListener,
       },
@@ -1427,7 +1487,7 @@ class WebDriver {
       if (params.method === 'Runtime.bindingCalled') {
         let payload = JSON.parse(params['params']['payload'])
         let elements = await this.findElements({
-          css: '*[data-__webdriver_id=' + payload['target'],
+          css: '*[data-__webdriver_id=' + by.escapeCss(payload['target']) + ']',
         })
 
         if (elements.length === 0) {
@@ -1444,10 +1504,6 @@ class WebDriver {
       }
     })
   }
-
-  getRandomNumber(min, max) {
-    return Math.floor(Math.random() * (max - min + 1) + min)
-  }
 }
 
 /**
@@ -1729,7 +1785,7 @@ class Options {
       } else if (typeof value !== 'undefined') {
         throw TypeError(
           'invalid timeouts configuration:' +
-          ` expected "${key}" to be a number, got ${typeof value}`
+            ` expected "${key}" to be a number, got ${typeof value}`
         )
       }
     }
@@ -1790,7 +1846,7 @@ function legacyTimeout(driver, type, ms) {
  *
  * @record
  */
-Options.Cookie = function () { }
+Options.Cookie = function () {}
 
 /**
  * The name of the cookie.
@@ -1895,21 +1951,6 @@ class Window {
         new command.Command(command.Name.GET_WINDOW_RECT)
       )
     } catch (ex) {
-      if (ex instanceof error.UnknownCommandError) {
-        let { width, height } = await this.driver_.execute(
-          new command.Command(command.Name.GET_WINDOW_SIZE).setParameter(
-            'windowHandle',
-            'current'
-          )
-        )
-        let { x, y } = await this.driver_.execute(
-          new command.Command(command.Name.GET_WINDOW_POSITION).setParameter(
-            'windowHandle',
-            'current'
-          )
-        )
-        return { x, y, width, height }
-      }
       throw ex
     }
   }
@@ -1939,26 +1980,6 @@ class Window {
         })
       )
     } catch (ex) {
-      if (ex instanceof error.UnknownCommandError) {
-        if (typeof x === 'number' && typeof y === 'number') {
-          await this.driver_.execute(
-            new command.Command(command.Name.SET_WINDOW_POSITION)
-              .setParameter('windowHandle', 'current')
-              .setParameter('x', x)
-              .setParameter('y', y)
-          )
-        }
-
-        if (typeof width === 'number' && typeof height === 'number') {
-          await this.driver_.execute(
-            new command.Command(command.Name.SET_WINDOW_SIZE)
-              .setParameter('windowHandle', 'current')
-              .setParameter('width', width)
-              .setParameter('height', height)
-          )
-        }
-        return this.getRect()
-      }
       throw ex
     }
   }
@@ -2105,7 +2126,7 @@ class TargetLocator {
    * @return {!WebElementPromise} The active element.
    */
   activeElement() {
-    var id = this.driver_.execute(
+    const id = this.driver_.execute(
       new command.Command(command.Name.GET_ACTIVE_ELEMENT)
     )
     return new WebElementPromise(this.driver_, id)
@@ -2197,7 +2218,7 @@ class TargetLocator {
    *     when the driver has changed focus to the new window.
    */
   newWindow(typeHint) {
-    var driver = this.driver_
+    const driver = this.driver_
     return this.driver_
       .execute(
         new command.Command(command.Name.SWITCH_TO_NEW_WINDOW).setParameter(
@@ -2219,10 +2240,10 @@ class TargetLocator {
    * @return {!AlertPromise} The open alert.
    */
   alert() {
-    var text = this.driver_.execute(
+    const text = this.driver_.execute(
       new command.Command(command.Name.GET_ALERT_TEXT)
     )
-    var driver = this.driver_
+    const driver = this.driver_
     return new AlertPromise(
       driver,
       text.then(function (text) {
@@ -2240,6 +2261,7 @@ class TargetLocator {
 
 const LEGACY_ELEMENT_ID_KEY = 'ELEMENT'
 const ELEMENT_ID_KEY = 'element-6066-11e4-a52e-4f735466cecf'
+const SHADOWROOT_ID_KEY = 'shadow-6066-11e4-a52e-4f735466cecf'
 
 /**
  * Represents a DOM element. WebElements can be found by searching from the
@@ -2495,18 +2517,18 @@ class WebElement {
    */
   async sendKeys(...args) {
     let keys = []
-      ; (await Promise.all(args)).forEach((key) => {
-        let type = typeof key
-        if (type === 'number') {
-          key = String(key)
-        } else if (type !== 'string') {
-          throw TypeError('each key must be a number of string; got ' + type)
-        }
+    ;(await Promise.all(args)).forEach((key) => {
+      let type = typeof key
+      if (type === 'number') {
+        key = String(key)
+      } else if (type !== 'string') {
+        throw TypeError('each key must be a number of string; got ' + type)
+      }
 
-        // The W3C protocol requires keys to be specified as an array where
-        // each element is a single key.
-        keys.push(...key.split(''))
-      })
+      // The W3C protocol requires keys to be specified as an array where
+      // each element is a single key.
+      keys.push(...key.split(''))
+    })
 
     if (!this.driver_.fileDetector_) {
       return this.execute_(
@@ -2516,10 +2538,15 @@ class WebElement {
       )
     }
 
-    keys = await this.driver_.fileDetector_.handleFile(
-      this.driver_,
-      keys.join('')
-    )
+    try {
+      keys = await this.driver_.fileDetector_.handleFile(
+        this.driver_,
+        keys.join('')
+      )
+    } catch (ex) {
+      console.log('Error trying parse string as a file with file detector; sending keys instead' + ex)
+    }
+
     return this.execute_(
       new command.Command(command.Name.SEND_KEYS_TO_ELEMENT)
         .setParameter('text', keys)
@@ -2552,7 +2579,7 @@ class WebElement {
    *     requested CSS value.
    */
   getCssValue(cssStyleProperty) {
-    var name = command.Name.GET_ELEMENT_VALUE_OF_CSS_PROPERTY
+    const name = command.Name.GET_ELEMENT_VALUE_OF_CSS_PROPERTY
     return this.execute_(
       new command.Command(name).setParameter('propertyName', cssStyleProperty)
     )
@@ -2596,6 +2623,36 @@ class WebElement {
     )
   }
 
+  /**
+   * Get the value of the given attribute of the element.
+   * <p>
+   * This method, unlike {@link #getAttribute(String)}, returns the value of the attribute with the
+   * given name but not the property with the same name.
+   * <p>
+   * The following are deemed to be "boolean" attributes, and will return either "true" or null:
+   * <p>
+   * async, autofocus, autoplay, checked, compact, complete, controls, declare, defaultchecked,
+   * defaultselected, defer, disabled, draggable, ended, formnovalidate, hidden, indeterminate,
+   * iscontenteditable, ismap, itemscope, loop, multiple, muted, nohref, noresize, noshade,
+   * novalidate, nowrap, open, paused, pubdate, readonly, required, reversed, scoped, seamless,
+   * seeking, selected, truespeed, willvalidate
+   * <p>
+   * See <a href="https://w3c.github.io/webdriver/#get-element-attribute">W3C WebDriver specification</a>
+   * for more details.
+   *
+   * @param attributeName The name of the attribute.
+   * @return The attribute's value or null if the value is not set.
+   */
+
+  getDomAttribute(attributeName) {
+    return this.execute_(
+      new command.Command(command.Name.GET_DOM_ATTRIBUTE).setParameter(
+        'name',
+        attributeName
+      )
+    )
+  }
+
   /**
    * Get the given property of the referenced web element
    * @param {string} propertyName The name of the attribute to query.
@@ -2611,6 +2668,16 @@ class WebElement {
     )
   }
 
+  /**
+   * Get the shadow root of the current web element.
+   * @returns {!Promise<ShadowRoot>} A promise that will be
+   *      resolved with the elements shadow root or rejected
+   *      with {@link NoSuchShadowRootError}
+   */
+  getShadowRoot() {
+    return this.execute_(new command.Command(command.Name.GET_SHADOW_ROOT))
+  }
+
   /**
    * Get the visible (i.e. not hidden by CSS) innerText of this element,
    * including sub-elements, without any leading or trailing whitespace.
@@ -2654,15 +2721,7 @@ class WebElement {
         new command.Command(command.Name.GET_ELEMENT_RECT)
       )
     } catch (err) {
-      if (err instanceof error.UnknownCommandError) {
-        const { width, height } = await this.execute_(
-          new command.Command(command.Name.GET_ELEMENT_SIZE)
-        )
-        const { x, y } = await this.execute_(
-          new command.Command(command.Name.GET_ELEMENT_LOCATION)
-        )
-        return { x, y, width, height }
-      }
+        throw err;
     }
   }
 
@@ -2696,7 +2755,13 @@ class WebElement {
    *     when the form has been submitted.
    */
   submit() {
-    return this.execute_(new command.Command(command.Name.SUBMIT_ELEMENT))
+    const form = this.findElement({ xpath: './ancestor-or-self::form' })
+    this.driver_.executeScript(
+      "var e = arguments[0].ownerDocument.createEvent('Event');" +
+        "e.initEvent('submit', true, true);" +
+        'if (arguments[0].dispatchEvent(e)) { arguments[0].submit() }',
+      form
+    )
   }
 
   /**
@@ -2779,6 +2844,186 @@ class WebElementPromise extends WebElement {
   }
 }
 
+//////////////////////////////////////////////////////////////////////////////
+//
+//  ShadowRoot
+//
+//////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Represents a ShadowRoot of a {@link WebElement}. Provides functions to
+ * retrieve elements that live in the DOM below the ShadowRoot.
+ */
+class ShadowRoot {
+  constructor(driver, id) {
+    this.driver_ = driver
+    this.id_ = id
+  }
+
+  /**
+   * Extracts the encoded ShadowRoot ID from the object.
+   *
+   * @param {?} obj The object to extract the ID from.
+   * @return {string} the extracted ID.
+   * @throws {TypeError} if the object is not a valid encoded ID.
+   */
+  static extractId(obj) {
+    if (obj && typeof obj === 'object') {
+      if (typeof obj[SHADOWROOT_ID_KEY] === 'string') {
+        return obj[SHADOWROOT_ID_KEY]
+      }
+    }
+    throw new TypeError('object is not a ShadowRoot ID')
+  }
+
+  /**
+   * @param {?} obj the object to test.
+   * @return {boolean} whether the object is a valid encoded WebElement ID.
+   */
+  static isId(obj) {
+    return (
+      obj &&
+      typeof obj === 'object' &&
+      typeof obj[SHADOWROOT_ID_KEY] === 'string'
+    )
+  }
+
+  /**
+   * @return {!Object} Returns the serialized representation of this ShadowRoot.
+   */
+  [Symbols.serialize]() {
+    return this.getId()
+  }
+
+  /**
+   * Schedules a command that targets this element with the parent WebDriver
+   * instance. Will ensure this element's ID is included in the command
+   * parameters under the "id" key.
+   *
+   * @param {!command.Command} command The command to schedule.
+   * @return {!Promise<T>} A promise that will be resolved with the result.
+   * @template T
+   * @see WebDriver#schedule
+   * @private
+   */
+  execute_(command) {
+    command.setParameter('id', this)
+    return this.driver_.execute(command)
+  }
+
+  /**
+   * Schedule a command to find a descendant of this ShadowROot. If the element
+   * cannot be found, the returned promise will be rejected with a
+   * {@linkplain error.NoSuchElementError NoSuchElementError}.
+   *
+   * The search criteria for an element may be defined using one of the static
+   * factories on the {@link by.By} class, or as a short-hand
+   * {@link ./by.ByHash} object. For example, the following two statements
+   * are equivalent:
+   *
+   *     var e1 = shadowroot.findElement(By.id('foo'));
+   *     var e2 = shadowroot.findElement({id:'foo'});
+   *
+   * You may also provide a custom locator function, which takes as input this
+   * instance and returns a {@link WebElement}, or a promise that will resolve
+   * to a WebElement. If the returned promise resolves to an array of
+   * WebElements, WebDriver will use the first element. For example, to find the
+   * first visible link on a page, you could write:
+   *
+   *     var link = element.findElement(firstVisibleLink);
+   *
+   *     function firstVisibleLink(shadowRoot) {
+   *       var links = shadowRoot.findElements(By.tagName('a'));
+   *       return promise.filter(links, function(link) {
+   *         return link.isDisplayed();
+   *       });
+   *     }
+   *
+   * @param {!(by.By|Function)} locator The locator strategy to use when
+   *     searching for the element.
+   * @return {!WebElementPromise} A WebElement that can be used to issue
+   *     commands against the located element. If the element is not found, the
+   *     element will be invalidated and all scheduled commands aborted.
+   */
+  findElement(locator) {
+    locator = by.checkedLocator(locator)
+    let id
+    if (typeof locator === 'function') {
+      id = this.driver_.findElementInternal_(locator, this)
+    } else {
+      let cmd = new command.Command(command.Name.FIND_ELEMENT_FROM_SHADOWROOT)
+        .setParameter('using', locator.using)
+        .setParameter('value', locator.value)
+      id = this.execute_(cmd)
+    }
+    return new ShadowRootPromise(this.driver_, id)
+  }
+
+  /**
+   * Locates all of the descendants of this element that match the given search
+   * criteria.
+   *
+   * @param {!(by.By|Function)} locator The locator strategy to use when
+   *     searching for the element.
+   * @return {!Promise<!Array<!WebElement>>} A promise that will resolve to an
+   *     array of WebElements.
+   */
+  async findElements(locator) {
+    locator = by.checkedLocator(locator)
+    if (typeof locator === 'function') {
+      return this.driver_.findElementsInternal_(locator, this)
+    } else {
+      let cmd = new command.Command(command.Name.FIND_ELEMENTS_FROM_SHADOWROOT)
+        .setParameter('using', locator.using)
+        .setParameter('value', locator.value)
+      let result = await this.execute_(cmd)
+      return Array.isArray(result) ? result : []
+    }
+  }
+
+  getId() {
+    return this.id_
+  }
+}
+
+/**
+ * ShadowRootPromise is a promise that will be fulfilled with a WebElement.
+ * This serves as a forward proxy on ShadowRoot, allowing calls to be
+ * scheduled without directly on this instance before the underlying
+ * ShadowRoot has been fulfilled.
+ *
+ * @implements { IThenable<!ShadowRoot>}
+ * @final
+ */
+class ShadowRootPromise extends ShadowRoot {
+  /**
+   * @param {!WebDriver} driver The parent WebDriver instance for this
+   *     element.
+   * @param {!Promise<!ShadowRoot>} shadow A promise
+   *     that will resolve to the promised element.
+   */
+  constructor(driver, shadow) {
+    super(driver, 'unused')
+
+    /** @override */
+    this.then = shadow.then.bind(shadow)
+
+    /** @override */
+    this.catch = shadow.catch.bind(shadow)
+
+    /**
+     * Defers returning the ShadowRoot ID until the wrapped WebElement has been
+     * resolved.
+     * @override
+     */
+    this.getId = function () {
+      return shadow.then(function (shadow) {
+        return shadow.getId()
+      })
+    }
+  }
+}
+
 //////////////////////////////////////////////////////////////////////////////
 //
 //  Alert
@@ -2936,6 +3181,7 @@ module.exports = {
   Logs,
   Navigation,
   Options,
+  ShadowRoot,
   TargetLocator,
   IWebDriver,
   WebDriver,