@appium/base-driver 9.17.0 → 10.0.0-beta.1

package/build/lib/protocol/errors.js

@@ -5,55 +5,48 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.errors = exports.ProxyRequestError = exports.BadParametersError = exports.UnableToCaptureScreen = exports.NotImplementedError = exports.NotYetImplementedError = exports.InvalidContextError = exports.NoSuchContextError = exports.MoveTargetOutOfBoundsError = exports.SessionNotCreatedError = exports.InvalidSelectorError = exports.IMEEngineActivationFailedError = exports.IMENotAvailableError = exports.InvalidCoordinatesError = exports.InvalidElementCoordinatesError = exports.ScriptTimeoutError = exports.NoSuchAlertError = exports.NoAlertOpenError = exports.UnexpectedAlertOpenError = exports.UnableToSetCookieError = exports.NoSuchCookieError = exports.InvalidCookieDomainError = exports.InvalidArgumentError = exports.NoSuchWindowError = exports.TimeoutError = exports.XPathLookupError = exports.JavaScriptError = exports.InsecureCertificateError = exports.ElementNotInteractableError = exports.ElementClickInterceptedError = exports.ElementIsNotSelectableError = exports.UnsupportedOperationError = exports.UnknownMethodError = exports.UnknownError = exports.InvalidElementStateError = exports.ElementNotVisibleError = exports.StaleElementReferenceError = exports.UnknownCommandError = exports.NoSuchFrameError = exports.NoSuchElementError = exports.NoSuchDriverError = exports.ProtocolError = void 0;
 exports.isErrorType = isErrorType;
-exports.isUnknownError = isUnknownError;
 exports.errorFromMJSONWPStatusCode = errorFromMJSONWPStatusCode;
 exports.errorFromW3CJsonCode = errorFromW3CJsonCode;
 exports.getResponseForW3CError = getResponseForW3CError;
-exports.getResponseForJsonwpError = getResponseForJsonwpError;
 const lodash_1 = __importDefault(require("lodash"));
 const support_1 = require("@appium/support");
 const http_status_codes_1 = require("http-status-codes");
 const mjsonwpLog = support_1.logger.getLogger('MJSONWP');
 const w3cLog = support_1.logger.getLogger('W3C');
-const W3C_UNKNOWN_ERROR = 'unknown error';
 class BaseError extends Error {
-    constructor(message = '') {
+    constructor(message = '', cause) {
         super(message);
-        /** @type {[string, () => any][]} */
-        const propsMap = [
-            ['message', () => message],
-            ['name', () => this.constructor.name],
-            ['stack', () => (new Error(message)).stack],
-        ];
+        this.cause = cause;
+        this.message = message;
+        this.name = this.constructor.name;
+        this._formatStack();
+    }
+    _formatStack() {
         // eslint-disable-next-line no-prototype-builtins
-        const shouldSkipStack = Error.hasOwnProperty('captureStackTrace');
-        for (const [propName, valueGetter] of propsMap) {
-            if (propName === 'stack' && shouldSkipStack) {
-                continue;
-            }
-            Object.defineProperty(this, propName, {
-                configurable: true,
-                enumerable: false,
-                value: valueGetter(),
-                writable: true,
-            });
-        }
-        if (shouldSkipStack) {
+        if (Error.hasOwnProperty('captureStackTrace') && lodash_1.default.isEmpty(this.stack)) {
             Error.captureStackTrace(this, this.constructor);
         }
+        if (!lodash_1.default.isString(this.cause?.stack)) {
+            return;
+        }
+        if (lodash_1.default.isEmpty(this.stack)) {
+            this.stack = this.cause.stack;
+            return;
+        }
+        const stackLines = this.stack?.split('\n') ?? [];
+        stackLines.push('The above error is caused by');
+        stackLines.push(...this.cause.stack.split('\n'));
+        this.stack = stackLines.join('\n');
     }
 }
 // base error class for all of our errors
 class ProtocolError extends BaseError {
-    constructor(msg, jsonwpCode, w3cStatus, error) {
-        super(msg);
-        this.jsonwpCode = jsonwpCode;
-        this.error = error || W3C_UNKNOWN_ERROR;
-        if (this.jsonwpCode === null) {
-            this.jsonwpCode = 13;
-        }
-        this.w3cStatus = w3cStatus || http_status_codes_1.StatusCodes.BAD_REQUEST;
-        this._stacktrace = null;
+    constructor(msg, jsonwpCode, w3cStatus, w3cErrorSignature, cause) {
+        super(msg, cause);
+        this.jsonwpCode = jsonwpCode ?? UnknownError.code();
+        this.error = w3cErrorSignature ?? UnknownError.error();
+        this.w3cStatus = w3cStatus ?? UnknownError.w3cStatus();
+        this._stacktrace = undefined;
     }
     get stacktrace() {
         return this._stacktrace || this.stack;
@@ -63,14 +56,14 @@ class ProtocolError extends BaseError {
     }
     /**
      * Get the Bidi protocol version of an error
-     * @param {string|number} id - the id used in the request for which this error forms the response
+     * @param id - the id used in the request for which this error forms the response
      * @see https://w3c.github.io/webdriver-bidi/#protocol-definition
-     * @returns {import('@appium/types').ErrorBiDiCommandResponse} The object conforming to the shape of a BiDi error response
+     * @returns The object conforming to the shape of a BiDi error response
      */
     bidiErrObject(id) {
         // if we don't have an id, the client didn't send one, so we have nothing to send back.
         // send back zero rather than making something up
-        const intId = /** @type {number} */ (lodash_1.default.isInteger(id) ? id : (parseInt(`${id}`, 10) || 0));
+        const intId = (lodash_1.default.isInteger(id) ? id : (parseInt(`${id}`, 10) || 0));
         return {
             id: intId,
             type: 'error',
@@ -95,11 +88,8 @@ class NoSuchDriverError extends ProtocolError {
     static error() {
         return 'invalid session id';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'A session is either terminated or not started', NoSuchDriverError.code(), NoSuchDriverError.w3cStatus(), NoSuchDriverError.error());
+    constructor(message = '', cause) {
+        super(message || 'A session is either terminated or not started', NoSuchDriverError.code(), NoSuchDriverError.w3cStatus(), NoSuchDriverError.error(), cause);
     }
 }
 exports.NoSuchDriverError = NoSuchDriverError;
@@ -113,12 +103,9 @@ class NoSuchElementError extends ProtocolError {
     static error() {
         return 'no such element';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
-            'An element could not be located on the page using the given ' + 'search parameters.', NoSuchElementError.code(), NoSuchElementError.w3cStatus(), NoSuchElementError.error());
+            'An element could not be located on the page using the given ' + 'search parameters.', NoSuchElementError.code(), NoSuchElementError.w3cStatus(), NoSuchElementError.error(), cause);
     }
 }
 exports.NoSuchElementError = NoSuchElementError;
@@ -132,14 +119,10 @@ class NoSuchFrameError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.NOT_FOUND;
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'A request to switch to a frame could not be satisfied because ' +
-                'the frame could not be found.', NoSuchFrameError.code(), NoSuchFrameError.w3cStatus(), NoSuchFrameError.error());
+                'the frame could not be found.', NoSuchFrameError.code(), NoSuchFrameError.w3cStatus(), NoSuchFrameError.error(), cause);
     }
 }
 exports.NoSuchFrameError = NoSuchFrameError;
@@ -153,15 +136,11 @@ class UnknownCommandError extends ProtocolError {
     static error() {
         return 'unknown command';
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'The requested resource could not be found, or a request was ' +
                 'received using an HTTP method that is not supported by the mapped ' +
-                'resource.', UnknownCommandError.code(), UnknownCommandError.w3cStatus(), UnknownCommandError.error());
+                'resource.', UnknownCommandError.code(), UnknownCommandError.w3cStatus(), UnknownCommandError.error(), cause);
     }
 }
 exports.UnknownCommandError = UnknownCommandError;
