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

package/lib/error.js

@@ -15,7 +15,7 @@
 // specific language governing permissions and limitations
 // under the License.
 
-'use strict';
+'use strict'
 
 /**
  * The base WebDriver error type. This error type is only used directly when a
@@ -24,10 +24,10 @@
 class WebDriverError extends Error {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
 
     /** @override */
-    this.name = this.constructor.name;
+    this.name = this.constructor.name
 
     /**
      * A stacktrace reported by the remote webdriver endpoint that initially
@@ -35,11 +35,10 @@ class WebDriverError extends Error {
      * end did not provide a stacktrace.
      * @type {string}
      */
-    this.remoteStacktrace = '';
+    this.remoteStacktrace = ''
   }
 }
 
-
 /**
  * Indicates a {@linkplain ./webdriver.WebElement#click click command} could not
  * completed because the click target is obscured by other elements on the
@@ -48,22 +47,20 @@ class WebDriverError extends Error {
 class ElementClickInterceptedError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An attempt was made to select an element that cannot be selected.
  */
 class ElementNotSelectableError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Indicates a command could not be completed because the target element is
  * not pointer or keyboard interactable. This will often occur if an element
@@ -73,11 +70,10 @@ class ElementNotSelectableError extends WebDriverError {
 class ElementNotInteractableError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Indicates a navigation event caused the browser to generate a certificate
  * warning. This is usually caused by an expired or invalid TLS certificate.
@@ -85,22 +81,20 @@ class ElementNotInteractableError extends WebDriverError {
 class InsecureCertificateError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * The arguments passed to a command are either invalid or malformed.
  */
 class InvalidArgumentError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An illegal attempt was made to set a cookie under a different domain than
  * the current page.
@@ -108,22 +102,20 @@ class InvalidArgumentError extends WebDriverError {
 class InvalidCookieDomainError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * The coordinates provided to an interactions operation are invalid.
  */
 class InvalidCoordinatesError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An element command could not be completed because the element is in an
  * invalid state, e.g. attempting to click an element that is no longer attached
@@ -132,44 +124,40 @@ class InvalidCoordinatesError extends WebDriverError {
 class InvalidElementStateError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Argument was an invalid selector.
  */
 class InvalidSelectorError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Occurs when a command is directed to a session that does not exist.
  */
 class NoSuchSessionError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An error occurred while executing JavaScript supplied by the user.
  */
 class JavascriptError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * The target for mouse interaction is not in the browser’s viewport and cannot
  * be brought into that viewport.
@@ -177,22 +165,20 @@ class JavascriptError extends WebDriverError {
 class MoveTargetOutOfBoundsError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An attempt was made to operate on a modal dialog when one was not open.
  */
 class NoSuchAlertError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Indicates a named cookie could not be found in the cookie jar for the
  * currently selected document.
@@ -200,11 +186,10 @@ class NoSuchAlertError extends WebDriverError {
 class NoSuchCookieError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An element could not be located on the page using the given search
  * parameters.
@@ -212,11 +197,10 @@ class NoSuchCookieError extends WebDriverError {
 class NoSuchElementError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A request to switch to a frame could not be satisfied because the frame
  * could not be found.
@@ -224,11 +208,10 @@ class NoSuchElementError extends WebDriverError {
 class NoSuchFrameError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A request to switch to a window could not be satisfied because the window
  * could not be found.
@@ -236,34 +219,30 @@ class NoSuchFrameError extends WebDriverError {
 class NoSuchWindowError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A script did not complete before its timeout expired.
  */
 class ScriptTimeoutError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A new session could not be created.
  */
 class SessionNotCreatedError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
-
 /**
  * An element command failed because the referenced element is no longer
  * attached to the DOM.
@@ -271,44 +250,40 @@ class SessionNotCreatedError extends WebDriverError {
 class StaleElementReferenceError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * An operation did not complete before its timeout expired.
  */
 class TimeoutError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A request to set a cookie’s value could not be satisfied.
  */
 class UnableToSetCookieError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A screen capture operation was not possible.
  */
 class UnableToCaptureScreenError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * A modal dialog was open, blocking this operation.
  */
@@ -318,10 +293,10 @@ class UnexpectedAlertOpenError extends WebDriverError {
    * @param {string=} opt_text the text of the open dialog, if available.
    */
   constructor(opt_error, opt_text) {
-    super(opt_error);
+    super(opt_error)
 
     /** @private {(string|undefined)} */
-    this.text_ = opt_text;
+    this.text_ = opt_text
   }
 
   /**
@@ -329,22 +304,20 @@ class UnexpectedAlertOpenError extends WebDriverError {
    *     if available.
    */
   getAlertText() {
-    return this.text_;
+    return this.text_
   }
 }
 
-
 /**
  * A command could not be executed because the remote end is not aware of it.
  */
 class UnknownCommandError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * The requested command matched a known URL but did not match an method for
  * that URL.
@@ -352,24 +325,22 @@ class UnknownCommandError extends WebDriverError {
 class UnknownMethodError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
-
 /**
  * Reports an unsupported operation.
  */
 class UnsupportedOperationError extends WebDriverError {
   /** @param {string=} opt_error the error message, if any. */
   constructor(opt_error) {
-    super(opt_error);
+    super(opt_error)
   }
 }
 
 // TODO(jleyba): Define UnknownError as an alias of WebDriverError?
 
-
 /**
  * Enum of legacy error codes.
  * TODO: remove this when all code paths have been switched to the new error
@@ -412,100 +383,96 @@ const ErrorCode = {
   NO_SUCH_COOKIE: 62,
   UNABLE_TO_CAPTURE_SCREEN: 63,
   ELEMENT_CLICK_INTERCEPTED: 64,
-  METHOD_NOT_ALLOWED: 405
-};
-
+  METHOD_NOT_ALLOWED: 405,
+}
 
 const LEGACY_ERROR_CODE_TO_TYPE = new Map([
-    [ErrorCode.NO_SUCH_SESSION, NoSuchSessionError],
-    [ErrorCode.NO_SUCH_ELEMENT, NoSuchElementError],
-    [ErrorCode.NO_SUCH_FRAME, NoSuchFrameError],
-    [ErrorCode.UNSUPPORTED_OPERATION, UnsupportedOperationError],
-    [ErrorCode.STALE_ELEMENT_REFERENCE, StaleElementReferenceError],
-    [ErrorCode.INVALID_ELEMENT_STATE, InvalidElementStateError],
-    [ErrorCode.UNKNOWN_ERROR, WebDriverError],
-    [ErrorCode.ELEMENT_NOT_SELECTABLE, ElementNotSelectableError],
-    [ErrorCode.JAVASCRIPT_ERROR, JavascriptError],
-    [ErrorCode.XPATH_LOOKUP_ERROR, InvalidSelectorError],
-    [ErrorCode.TIMEOUT, TimeoutError],
-    [ErrorCode.NO_SUCH_WINDOW, NoSuchWindowError],
-    [ErrorCode.INVALID_COOKIE_DOMAIN, InvalidCookieDomainError],
-    [ErrorCode.UNABLE_TO_SET_COOKIE, UnableToSetCookieError],
-    [ErrorCode.UNEXPECTED_ALERT_OPEN, UnexpectedAlertOpenError],
-    [ErrorCode.NO_SUCH_ALERT, NoSuchAlertError],
-    [ErrorCode.SCRIPT_TIMEOUT, ScriptTimeoutError],
-    [ErrorCode.INVALID_ELEMENT_COORDINATES, InvalidCoordinatesError],
-    [ErrorCode.INVALID_SELECTOR_ERROR, InvalidSelectorError],
-    [ErrorCode.SESSION_NOT_CREATED, SessionNotCreatedError],
-    [ErrorCode.MOVE_TARGET_OUT_OF_BOUNDS, MoveTargetOutOfBoundsError],
-    [ErrorCode.INVALID_XPATH_SELECTOR, InvalidSelectorError],
-    [ErrorCode.INVALID_XPATH_SELECTOR_RETURN_TYPE, InvalidSelectorError],
-    [ErrorCode.ELEMENT_NOT_INTERACTABLE, ElementNotInteractableError],
-    [ErrorCode.INVALID_ARGUMENT, InvalidArgumentError],
-    [ErrorCode.NO_SUCH_COOKIE, NoSuchCookieError],
-    [ErrorCode.UNABLE_TO_CAPTURE_SCREEN, UnableToCaptureScreenError],
-    [ErrorCode.ELEMENT_CLICK_INTERCEPTED, ElementClickInterceptedError],
-    [ErrorCode.METHOD_NOT_ALLOWED, UnsupportedOperationError]]);
-
+  [ErrorCode.NO_SUCH_SESSION, NoSuchSessionError],
+  [ErrorCode.NO_SUCH_ELEMENT, NoSuchElementError],
+  [ErrorCode.NO_SUCH_FRAME, NoSuchFrameError],
+  [ErrorCode.UNSUPPORTED_OPERATION, UnsupportedOperationError],
+  [ErrorCode.STALE_ELEMENT_REFERENCE, StaleElementReferenceError],
+  [ErrorCode.INVALID_ELEMENT_STATE, InvalidElementStateError],
+  [ErrorCode.UNKNOWN_ERROR, WebDriverError],
+  [ErrorCode.ELEMENT_NOT_SELECTABLE, ElementNotSelectableError],
+  [ErrorCode.JAVASCRIPT_ERROR, JavascriptError],
+  [ErrorCode.XPATH_LOOKUP_ERROR, InvalidSelectorError],
+  [ErrorCode.TIMEOUT, TimeoutError],
+  [ErrorCode.NO_SUCH_WINDOW, NoSuchWindowError],
+  [ErrorCode.INVALID_COOKIE_DOMAIN, InvalidCookieDomainError],
+  [ErrorCode.UNABLE_TO_SET_COOKIE, UnableToSetCookieError],
+  [ErrorCode.UNEXPECTED_ALERT_OPEN, UnexpectedAlertOpenError],
+  [ErrorCode.NO_SUCH_ALERT, NoSuchAlertError],
+  [ErrorCode.SCRIPT_TIMEOUT, ScriptTimeoutError],
+  [ErrorCode.INVALID_ELEMENT_COORDINATES, InvalidCoordinatesError],
+  [ErrorCode.INVALID_SELECTOR_ERROR, InvalidSelectorError],
+  [ErrorCode.SESSION_NOT_CREATED, SessionNotCreatedError],
+  [ErrorCode.MOVE_TARGET_OUT_OF_BOUNDS, MoveTargetOutOfBoundsError],
+  [ErrorCode.INVALID_XPATH_SELECTOR, InvalidSelectorError],
+  [ErrorCode.INVALID_XPATH_SELECTOR_RETURN_TYPE, InvalidSelectorError],
+  [ErrorCode.ELEMENT_NOT_INTERACTABLE, ElementNotInteractableError],
+  [ErrorCode.INVALID_ARGUMENT, InvalidArgumentError],
+  [ErrorCode.NO_SUCH_COOKIE, NoSuchCookieError],
+  [ErrorCode.UNABLE_TO_CAPTURE_SCREEN, UnableToCaptureScreenError],
+  [ErrorCode.ELEMENT_CLICK_INTERCEPTED, ElementClickInterceptedError],
+  [ErrorCode.METHOD_NOT_ALLOWED, UnsupportedOperationError],
+])
 
 const ERROR_CODE_TO_TYPE = new Map([
-    ['unknown error', WebDriverError],
-    ['element click intercepted', ElementClickInterceptedError],
-    ['element not interactable', ElementNotInteractableError],
-    ['element not selectable', ElementNotSelectableError],
-    ['insecure certificate', InsecureCertificateError],
-    ['invalid argument', InvalidArgumentError],
-    ['invalid cookie domain', InvalidCookieDomainError],
-    ['invalid coordinates', InvalidCoordinatesError],
-    ['invalid element state', InvalidElementStateError],
-    ['invalid selector', InvalidSelectorError],
-    ['invalid session id', NoSuchSessionError],
-    ['javascript error', JavascriptError],
-    ['move target out of bounds', MoveTargetOutOfBoundsError],
-    ['no such alert', NoSuchAlertError],
-    ['no such cookie', NoSuchCookieError],
-    ['no such element', NoSuchElementError],
-    ['no such frame', NoSuchFrameError],
-    ['no such window', NoSuchWindowError],
-    ['script timeout', ScriptTimeoutError],
-    ['session not created', SessionNotCreatedError],
-    ['stale element reference', StaleElementReferenceError],
-    ['timeout', TimeoutError],
-    ['unable to set cookie', UnableToSetCookieError],
-    ['unable to capture screen', UnableToCaptureScreenError],
-    ['unexpected alert open', UnexpectedAlertOpenError],
-    ['unknown command', UnknownCommandError],
-    ['unknown method', UnknownMethodError],
-    ['unsupported operation', UnsupportedOperationError]]);
-
-
-const TYPE_TO_ERROR_CODE = new Map;
+  ['unknown error', WebDriverError],
+  ['element click intercepted', ElementClickInterceptedError],
+  ['element not interactable', ElementNotInteractableError],
+  ['element not selectable', ElementNotSelectableError],
+  ['insecure certificate', InsecureCertificateError],
+  ['invalid argument', InvalidArgumentError],
+  ['invalid cookie domain', InvalidCookieDomainError],
+  ['invalid coordinates', InvalidCoordinatesError],
+  ['invalid element state', InvalidElementStateError],
+  ['invalid selector', InvalidSelectorError],
+  ['invalid session id', NoSuchSessionError],
+  ['javascript error', JavascriptError],
+  ['move target out of bounds', MoveTargetOutOfBoundsError],
+  ['no such alert', NoSuchAlertError],
+  ['no such cookie', NoSuchCookieError],
+  ['no such element', NoSuchElementError],
+  ['no such frame', NoSuchFrameError],
+  ['no such window', NoSuchWindowError],
+  ['script timeout', ScriptTimeoutError],
+  ['session not created', SessionNotCreatedError],
+  ['stale element reference', StaleElementReferenceError],
+  ['timeout', TimeoutError],
+  ['unable to set cookie', UnableToSetCookieError],
+  ['unable to capture screen', UnableToCaptureScreenError],
+  ['unexpected alert open', UnexpectedAlertOpenError],
+  ['unknown command', UnknownCommandError],
+  ['unknown method', UnknownMethodError],
+  ['unsupported operation', UnsupportedOperationError],
+])
+
+const TYPE_TO_ERROR_CODE = new Map()
 ERROR_CODE_TO_TYPE.forEach((value, key) => {
-  TYPE_TO_ERROR_CODE.set(value, key);
-});
-
-
+  TYPE_TO_ERROR_CODE.set(value, key)
+})
 
 /**
  * @param {*} err The error to encode.
  * @return {{error: string, message: string}} the encoded error.
  */
 function encodeError(err) {
-  let type = WebDriverError;
-  if (err instanceof WebDriverError
-      && TYPE_TO_ERROR_CODE.has(err.constructor)) {
-    type = err.constructor;
+  let type = WebDriverError
+  if (
+    err instanceof WebDriverError &&
+    TYPE_TO_ERROR_CODE.has(err.constructor)
+  ) {
+    type = err.constructor
   }
 
-  let message = err instanceof Error
-      ? err.message
-      : err + '';
+  let message = err instanceof Error ? err.message : err + ''
 
-  let code = /** @type {string} */(TYPE_TO_ERROR_CODE.get(type));
-  return {'error': code, 'message': message};
+  let code = /** @type {string} */ (TYPE_TO_ERROR_CODE.get(type))
+  return { error: code, message: message }
 }
 
-
 /**
  * Checks a response object from a server that adheres to the W3C WebDriver
  * protocol.
@@ -517,10 +484,10 @@ function encodeError(err) {
  */
 function checkResponse(data) {
   if (data && typeof data.error === 'string') {
-    let ctor = ERROR_CODE_TO_TYPE.get(data.error) || WebDriverError;
-    throw new ctor(data.message);
+    let ctor = ERROR_CODE_TO_TYPE.get(data.error) || WebDriverError
+    throw new ctor(data.message)
   }
-  return data;
+  return data
 }
 
 /**
@@ -533,7 +500,7 @@ function checkResponse(data) {
  * @see https://w3c.github.io/webdriver/webdriver-spec.html#protocol
  */
 function isErrorResponse(data) {
-  return data && typeof data === 'object' && typeof data.error === 'string';
+  return data && typeof data === 'object' && typeof data.error === 'string'
 }
 
 /**
@@ -546,20 +513,19 @@ function isErrorResponse(data) {
  */
 function throwDecodedError(data) {
   if (isErrorResponse(data)) {
-    let ctor = ERROR_CODE_TO_TYPE.get(data.error) || WebDriverError;
-    let err = new ctor(data.message);
+    let ctor = ERROR_CODE_TO_TYPE.get(data.error) || WebDriverError
+    let err = new ctor(data.message)
     // TODO(jleyba): remove whichever case is excluded from the final W3C spec.
     if (typeof data.stacktrace === 'string') {
-      err.remoteStacktrace = data.stacktrace;
+      err.remoteStacktrace = data.stacktrace
     } else if (typeof data.stackTrace === 'string') {
-      err.remoteStacktrace = data.stackTrace;
+      err.remoteStacktrace = data.stackTrace
     }
-    throw err;
+    throw err
   }
-  throw new WebDriverError('Unknown error: ' + JSON.stringify(data));
+  throw new WebDriverError('Unknown error: ' + JSON.stringify(data))
 }
 
-
 /**
  * Checks a legacy response from the Selenium 2.0 wire protocol for an error.
  * @param {*} responseObj the response object to check.
@@ -568,37 +534,37 @@ function throwDecodedError(data) {
  */
 function checkLegacyResponse(responseObj) {
   // Handle the legacy Selenium error response format.
-  if (responseObj
-      && typeof responseObj === 'object'
-      && typeof responseObj['status'] === 'number'
-      && responseObj['status'] !== 0) {
-    let status = responseObj['status'];
-    let ctor = LEGACY_ERROR_CODE_TO_TYPE.get(status) || WebDriverError;
+  if (
+    responseObj &&
+    typeof responseObj === 'object' &&
+    typeof responseObj['status'] === 'number' &&
+    responseObj['status'] !== 0
+  ) {
+    let status = responseObj['status']
+    let ctor = LEGACY_ERROR_CODE_TO_TYPE.get(status) || WebDriverError
 
-    let value = responseObj['value'];
+    let value = responseObj['value']
 
     if (!value || typeof value !== 'object') {
-      throw new ctor(value + '');
+      throw new ctor(value + '')
     } else {
-      let message = value['message'] + '';
+      let message = value['message'] + ''
       if (ctor !== UnexpectedAlertOpenError) {
-        throw new ctor(message);
+        throw new ctor(message)
       }
 
-      let text = '';
+      let text = ''
       if (value['alert'] && typeof value['alert']['text'] === 'string') {
-        text = value['alert']['text'];
+        text = value['alert']['text']
       }
-      throw new UnexpectedAlertOpenError(message, text);
+      throw new UnexpectedAlertOpenError(message, text)
     }
   }
-  return responseObj;
+  return responseObj
 }
 
-
 // PUBLIC API
 
-
 module.exports = {
   ErrorCode,
 
@@ -636,4 +602,4 @@ module.exports = {
   encodeError,
   isErrorResponse,
   throwDecodedError,
-};
+}