@@ -175,14 +154,10 @@ class StaleElementReferenceError extends ProtocolError {
     static error() {
         return 'stale element reference';
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'An element command failed because the referenced element is no ' +
-                'longer attached to the DOM.', StaleElementReferenceError.code(), StaleElementReferenceError.w3cStatus(), StaleElementReferenceError.error());
+                'longer attached to the DOM.', StaleElementReferenceError.code(), StaleElementReferenceError.w3cStatus(), StaleElementReferenceError.error(), cause);
     }
 }
 exports.StaleElementReferenceError = StaleElementReferenceError;
@@ -196,13 +171,10 @@ class ElementNotVisibleError extends ProtocolError {
     static error() {
         return 'element not visible';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'An element command could not be completed because the element is ' +
-                'not visible on the page.', ElementNotVisibleError.code(), ElementNotVisibleError.w3cStatus(), ElementNotVisibleError.error());
+                'not visible on the page.', ElementNotVisibleError.code(), ElementNotVisibleError.w3cStatus(), ElementNotVisibleError.error(), cause);
     }
 }
 exports.ElementNotVisibleError = ElementNotVisibleError;
@@ -216,14 +188,10 @@ class InvalidElementStateError extends ProtocolError {
     static error() {
         return 'invalid element state';
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'An element command could not be completed because the element is ' +
-                'in an invalid state (e.g. attempting to click a disabled element).', InvalidElementStateError.code(), InvalidElementStateError.w3cStatus(), InvalidElementStateError.error());
+                'in an invalid state (e.g. attempting to click a disabled element).', InvalidElementStateError.code(), InvalidElementStateError.w3cStatus(), InvalidElementStateError.error(), cause);
     }
 }
 exports.InvalidElementStateError = InvalidElementStateError;
@@ -235,15 +203,10 @@ class UnknownError extends ProtocolError {
         return http_status_codes_1.StatusCodes.INTERNAL_SERVER_ERROR;
     }
     static error() {
-        return W3C_UNKNOWN_ERROR;
+        return 'unknown error';
     }
-    constructor(errorOrMessage) {
-        const origMessage = lodash_1.default.isString((errorOrMessage || {}).message)
-            ? errorOrMessage.message
-            : errorOrMessage;
-        const message = 'An unknown server-side error occurred while processing the command.' +
-            (origMessage ? ` Original error: ${origMessage}` : '');
-        super(message, UnknownError.code(), UnknownError.w3cStatus(), UnknownError.error());
+    constructor(message = '', cause) {
+        super(message || 'An unknown server-side error occurred while processing the command.', UnknownError.code(), UnknownError.w3cStatus(), UnknownError.error(), cause);
     }
 }
 exports.UnknownError = UnknownError;
@@ -257,12 +220,9 @@ class UnknownMethodError extends ProtocolError {
     static error() {
         return 'unknown method';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
-            'The requested command matched a known URL but did not match an method for that URL', UnknownMethodError.code(), UnknownMethodError.w3cStatus(), UnknownMethodError.error());
+            'The requested command matched a known URL but did not match an method for that URL', UnknownMethodError.code(), UnknownMethodError.w3cStatus(), UnknownMethodError.error(), cause);
     }
 }
 exports.UnknownMethodError = UnknownMethodError;
@@ -276,11 +236,8 @@ class UnsupportedOperationError extends ProtocolError {
     static error() {
         return 'unsupported operation';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'A server-side error occurred. Command cannot be supported.', UnsupportedOperationError.code(), UnsupportedOperationError.w3cStatus(), UnsupportedOperationError.error());
+    constructor(message = '', cause) {
+        super(message || 'A server-side error occurred. Command cannot be supported.', UnsupportedOperationError.code(), UnsupportedOperationError.w3cStatus(), UnsupportedOperationError.error(), cause);
     }
 }
 exports.UnsupportedOperationError = UnsupportedOperationError;
@@ -294,11 +251,8 @@ class ElementIsNotSelectableError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.BAD_REQUEST;
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'An attempt was made to select an element that cannot be selected.', ElementIsNotSelectableError.code(), ElementIsNotSelectableError.w3cStatus(), ElementIsNotSelectableError.error());
+    constructor(message = '', cause) {
+        super(message || 'An attempt was made to select an element that cannot be selected.', ElementIsNotSelectableError.code(), ElementIsNotSelectableError.w3cStatus(), ElementIsNotSelectableError.error(), cause);
     }
 }
 exports.ElementIsNotSelectableError = ElementIsNotSelectableError;
@@ -312,13 +266,10 @@ class ElementClickInterceptedError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.BAD_REQUEST;
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'The Element Click command could not be completed because the element receiving ' +
-                'the events is obscuring the element that was requested clicked', ElementClickInterceptedError.code(), ElementClickInterceptedError.w3cStatus(), ElementClickInterceptedError.error());
+                'the events is obscuring the element that was requested clicked', ElementClickInterceptedError.code(), ElementClickInterceptedError.w3cStatus(), ElementClickInterceptedError.error(), cause);
     }
 }
 exports.ElementClickInterceptedError = ElementClickInterceptedError;
@@ -332,12 +283,9 @@ class ElementNotInteractableError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.BAD_REQUEST;
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
-            'A command could not be completed because the element is not pointer- or keyboard interactable', ElementNotInteractableError.code(), ElementNotInteractableError.w3cStatus(), ElementNotInteractableError.error());
+            'A command could not be completed because the element is not pointer- or keyboard interactable', ElementNotInteractableError.code(), ElementNotInteractableError.w3cStatus(), ElementNotInteractableError.error(), cause);
     }
 }
 exports.ElementNotInteractableError = ElementNotInteractableError;
@@ -345,12 +293,12 @@ class InsecureCertificateError extends ProtocolError {
     static error() {
         return 'insecure certificate';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    static w3cStatus() {
+        return http_status_codes_1.StatusCodes.BAD_REQUEST;
+    }
+    constructor(message = '', cause) {
         super(message ||
-            'Navigation caused the user agent to hit a certificate warning, which is usually the result of an expired or invalid TLS certificate', ElementIsNotSelectableError.code(), null, InsecureCertificateError.error());
+            'Navigation caused the user agent to hit a certificate warning, which is usually the result of an expired or invalid TLS certificate', UnknownError.code(), InsecureCertificateError.w3cStatus(), InsecureCertificateError.error(), cause);
     }
 }
 exports.InsecureCertificateError = InsecureCertificateError;
@@ -364,11 +312,8 @@ class JavaScriptError extends ProtocolError {
     static error() {
         return 'javascript error';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'An error occurred while executing user supplied JavaScript.', JavaScriptError.code(), JavaScriptError.w3cStatus(), JavaScriptError.error());
+    constructor(message = '', cause) {
+        super(message || 'An error occurred while executing user supplied JavaScript.', JavaScriptError.code(), JavaScriptError.w3cStatus(), JavaScriptError.error(), cause);
     }
 }
 exports.JavaScriptError = JavaScriptError;
@@ -382,11 +327,8 @@ class XPathLookupError extends ProtocolError {
     static error() {
         return 'invalid selector';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'An error occurred while searching for an element by XPath.', XPathLookupError.code(), XPathLookupError.w3cStatus(), XPathLookupError.error());
+    constructor(message = '', cause) {
+        super(message || 'An error occurred while searching for an element by XPath.', XPathLookupError.code(), XPathLookupError.w3cStatus(), XPathLookupError.error(), cause);
     }
 }
 exports.XPathLookupError = XPathLookupError;
@@ -400,11 +342,8 @@ class TimeoutError extends ProtocolError {
     static error() {
         return 'timeout';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'An operation did not complete before its timeout expired.', TimeoutError.code(), TimeoutError.w3cStatus(), TimeoutError.error());
+    constructor(message = '', cause) {
+        super(message || 'An operation did not complete before its timeout expired.', TimeoutError.code(), TimeoutError.w3cStatus(), TimeoutError.error(), cause);
     }
 }
 exports.TimeoutError = TimeoutError;
@@ -418,13 +357,10 @@ class NoSuchWindowError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.NOT_FOUND;
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
+    constructor(message = '', cause) {
         super(message ||
             'A request to switch to a different window could not be satisfied ' +
-                'because the window could not be found.', NoSuchWindowError.code(), NoSuchWindowError.w3cStatus(), NoSuchWindowError.error());
+                'because the window could not be found.', NoSuchWindowError.code(), NoSuchWindowError.w3cStatus(), NoSuchWindowError.error(), cause);
     }
 }
 exports.NoSuchWindowError = NoSuchWindowError;
@@ -438,11 +374,8 @@ class InvalidArgumentError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.BAD_REQUEST;
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'The arguments passed to the command are either invalid or malformed', InvalidArgumentError.code(), InvalidArgumentError.w3cStatus(), InvalidArgumentError.error());
+    constructor(message = '', cause) {
+        super(message || 'The arguments passed to the command are either invalid or malformed', InvalidArgumentError.code(), InvalidArgumentError.w3cStatus(), InvalidArgumentError.error(), cause);
     }
 }
 exports.InvalidArgumentError = InvalidArgumentError;
@@ -456,13 +389,10 @@ class InvalidCookieDomainError extends ProtocolError {
     static w3cStatus() {
         return http_status_codes_1.StatusCodes.BAD_REQUEST;
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err ||
+    constructor(message = '', cause) {
+        super(message ||
             'An illegal attempt was made to set a cookie under a different ' +
-                'domain than the current page.', InvalidCookieDomainError.code(), InvalidCookieDomainError.w3cStatus(), InvalidCookieDomainError.error());
+                'domain than the current page.', InvalidCookieDomainError.code(), InvalidCookieDomainError.w3cStatus(), InvalidCookieDomainError.error(), cause);
     }
 }
 exports.InvalidCookieDomainError = InvalidCookieDomainError;
@@ -476,12 +406,9 @@ class NoSuchCookieError extends ProtocolError {
     static error() {
         return 'no such cookie';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err ||
-            'No cookie matching the given path name was found amongst the associated cookies of the current browsing context’s active document', NoSuchCookieError.code(), NoSuchCookieError.w3cStatus(), NoSuchCookieError.error());
+    constructor(message = '', cause) {
+        super(message ||
+            'No cookie matching the given path name was found amongst the associated cookies of the current browsing context’s active document', NoSuchCookieError.code(), NoSuchCookieError.w3cStatus(), NoSuchCookieError.error(), cause);
     }
 }
 exports.NoSuchCookieError = NoSuchCookieError;
@@ -495,11 +422,8 @@ class UnableToSetCookieError extends ProtocolError {
     static error() {
         return 'unable to set cookie';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || "A request to set a cookie's value could not be satisfied.", UnableToSetCookieError.code(), UnableToSetCookieError.w3cStatus(), UnableToSetCookieError.error());
+    constructor(message = '', cause) {
+        super(message || "A request to set a cookie's value could not be satisfied.", UnableToSetCookieError.code(), UnableToSetCookieError.w3cStatus(), UnableToSetCookieError.error(), cause);
     }
 }
 exports.UnableToSetCookieError = UnableToSetCookieError;
@@ -513,11 +437,8 @@ class UnexpectedAlertOpenError extends ProtocolError {
     static error() {
         return 'unexpected alert open';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'A modal dialog was open, blocking this operation', UnexpectedAlertOpenError.code(), UnexpectedAlertOpenError.w3cStatus(), UnexpectedAlertOpenError.error());
+    constructor(message = '', cause) {
+        super(message || 'A modal dialog was open, blocking this operation', UnexpectedAlertOpenError.code(), UnexpectedAlertOpenError.w3cStatus(), UnexpectedAlertOpenError.error(), cause);
     }
 }
 exports.UnexpectedAlertOpenError = UnexpectedAlertOpenError;
@@ -531,12 +452,8 @@ class NoAlertOpenError extends ProtocolError {
     static error() {
         return 'no such alert';
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
-        super(message || 'An attempt was made to operate on a modal dialog when one ' + 'was not open.', NoAlertOpenError.code(), NoAlertOpenError.w3cStatus(), NoAlertOpenError.error());
+    constructor(message = '', cause) {
+        super(message || 'An attempt was made to operate on a modal dialog when one was not open.', NoAlertOpenError.code(), NoAlertOpenError.w3cStatus(), NoAlertOpenError.error(), cause);
     }
 }
 exports.NoAlertOpenError = NoAlertOpenError;
@@ -553,11 +470,8 @@ class ScriptTimeoutError extends ProtocolError {
     static error() {
         return 'script timeout';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'A script did not complete before its timeout expired.', ScriptTimeoutError.code(), ScriptTimeoutError.w3cStatus(), ScriptTimeoutError.error());
+    constructor(message = '', cause) {
+        super(message || 'A script did not complete before its timeout expired.', ScriptTimeoutError.code(), ScriptTimeoutError.w3cStatus(), ScriptTimeoutError.error(), cause);
     }
 }
 exports.ScriptTimeoutError = ScriptTimeoutError;
@@ -571,11 +485,8 @@ class InvalidElementCoordinatesError extends ProtocolError {
     static error() {
         return 'invalid coordinates';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'The coordinates provided to an interactions operation are invalid.', InvalidElementCoordinatesError.code(), InvalidElementCoordinatesError.w3cStatus(), InvalidElementCoordinatesError.error());
+    constructor(message = '', cause) {
+        super(message || 'The coordinates provided to an interactions operation are invalid.', InvalidElementCoordinatesError.code(), InvalidElementCoordinatesError.w3cStatus(), InvalidElementCoordinatesError.error(), cause);
     }
 }
 exports.InvalidElementCoordinatesError = InvalidElementCoordinatesError;
@@ -592,11 +503,8 @@ class IMENotAvailableError extends ProtocolError {
     static error() {
         return 'unsupported operation';
     }
-    /**
-     * @param {string} [message] error message
-     */
-    constructor(message) {
-        super(message || 'IME was not available.', IMENotAvailableError.code(), IMENotAvailableError.w3cStatus(), IMENotAvailableError.error());
+    constructor(message = '', cause) {
+        super(message || 'IME was not available.', IMENotAvailableError.code(), IMENotAvailableError.w3cStatus(), IMENotAvailableError.error(), cause);
     }
 }
 exports.IMENotAvailableError = IMENotAvailableError;
@@ -610,11 +518,8 @@ class IMEEngineActivationFailedError extends ProtocolError {
     static error() {
         return 'unsupported operation';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'An IME engine could not be started.', IMEEngineActivationFailedError.code(), IMEEngineActivationFailedError.w3cStatus(), IMEEngineActivationFailedError.error());
+    constructor(message = '', cause) {
+        super(message || 'An IME engine could not be started.', IMEEngineActivationFailedError.code(), IMEEngineActivationFailedError.w3cStatus(), IMEEngineActivationFailedError.error(), cause);
     }
 }
 exports.IMEEngineActivationFailedError = IMEEngineActivationFailedError;
@@ -628,11 +533,8 @@ class InvalidSelectorError extends ProtocolError {
     static error() {
         return 'invalid selector';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'Argument was an invalid selector (e.g. XPath/CSS).', InvalidSelectorError.code(), InvalidSelectorError.w3cStatus(), InvalidSelectorError.error());
+    constructor(message = '', cause) {
+        super(message || 'Argument was an invalid selector (e.g. XPath/CSS).', InvalidSelectorError.code(), InvalidSelectorError.w3cStatus(), InvalidSelectorError.error(), cause);
     }
 }
 exports.InvalidSelectorError = InvalidSelectorError;
@@ -646,12 +548,8 @@ class SessionNotCreatedError extends ProtocolError {
     static error() {
         return 'session not created';
     }
-    constructor(details) {
-        let message = 'A new session could not be created.';
-        if (details) {
-            message += ` Details: ${details}`;
-        }
-        super(message, SessionNotCreatedError.code(), SessionNotCreatedError.w3cStatus(), SessionNotCreatedError.error());
+    constructor(message = '', cause) {
+        super(`A new session could not be created.${message ? (' Details: ' + message) : ''}`, SessionNotCreatedError.code(), SessionNotCreatedError.w3cStatus(), SessionNotCreatedError.error(), cause);
     }
 }
 exports.SessionNotCreatedError = SessionNotCreatedError;
@@ -665,11 +563,8 @@ class MoveTargetOutOfBoundsError extends ProtocolError {
     static error() {
         return 'move target out of bounds';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'Target provided for a move action is out of bounds.', MoveTargetOutOfBoundsError.code(), MoveTargetOutOfBoundsError.w3cStatus(), MoveTargetOutOfBoundsError.error());
+    constructor(message = '', cause) {
+        super(message || 'Target provided for a move action is out of bounds.', MoveTargetOutOfBoundsError.code(), MoveTargetOutOfBoundsError.w3cStatus(), MoveTargetOutOfBoundsError.error(), cause);
     }
 }
 exports.MoveTargetOutOfBoundsError = MoveTargetOutOfBoundsError;
@@ -677,12 +572,8 @@ class NoSuchContextError extends ProtocolError {
     static code() {
         return 35;
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
-        super(message || 'No such context found.', NoSuchContextError.code());
+    constructor(message = '', cause) {
+        super(message || 'No such context found.', NoSuchContextError.code(), UnknownError.w3cStatus(), UnknownError.error(), cause);
     }
 }
 exports.NoSuchContextError = NoSuchContextError;
@@ -690,31 +581,21 @@ class InvalidContextError extends ProtocolError {
     static code() {
         return 36;
     }
-    /**
-     *
-     * @param {string} [message]
-     */
-    constructor(message) {
-        super(message || 'That command could not be executed in the current context.', InvalidContextError.code());
+    constructor(message = '', cause) {
+        super(message || 'That command could not be executed in the current context.', InvalidContextError.code(), UnknownError.w3cStatus(), UnknownError.error(), cause);
     }
 }
 exports.InvalidContextError = InvalidContextError;
-// These are aliases for UnknownMethodError
+// Aliases to UnknownMethodError
 class NotYetImplementedError extends UnknownMethodError {
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'Method has not yet been implemented');
+    constructor(message = '', cause) {
+        super(message || 'Method has not yet been implemented', cause);
     }
 }
 exports.NotYetImplementedError = NotYetImplementedError;
 class NotImplementedError extends UnknownMethodError {
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'Method is not implemented');
+    constructor(message = '', cause) {
+        super(message || 'Method is not implemented', cause);
     }
 }
 exports.NotImplementedError = NotImplementedError;
@@ -728,45 +609,43 @@ class UnableToCaptureScreen extends ProtocolError {
     static error() {
         return 'unable to capture screen';
     }
-    /**
-     * @param {string} [err] error message
-     */
-    constructor(err) {
-        super(err || 'A screen capture was made impossible', UnableToCaptureScreen.code(), UnableToCaptureScreen.w3cStatus(), UnableToCaptureScreen.error());
+    constructor(message = '', cause) {
+        super(message || 'A screen capture was made impossible', UnableToCaptureScreen.code(), UnableToCaptureScreen.w3cStatus(), UnableToCaptureScreen.error(), cause);
     }
 }
 exports.UnableToCaptureScreen = UnableToCaptureScreen;
-function generateBadParametersMessage(requiredParams, actualParams) {
-    const toArray = (/** @type {any} */ x) => (lodash_1.default.isArray(x) ? x : []);
-    const requiredParamNames = toArray(requiredParams?.required);
-    const actualParamNames = toArray(actualParams);
+function generateBadParametersMessage(paramRequirements, paramNames) {
+    const toArray = function (x) {
+        if (lodash_1.default.isUndefined(x)) {
+            return [];
+        }
+        if (lodash_1.default.isArray(x)) {
+            return x;
+        }
+        return [x];
+    };
+    const requiredParamNames = toArray(paramRequirements.required);
+    const actualParamNames = toArray(paramNames);
     const missingRequiredParamNames = lodash_1.default.difference(requiredParamNames, actualParamNames);
-    /** @type {string[]} */
     const resultLines = [];
     resultLines.push(lodash_1.default.isEmpty(missingRequiredParamNames)
         ? // This should not happen
             'Some of the provided parameters are not known'
-        : `The following required parameter${missingRequiredParamNames.length === 1 ? ' is ' : 's are '}` + `missing: ${JSON.stringify(missingRequiredParamNames)}`);
+        : `The following required parameter${missingRequiredParamNames.length === 1 ? ' is' : 's are'} missing: ${JSON.stringify(missingRequiredParamNames)}`);
     if (!lodash_1.default.isEmpty(requiredParamNames)) {
         resultLines.push(`Known required parameters are: ${JSON.stringify(requiredParamNames)}`);
     }
-    const optionalParamNames = lodash_1.default.difference(toArray(requiredParams?.optional), ['sessionId', 'id']);
+    const optionalParamNames = lodash_1.default.difference(toArray(paramRequirements.optional), ['sessionId', 'id']);
     if (!lodash_1.default.isEmpty(optionalParamNames)) {
         resultLines.push(`Known optional parameters are: ${JSON.stringify(optionalParamNames)}`);
     }
-    resultLines.push(`You have provided${lodash_1.default.isEmpty(actualParamNames) ? ' none' : ': ' + JSON.stringify(actualParams)}`);
+    resultLines.push(`You have provided${lodash_1.default.isEmpty(actualParamNames) ? ' none' : ': ' + JSON.stringify(paramNames)}`);
     return resultLines.join('\n');
 }
 // Equivalent to W3C InvalidArgumentError
-class BadParametersError extends BaseError {
-    static error() {
-        return 'invalid argument';
-    }
-    constructor(requiredParams, actualParams, errMessage) {
-        super(errMessage
-            ? `Parameters were incorrect. You sent ${JSON.stringify(actualParams)}, ${errMessage}`
-            : generateBadParametersMessage(requiredParams, actualParams));
-        this.w3cStatus = http_status_codes_1.StatusCodes.BAD_REQUEST;
+class BadParametersError extends InvalidArgumentError {
+    constructor(paramReqs, paramNames) {
+        super(generateBadParametersMessage(paramReqs, paramNames));
     }
 }
 exports.BadParametersError = BadParametersError;
@@ -777,49 +656,50 @@ exports.BadParametersError = BadParametersError;
  * for proxy failure to generate the client response.
  */
 class ProxyRequestError extends BaseError {
-    constructor(err, responseError, httpStatus) {
-        let responseErrorObj = support_1.util.safeJsonParse(responseError);
-        if (!lodash_1.default.isPlainObject(responseErrorObj)) {
-            responseErrorObj = {};
-        }
-        let origMessage = lodash_1.default.isString(responseError) ? responseError : '';
-        if (!lodash_1.default.isEmpty(responseErrorObj)) {
-            if (lodash_1.default.isString(responseErrorObj.value)) {
-                origMessage = responseErrorObj.value;
-            }
-            else if (lodash_1.default.isPlainObject(responseErrorObj.value) &&
-                lodash_1.default.isString(responseErrorObj.value.message)) {
-                origMessage = responseErrorObj.value.message;
-            }
-        }
-        super(lodash_1.default.isEmpty(err) ? `Proxy request unsuccessful. ${origMessage}` : err);
-        this.w3cStatus = http_status_codes_1.StatusCodes.BAD_REQUEST;
+    constructor(message, httpResponseData, httpStatus, cause) {
+        const [responseErrorObj, originalMessage] = ProxyRequestError._parseHttpResponse(httpResponseData);
+        super(lodash_1.default.isEmpty(message)
+            ? `Proxy request unsuccessful.${originalMessage ? (' ' + originalMessage) : ''}`
+            : message, cause);
         // If the response error is an object and value is an object, it's a W3C error (for JSONWP value is a string)
         if (lodash_1.default.isPlainObject(responseErrorObj.value) && lodash_1.default.has(responseErrorObj.value, 'error')) {
-            this.w3c = responseErrorObj.value;
-            this.w3cStatus = httpStatus || http_status_codes_1.StatusCodes.BAD_REQUEST;
+            this._w3cError = responseErrorObj.value;
+            this._w3cErrorStatus = httpStatus;
         }
-        else {
-            this.jsonwp = responseErrorObj;
+        else if (lodash_1.default.has(responseErrorObj, 'status')) {
+            this._jwpError = responseErrorObj;
         }
     }
     getActualError() {
-        // If it's MJSONWP error, returns actual error cause for request failure based on `jsonwp.status`
-        if (support_1.util.hasValue(this.jsonwp?.status) && support_1.util.hasValue(this.jsonwp?.value)) {
-            return errorFromMJSONWPStatusCode(this.jsonwp.status, this.jsonwp.value);
+        if (support_1.util.hasValue(this._jwpError?.status) && support_1.util.hasValue(this._jwpError?.value)) {
+            // If it's MJSONWP error, returns actual error cause for request failure based on `jsonwp.status`
+            return errorFromMJSONWPStatusCode(this._jwpError.status, this._jwpError.value);
+        }
+        if (support_1.util.hasValue(this._w3cError) && lodash_1.default.isNumber(this._w3cErrorStatus) && this._w3cErrorStatus >= 300) {
+            return errorFromW3CJsonCode(this._w3cError.error, this._w3cError.message || this.message, this._w3cError.stacktrace || this.stack);
+        }
+        return new UnknownError(this.message, this.cause);
+    }
+    static _parseHttpResponse(data) {
+        let responseErrorObj = support_1.util.safeJsonParse(data);
+        if (!lodash_1.default.isPlainObject(responseErrorObj)) {
+            responseErrorObj = {};
+        }
+        let errorMessage = lodash_1.default.isString(data) ? data : '';
+        if (lodash_1.default.isString(responseErrorObj.value)) {
+            errorMessage = responseErrorObj.value;
         }
-        else if (support_1.util.hasValue(this.w3c) && lodash_1.default.isNumber(this.w3cStatus) && this.w3cStatus >= 300) {
-            return errorFromW3CJsonCode(this.w3c.error, this.w3c.message || this.message, this.w3c.stacktrace);
+        else if (lodash_1.default.isString(responseErrorObj.value?.message)) {
+            errorMessage = responseErrorObj.value.message;
         }
-        return new UnknownError(this.message);
+        return [responseErrorObj, errorMessage];
     }
 }
 exports.ProxyRequestError = ProxyRequestError;
 // map of error class name to error class
-const errors = {
+exports.errors = {
     NotYetImplementedError,
     NotImplementedError,
-    BadParametersError,
     InvalidArgumentError,
     NoSuchDriverError,
     NoSuchElementError,
@@ -858,178 +738,78 @@ const errors = {
     UnsupportedOperationError,
     ProxyRequestError,
 };
-exports.errors = errors;
-// map of error code to error class
-const jsonwpErrorCodeMap = {};
-for (let ErrorClass of lodash_1.default.values(errors)) {
+const jsonwpErrorCodeMap = lodash_1.default.values(exports.errors)
+    .reduce((acc, ErrorClass) => {
     if ('code' in ErrorClass) {
-        jsonwpErrorCodeMap[ErrorClass.code()] = ErrorClass;
+        acc[ErrorClass.code()] = ErrorClass;
     }
-}
-const w3cErrorCodeMap = {};
-for (let ErrorClass of lodash_1.default.values(errors)) {
+    return acc;
+}, {});
+const w3cErrorCodeMap = lodash_1.default.values(exports.errors)
+    .reduce((acc, ErrorClass) => {
     if ('error' in ErrorClass) {
-        w3cErrorCodeMap[ErrorClass.error()] = ErrorClass;
+        acc[ErrorClass.error()] = ErrorClass;
     }
-}
-function isUnknownError(err) {
-    return (!err.constructor.name ||
-        !lodash_1.default.values(errors).find(function equalNames(error) {
-            return error.name === err.constructor.name;
-        }));
-}
+    return acc;
+}, {});
 /**
  * Type guard to check if an Error is of a specific type
- * @template {Error} T
- * @param {any} err
- * @param {import('@appium/types').Class<T>} type
- * @returns {err is T}
  */
 function isErrorType(err, type) {
-    // `name` property is the constructor name
-    if (type.name === ProtocolError.name) {
-        // `jsonwpCode` is `0` on success
-        return !!err.jsonwpCode;
-    }
-    else if (type.name === ProxyRequestError.name) {
-        // `status` is `0` on success
-        if (err.jsonwp) {
-            return !!err.jsonwp.status;
-        }
-        if (lodash_1.default.isPlainObject(err.w3c)) {
-            return lodash_1.default.isNumber(err.w3cStatus) && err.w3cStatus >= 300;
-        }
-        return false;
-    }
-    return err.constructor.name === type.name;
+    return err.constructor?.name === type.name;
 }
 /**
  * Retrieve an error derived from MJSONWP status
- * @param {number} code JSONWP status code
- * @param {string|Object} value The error message, or an object with a `message` property
- * @return {ProtocolError} The error that is associated with provided JSONWP status code
+ * @param code JSONWP status code
+ * @param value The error message, or an object with a `message` property
+ * @return The error that is associated with provided JSONWP status code
  */
 function errorFromMJSONWPStatusCode(code, value = '') {
+    const ErrorClass = jsonwpErrorCodeMap[code] ?? UnknownError;
+    mjsonwpLog.debug(`Matched JSONWP error code ${code} to ${ErrorClass.name}`);
     // if `value` is an object, pull message from it, otherwise use the plain
     // value, or default to an empty string, if null
     const message = (value || {}).message || value || '';
-    if (code !== UnknownError.code() && jsonwpErrorCodeMap[code]) {
-        mjsonwpLog.debug(`Matched JSONWP error code ${code} to ${jsonwpErrorCodeMap[code].name}`);
-        return new jsonwpErrorCodeMap[code](message);
-    }
-    mjsonwpLog.debug(`Matched JSONWP error code ${code} to UnknownError`);
-    return new UnknownError(message);
+    return new ErrorClass(message);
 }
 /**
  * Retrieve an error derived from W3C JSON Code
- * @param {string} code W3C error string (see https://www.w3.org/TR/webdriver/#handling-errors `JSON Error Code` column)
- * @param {string} message the error message
- * @param {?string} stacktrace an optional error stacktrace
- * @return {ProtocolError}  The error that is associated with the W3C error string
+ * @param signature W3C error string (see https://www.w3.org/TR/webdriver/#handling-errors `JSON Error Code` column)
+ * @param message the error message
+ * @param stacktrace an optional error stacktrace
+ * @return The error that is associated with the W3C error string
  */
-function errorFromW3CJsonCode(code, message, stacktrace = null) {
-    if (code && w3cErrorCodeMap[code.toLowerCase()]) {
-        w3cLog.debug(`Matched W3C error code '${code}' to ${w3cErrorCodeMap[code.toLowerCase()].name}`);
-        const resultError = new w3cErrorCodeMap[code.toLowerCase()](message);
-        resultError.stacktrace = stacktrace;
-        return resultError;
-    }
-    w3cLog.debug(`Matched W3C error code '${code}' to UnknownError`);
-    const resultError = new UnknownError(message);
+function errorFromW3CJsonCode(signature, message, stacktrace) {
+    const ErrorClass = w3cErrorCodeMap[lodash_1.default.toLower(signature)] ?? UnknownError;
+    w3cLog.debug(`Matched W3C error code '${signature}' to ${ErrorClass.name}`);
+    const resultError = new ErrorClass(message);
     resultError.stacktrace = stacktrace;
     return resultError;
 }
-/**
- *
- * @param {any} err
- * @returns {err is ProtocolError}
- */
-function isProtocolError(err) {
-    return 'w3cStatus' in err;
-}
 /**
  * Convert an Appium error to proper W3C HTTP response
- * @param {ProtocolError|MJSONWPError} err The error that needs to be translated
+ *
+ * @param err The error that needs to be translated
  */
 function getResponseForW3CError(err) {
-    let httpStatus;
-    // W3C defined error message (https://www.w3.org/TR/webdriver/#dfn-error-code)
-    let w3cErrorString;
-    if (!isProtocolError(err)) {
-        err = support_1.util.hasValue(err.status)
-            ? // If it's a JSONWP error, find corresponding error
-                errorFromMJSONWPStatusCode(err.status, err.value)
-            : new errors.UnknownError(err.message);
-    }
-    if (isErrorType(err, errors.BadParametersError)) {
-        // respond with a 400 if we have bad parameters
-        w3cLog.debug(`Bad parameters: ${err}`);
-        w3cErrorString = BadParametersError.error();
-    }
-    else {
-        // @ts-expect-error unclear what the problem is here
-        w3cErrorString = err.error;
-    }
-    httpStatus = err.w3cStatus;
-    if (!w3cErrorString) {
-        w3cErrorString = UnknownError.error();
-    }
-    let httpResBody = {
-        value: {
-            error: w3cErrorString,
-            message: err.message,
-            stacktrace: err.stacktrace || err.stack,
-        },
-    };
-    return [httpStatus, httpResBody];
-}
-/**
- * Convert an Appium error to a proper JSONWP response
- * @param {ProtocolError} err The error to be converted
- */
-function getResponseForJsonwpError(err) {
-    if (isUnknownError(err)) {
-        err = new errors.UnknownError(err);
-    }
-    // MJSONWP errors are usually 500 status code so set it to that by default
-    let httpStatus = http_status_codes_1.StatusCodes.INTERNAL_SERVER_ERROR;
-    /** @type {HttpResultBody} */
-    let httpResBody = {
-        status: err.jsonwpCode,
-        value: {
-            message: err.message,
-        },
-    };
-    if (isErrorType(err, errors.BadParametersError)) {
-        // respond with a 400 if we have bad parameters
-        mjsonwpLog.debug(`Bad parameters: ${err}`);
-        httpStatus = http_status_codes_1.StatusCodes.BAD_REQUEST;
-        httpResBody = err.message;
-    }
-    else if (isErrorType(err, errors.NotYetImplementedError) ||
-        isErrorType(err, errors.NotImplementedError)) {
-        // respond with a 501 if the method is not implemented
-        httpStatus = http_status_codes_1.StatusCodes.NOT_IMPLEMENTED;
-    }
-    else if (isErrorType(err, errors.NoSuchDriverError)) {
-        // respond with a 404 if there is no driver for the session
-        httpStatus = http_status_codes_1.StatusCodes.NOT_FOUND;
-    }
-    return [httpStatus, httpResBody];
+    const protocolErrorToResponse = (e) => [
+        e.w3cStatus,
+        {
+            value: {
+                error: e.error,
+                message: e.message,
+                stacktrace: e.stacktrace || e.stack,
+            }
+        }
+    ];
+    // err is ProtocolError
+    if (['error', 'w3cStatus'].every((prop) => lodash_1.default.has(err, prop))) {
+        return protocolErrorToResponse(err);
+    }
+    // err is ProxyRequestError
+    if (lodash_1.default.has(err, 'getActualError') && lodash_1.default.isFunction(err.getActualError)) {
+        return protocolErrorToResponse(err.getActualError());
+    }
+    return protocolErrorToResponse(new UnknownError(err.message, err));
 }
-/**
- * @typedef { string | {value: HttpResultBodyValue, status?: number } } HttpResultBody
- */
-/**
- * @typedef HttpResultBodyValue
- * @property {string} [message]
- * @property {string|Error} [error]
- * @property {string} [stacktrace]
- */
-/**
- * @typedef MJSONWPError
- * @property {number} status
- * @property {string|object} value
- * @property {string} message
- */
 //# sourceMappingURL=errors.js.map