@serenity-js/webdriverio 3.0.0-rc.8 → 3.0.0

package/lib/screenplay/models/WebdriverIOPageElement.js

@@ -1,105 +1,223 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebdriverIOPageElement = void 0;
+const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
+const scripts = __importStar(require("@serenity-js/web/lib/scripts"));
+const WebdriverProtocolErrorCode_1 = require("./WebdriverProtocolErrorCode");
+/**
+ * WebdriverIO-specific implementation of {@apilink PageElement}.
+ *
+ * @group Models
+ */
 class WebdriverIOPageElement extends web_1.PageElement {
     of(parent) {
         return new WebdriverIOPageElement(this.locator.of(parent.locator));
     }
     async clearValue() {
+        // eslint-disable-next-line unicorn/consistent-function-scoping
+        function times(length, key) {
+            return Array.from({ length }).map(() => key);
+        }
+        // eslint-disable-next-line unicorn/consistent-function-scoping
+        async function removeCharactersFrom(browser, inputElement, numberOfCharacters) {
+            const homeKey = browser.isDevTools ? web_1.Key.Home.devtoolsName : web_1.Key.Home.utf16codePoint;
+            const deleteKey = browser.isDevTools ? web_1.Key.Delete.devtoolsName : web_1.Key.Delete.utf16codePoint;
+            await browser.execute(
+            /* istanbul ignore next */
+            function focusOn(element) {
+                element.focus();
+            }, element);
+            await inputElement.keys([
+                homeKey,
+                ...times(numberOfCharacters, deleteKey),
+            ]);
+        }
         const element = await this.nativeElement();
-        return element.clearValue();
+        const value = await this.value();
+        const hasValue = value !== null && value !== undefined && value.length > 0;
+        const browser = await this.browserFor(element);
+        if (hasValue) {
+            return await removeCharactersFrom(browser, element, value.length);
+        }
+        const contentEditable = await element.getAttribute('contenteditable');
+        const hasContentEditable = contentEditable !== null && contentEditable !== undefined && contentEditable !== 'false';
+        if (hasContentEditable) {
+            const text = await element.getText();
+            return await removeCharactersFrom(browser, element, text.length);
+        }
     }
     async click() {
         const element = await this.nativeElement();
-        return element.click();
+        await element.click();
     }
     async doubleClick() {
         const element = await this.nativeElement();
-        return element.doubleClick();
+        await element.doubleClick();
     }
     async enterValue(value) {
         const element = await this.nativeElement();
-        return element.addValue(value);
+        await element.addValue(value);
     }
     async scrollIntoView() {
         const element = await this.nativeElement();
-        return element.scrollIntoView();
+        await element.scrollIntoView();
     }
     async hoverOver() {
         const element = await this.nativeElement();
-        return element.moveTo();
+        await element.moveTo();
     }
     async rightClick() {
         const element = await this.nativeElement();
-        return element.click({ button: 'right' });
+        await element.click({ button: 'right' });
+    }
+    async selectOptions(...options) {
+        const element = await this.nativeElement();
+        for (const option of options) {
+            if (option.value) {
+                await element.selectByAttribute('value', option.value);
+            }
+            else if (option.label) {
+                await element.selectByVisibleText(option.label);
+            }
+        }
+    }
+    async selectedOptions() {
+        const element = await this.nativeElement();
+        const browser = await this.browserFor(element);
+        const options = await browser.execute(
+        /* istanbul ignore next */
+        (select) => {
+            const options = [];
+            select.querySelectorAll('option').forEach((option) => {
+                options.push({
+                    selected: option.selected,
+                    disabled: option.disabled,
+                    label: option.label,
+                    value: option.value,
+                });
+            });
+            return options;
+        }, element);
+        return options.map(option => new web_1.SelectOption(option.label, option.value, option.selected, option.disabled));
     }
     async attribute(name) {
         const element = await this.nativeElement();
-        return element.getAttribute(name);
+        return await element.getAttribute(name);
     }
     async text() {
         const element = await this.nativeElement();
-        return element.getText();
+        return await element.getText();
     }
     async value() {
         const element = await this.nativeElement();
-        return element.getValue();
+        return await element.getValue();
+    }
+    async switchTo() {
+        try {
+            const element = await this.locator.nativeElement();
+            if (element.error) {
+                throw element.error;
+            }
+            const tagName = await element.getTagName();
+            const browser = await this.browserFor(element);
+            if (['iframe', 'frame'].includes(tagName)) {
+                const locator = this.locator;
+                await locator.switchToFrame(element);
+                return {
+                    switchBack: async () => {
+                        await locator.switchToParentFrame();
+                    }
+                };
+            }
+            else {
+                // focus on element
+                const previouslyFocusedElement = await browser.execute(
+                /* istanbul ignore next */
+                function focusOn(element) {
+                    const currentlyFocusedElement = document.activeElement;
+                    element.focus();
+                    return currentlyFocusedElement;
+                }, element);
+                return {
+                    switchBack: async () => {
+                        await browser.execute(
+                        /* istanbul ignore next */
+                        function focusOn(element) {
+                            element.focus();
+                        }, previouslyFocusedElement);
+                    }
+                };
+            }
+        }
+        catch (error) {
+            throw new core_1.LogicError(`Couldn't switch to page element located ${this.locator}`, error);
+        }
     }
     async isActive() {
         const element = await this.nativeElement();
-        return element.isFocused();
+        return await element.isFocused();
     }
     async isClickable() {
         const element = await this.nativeElement();
-        return element.isClickable();
+        return await element.isClickable();
     }
     async isEnabled() {
         const element = await this.nativeElement();
-        return element.isEnabled();
+        return await element.isEnabled();
     }
     async isPresent() {
         const element = await this.nativeElement();
-        return element.isExisting();
+        return await element.isExisting();
     }
     async isSelected() {
         const element = await this.nativeElement();
-        return element.isSelected();
-    }
-    /**
-     * @desc
-     *  Checks if the PageElement:
-     *  - is displayed,
-     *  - is visible within the browser viewport,
-     *  - has not its center covered by other elements
-     *
-     * @see https://webdriver.io/docs/api/element/isDisplayedInViewport/
-     */
+        return await element.isSelected();
+    }
     async isVisible() {
-        const element = await this.nativeElement();
-        if (!await element.isDisplayed()) {
-            return false;
-        }
-        if (!await element.isDisplayedInViewport()) {
-            return false;
-        }
-        const browser = await this.browserFor(element);
-        /* eslint-disable no-var */
-        // get element at cx/cy and see if the element we found is our element, and therefore it's visible.
-        return browser.execute(
-        /* istanbul ignore next */
-        function isVisible(element) {
-            if (!element.getBoundingClientRect) {
+        try {
+            const element = await this.nativeElement();
+            if (!await element.isDisplayed()) {
                 return false;
             }
-            var box = element.getBoundingClientRect(), cx = box.left + box.width / 2, cy = box.top + box.height / 2, e = document.elementFromPoint(cx, cy);
-            for (; e; e = e.parentElement) {
-                if (e === element)
-                    return true;
+            if (!await element.isDisplayedInViewport()) {
+                return false;
             }
-            return false;
-        }, element);
-        /* eslint-enable no-var */
+            const browser = await this.browserFor(element);
+            return await browser.execute(scripts.isVisible, element);
+        }
+        catch (error) {
+            // an element that doesn't exist is treated as not visible
+            if (error.name === WebdriverProtocolErrorCode_1.WebdriverProtocolErrorCode.NoSuchElementError ||
+                error.error === WebdriverProtocolErrorCode_1.WebdriverProtocolErrorCode.NoSuchElementError ||
+                /element.*not found/i.test(error.message)) {
+                return false;
+            }
+            throw error;
+        }
     }
     // based on https://github.com/webdriverio/webdriverio/blob/dec6da76b0e218af935dbf39735ae3491d5edd8c/packages/webdriverio/src/utils/index.ts#L98
     async browserFor(nativeElement) {

package/lib/screenplay/models/WebdriverIOPageElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebdriverIOPageElement.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPageElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WebdriverIOPageElement.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPageElement.ts"],"names":[],"mappings":"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"}

package/lib/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.d.ts

@@ -0,0 +1,32 @@
+import { ModalDialog, ModalDialogHandler } from '@serenity-js/web';
+import type { Page } from 'puppeteer-core/lib/cjs/puppeteer/api/Page';
+/**
+ * WebdriverIO-specific implementation of {@apilink {ModalDialogHandler}, applicable when WebdriverIO
+ * uses [Puppeteer](https://developer.chrome.com/docs/puppeteer/).
+ *
+ * Automatically handles any simple JavaScript modal dialog windows, such as
+ * those opened by [`window.alert()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/alert),
+ * [`window.confirm()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm),
+ * or [`window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt).
+ *
+ * This helps to avoid Puppeteer hanging when there's an interaction pending
+ * and a dialog is already open, see https://github.com/puppeteer/puppeteer/issues/2481
+ *
+ * ## Learn more
+ * - {@apilink WebdriverIOModalDialogHandler}
+ */
+export declare class WebdriverIOPuppeteerModalDialogHandler extends ModalDialogHandler {
+    private readonly page;
+    private dialogHandlingInProgress;
+    private readonly defaultHandler;
+    private currentHandler;
+    constructor(page: Page);
+    acceptNext(): Promise<void>;
+    acceptNextWithValue(text: string | number): Promise<void>;
+    dismissNext(): Promise<void>;
+    reset(): Promise<void>;
+    discard(): Promise<void>;
+    last(): Promise<ModalDialog>;
+    private handleModalDialog;
+}
+//# sourceMappingURL=WebdriverIOPuppeteerModalDialogHandler.d.ts.map

package/lib/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOPuppeteerModalDialogHandler.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2CAA2C,CAAC;AAGtE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sCAAuC,SAAQ,kBAAkB;IAY9D,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,OAAO,CAAC,wBAAwB,CAAS;IAEzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI1B;IAEL,OAAO,CAAC,cAAc,CAA2C;gBAEpC,IAAI,EAAE,IAAI;IAiBjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;YAWpB,iBAAiB;CAOlC"}

package/lib/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOPuppeteerModalDialogHandler = void 0;
+const web_1 = require("@serenity-js/web");
+/**
+ * WebdriverIO-specific implementation of {@apilink {ModalDialogHandler}, applicable when WebdriverIO
+ * uses [Puppeteer](https://developer.chrome.com/docs/puppeteer/).
+ *
+ * Automatically handles any simple JavaScript modal dialog windows, such as
+ * those opened by [`window.alert()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/alert),
+ * [`window.confirm()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm),
+ * or [`window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt).
+ *
+ * This helps to avoid Puppeteer hanging when there's an interaction pending
+ * and a dialog is already open, see https://github.com/puppeteer/puppeteer/issues/2481
+ *
+ * ## Learn more
+ * - {@apilink WebdriverIOModalDialogHandler}
+ */
+class WebdriverIOPuppeteerModalDialogHandler extends web_1.ModalDialogHandler {
+    constructor(page) {
+        super();
+        this.page = page;
+        this.dialogHandlingInProgress = false;
+        this.defaultHandler = async (dialog) => {
+            await dialog.dismiss();
+            return new web_1.DismissedModalDialog(dialog.message());
+        };
+        this.currentHandler = this.defaultHandler;
+        // remove the default WebdriverIO handler because it makes any other listeners hang
+        // https://github.com/webdriverio/webdriverio/blob/518c56a61353b2f65436b83c618117021da7e622/packages/devtools/src/devtoolsdriver.ts#L69
+        this.page.removeAllListeners('dialog');
+        // register Serenity/JS handler instead
+        this.page.on('dialog', async (dialog) => {
+            // Puppeteer doesn't seem to synchronise async handlers correctly,
+            // hence the handleModalDialog wrapper and the `dialogHandlingInProgress` lock.
+            await this.handleModalDialog(() => this.currentHandler(dialog));
+        });
+    }
+    async acceptNext() {
+        this.currentHandler = async (dialog) => {
+            await dialog.accept(dialog.defaultValue());
+            return new web_1.AcceptedModalDialog(dialog.message());
+        };
+    }
+    async acceptNextWithValue(text) {
+        this.currentHandler = async (dialog) => {
+            await dialog.accept(String(text));
+            return new web_1.AcceptedModalDialog(dialog.message());
+        };
+    }
+    async dismissNext() {
+        this.currentHandler = async (dialog) => {
+            await dialog.dismiss();
+            return new web_1.DismissedModalDialog(dialog.message());
+        };
+    }
+    async reset() {
+        this.modalDialog = new web_1.AbsentModalDialog();
+        this.currentHandler = this.defaultHandler;
+    }
+    async discard() {
+        this.page.off('dialog', this.currentHandler);
+    }
+    async last() {
+        return new Promise((resolve, reject) => {
+            const interval = setInterval(() => {
+                if (!this.dialogHandlingInProgress) {
+                    clearInterval(interval);
+                    resolve(this.modalDialog);
+                }
+            }, 25);
+        });
+    }
+    async handleModalDialog(handler) {
+        this.dialogHandlingInProgress = true;
+        this.modalDialog = await handler();
+        this.dialogHandlingInProgress = false;
+    }
+}
+exports.WebdriverIOPuppeteerModalDialogHandler = WebdriverIOPuppeteerModalDialogHandler;
+//# sourceMappingURL=WebdriverIOPuppeteerModalDialogHandler.js.map

package/lib/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOPuppeteerModalDialogHandler.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.ts"],"names":[],"mappings":"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"}

package/lib/screenplay/models/WebdriverProtocolErrorCode.d.ts

@@ -0,0 +1,39 @@
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/WebDriver/Errors#table_of_errors
+ * https://github.com/SeleniumHQ/selenium/blob/e70e22390000a65a6b706fbb33bbff8913555670/javascript/node/selenium-webdriver/lib/error.js#L441
+ *
+ * @package
+ */
+export declare enum WebdriverProtocolErrorCode {
+    WebDriverError = "unknown error",
+    DetachedShadowRootError = "detached shadow root",
+    ElementClickInterceptedError = "element click intercepted",
+    ElementNotInteractableError = "element not interactable",
+    ElementNotSelectableError = "element not selectable",
+    InsecureCertificateError = "insecure certificate",
+    InvalidArgumentError = "invalid argument",
+    InvalidCookieDomainError = "invalid cookie domain",
+    InvalidCoordinatesError = "invalid coordinates",
+    InvalidElementStateError = "invalid element state",
+    InvalidSelectorError = "invalid selector",
+    NoSuchSessionError = "invalid session id",
+    JavascriptError = "javascript error",
+    MoveTargetOutOfBoundsError = "move target out of bounds",
+    NoSuchAlertError = "no such alert",
+    NoSuchCookieError = "no such cookie",
+    NoSuchElementError = "no such element",
+    NoSuchFrameError = "no such frame",
+    NoSuchShadowRootError = "no such shadow root",
+    NoSuchWindowError = "no such window",
+    ScriptTimeoutError = "script timeout",
+    SessionNotCreatedError = "session not created",
+    StaleElementReferenceError = "stale element reference",
+    TimeoutError = "timeout",
+    UnableToSetCookieError = "unable to set cookie",
+    UnableToCaptureScreenError = "unable to capture screen",
+    UnexpectedAlertOpenError = "unexpected alert open",
+    UnknownCommandError = "unknown command",
+    UnknownMethodError = "unknown method",
+    UnsupportedOperationError = "unsupported operation"
+}
+//# sourceMappingURL=WebdriverProtocolErrorCode.d.ts.map

package/lib/screenplay/models/WebdriverProtocolErrorCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverProtocolErrorCode.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverProtocolErrorCode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,0BAA0B;IAClC,cAAc,kBAAkB;IAChC,uBAAuB,yBAAyB;IAChD,4BAA4B,8BAA8B;IAC1D,2BAA2B,6BAA6B;IACxD,yBAAyB,2BAA2B;IACpD,wBAAwB,yBAAyB;IACjD,oBAAoB,qBAAqB;IACzC,wBAAwB,0BAA0B;IAClD,uBAAuB,wBAAwB;IAC/C,wBAAwB,0BAA0B;IAClD,oBAAoB,qBAAqB;IACzC,kBAAkB,uBAAuB;IACzC,eAAe,qBAAqB;IACpC,0BAA0B,8BAA8B;IACxD,gBAAgB,kBAAkB;IAClC,iBAAiB,mBAAmB;IACpC,kBAAkB,oBAAoB;IACtC,gBAAgB,kBAAkB;IAClC,qBAAqB,wBAAwB;IAC7C,iBAAiB,mBAAmB;IACpC,kBAAkB,mBAAmB;IACrC,sBAAsB,wBAAwB;IAC9C,0BAA0B,4BAA4B;IACtD,YAAY,YAAY;IACxB,sBAAsB,yBAAyB;IAC/C,0BAA0B,6BAA6B;IACvD,wBAAwB,0BAA0B;IAClD,mBAAmB,oBAAoB;IACvC,kBAAkB,mBAAmB;IACrC,yBAAyB,0BAA0B;CACtD"}

package/lib/screenplay/models/WebdriverProtocolErrorCode.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverProtocolErrorCode = void 0;
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/WebDriver/Errors#table_of_errors
+ * https://github.com/SeleniumHQ/selenium/blob/e70e22390000a65a6b706fbb33bbff8913555670/javascript/node/selenium-webdriver/lib/error.js#L441
+ *
+ * @package
+ */
+var WebdriverProtocolErrorCode;
+(function (WebdriverProtocolErrorCode) {
+    WebdriverProtocolErrorCode["WebDriverError"] = "unknown error";
+    WebdriverProtocolErrorCode["DetachedShadowRootError"] = "detached shadow root";
+    WebdriverProtocolErrorCode["ElementClickInterceptedError"] = "element click intercepted";
+    WebdriverProtocolErrorCode["ElementNotInteractableError"] = "element not interactable";
+    WebdriverProtocolErrorCode["ElementNotSelectableError"] = "element not selectable";
+    WebdriverProtocolErrorCode["InsecureCertificateError"] = "insecure certificate";
+    WebdriverProtocolErrorCode["InvalidArgumentError"] = "invalid argument";
+    WebdriverProtocolErrorCode["InvalidCookieDomainError"] = "invalid cookie domain";
+    WebdriverProtocolErrorCode["InvalidCoordinatesError"] = "invalid coordinates";
+    WebdriverProtocolErrorCode["InvalidElementStateError"] = "invalid element state";
+    WebdriverProtocolErrorCode["InvalidSelectorError"] = "invalid selector";
+    WebdriverProtocolErrorCode["NoSuchSessionError"] = "invalid session id";
+    WebdriverProtocolErrorCode["JavascriptError"] = "javascript error";
+    WebdriverProtocolErrorCode["MoveTargetOutOfBoundsError"] = "move target out of bounds";
+    WebdriverProtocolErrorCode["NoSuchAlertError"] = "no such alert";
+    WebdriverProtocolErrorCode["NoSuchCookieError"] = "no such cookie";
+    WebdriverProtocolErrorCode["NoSuchElementError"] = "no such element";
+    WebdriverProtocolErrorCode["NoSuchFrameError"] = "no such frame";
+    WebdriverProtocolErrorCode["NoSuchShadowRootError"] = "no such shadow root";
+    WebdriverProtocolErrorCode["NoSuchWindowError"] = "no such window";
+    WebdriverProtocolErrorCode["ScriptTimeoutError"] = "script timeout";
+    WebdriverProtocolErrorCode["SessionNotCreatedError"] = "session not created";
+    WebdriverProtocolErrorCode["StaleElementReferenceError"] = "stale element reference";
+    WebdriverProtocolErrorCode["TimeoutError"] = "timeout";
+    WebdriverProtocolErrorCode["UnableToSetCookieError"] = "unable to set cookie";
+    WebdriverProtocolErrorCode["UnableToCaptureScreenError"] = "unable to capture screen";
+    WebdriverProtocolErrorCode["UnexpectedAlertOpenError"] = "unexpected alert open";
+    WebdriverProtocolErrorCode["UnknownCommandError"] = "unknown command";
+    WebdriverProtocolErrorCode["UnknownMethodError"] = "unknown method";
+    WebdriverProtocolErrorCode["UnsupportedOperationError"] = "unsupported operation";
+})(WebdriverProtocolErrorCode = exports.WebdriverProtocolErrorCode || (exports.WebdriverProtocolErrorCode = {}));
+//# sourceMappingURL=WebdriverProtocolErrorCode.js.map

package/lib/screenplay/models/WebdriverProtocolErrorCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverProtocolErrorCode.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverProtocolErrorCode.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,0BA+BX;AA/BD,WAAY,0BAA0B;IAClC,8DAAgC,CAAA;IAChC,8EAAgD,CAAA;IAChD,wFAA0D,CAAA;IAC1D,sFAAwD,CAAA;IACxD,kFAAoD,CAAA;IACpD,+EAAiD,CAAA;IACjD,uEAAyC,CAAA;IACzC,gFAAkD,CAAA;IAClD,6EAA+C,CAAA;IAC/C,gFAAkD,CAAA;IAClD,uEAAyC,CAAA;IACzC,uEAAyC,CAAA;IACzC,kEAAoC,CAAA;IACpC,sFAAwD,CAAA;IACxD,gEAAkC,CAAA;IAClC,kEAAoC,CAAA;IACpC,oEAAsC,CAAA;IACtC,gEAAkC,CAAA;IAClC,2EAA6C,CAAA;IAC7C,kEAAoC,CAAA;IACpC,mEAAqC,CAAA;IACrC,4EAA8C,CAAA;IAC9C,oFAAsD,CAAA;IACtD,sDAAwB,CAAA;IACxB,6EAA+C,CAAA;IAC/C,qFAAuD,CAAA;IACvD,gFAAkD,CAAA;IAClD,qEAAuC,CAAA;IACvC,mEAAqC,CAAA;IACrC,iFAAmD,CAAA;AACvD,CAAC,EA/BW,0BAA0B,GAA1B,kCAA0B,KAA1B,kCAA0B,QA+BrC"}

package/lib/screenplay/models/index.d.ts

@@ -1,4 +1,5 @@
+export * from './WebdriverIOBrowsingSession';
 export * from './WebdriverIOCookie';
-export * from './WebdriverIOModalDialog';
 export * from './WebdriverIOPage';
 export * from './WebdriverIOPageElement';
+//# sourceMappingURL=index.d.ts.map

package/lib/screenplay/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC"}

package/lib/screenplay/models/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -10,8 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./WebdriverIOBrowsingSession"), exports);
 __exportStar(require("./WebdriverIOCookie"), exports);
-__exportStar(require("./WebdriverIOModalDialog"), exports);
 __exportStar(require("./WebdriverIOPage"), exports);
 __exportStar(require("./WebdriverIOPageElement"), exports);
 //# sourceMappingURL=index.js.map

package/lib/screenplay/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sDAAoC;AACpC,2DAAyC;AACzC,oDAAkC;AAClC,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,sDAAoC;AACpC,oDAAkC;AAClC,2DAAyC"}

package/lib/screenplay/models/locators/WebdriverIOLocator.d.ts

@@ -1,9 +1,22 @@
-import { Locator, PageElement, Selector } from '@serenity-js/web';
+import { Locator, PageElement, RootLocator, Selector } from '@serenity-js/web';
 import * as wdio from 'webdriverio';
-import { WebdriverIONativeElementRoot } from './WebdriverIONativeElementRoot';
-export declare class WebdriverIOLocator<Selector_Type extends Selector> extends Locator<wdio.Element<'async'>, WebdriverIONativeElementRoot, Selector_Type> {
-    static createRootLocator<ST extends Selector>(browser: WebdriverIONativeElementRoot, selector: ST, webdriverioSelector: string): WebdriverIOLocator<ST>;
-    of(parent: WebdriverIOLocator<unknown>): Locator<wdio.Element<'async'>, WebdriverIONativeElementRoot, Selector_Type>;
+import { WebdriverIOErrorHandler } from '../WebdriverIOErrorHandler';
+/**
+ * WebdriverIO-specific implementation of {@apilink Locator}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOLocator extends Locator<wdio.Element<'async'>, string> {
+    private readonly errorHandler;
+    constructor(parent: RootLocator<wdio.Element<'async'>>, selector: Selector, errorHandler: WebdriverIOErrorHandler);
+    protected nativeSelector(): string;
+    isPresent(): Promise<boolean>;
+    nativeElement(): Promise<wdio.Element<'async'>>;
+    private resolveNativeElement;
+    allNativeElements(): Promise<Array<wdio.Element<'async'>>>;
+    of(parent: WebdriverIOLocator): Locator<wdio.Element<'async'>, string>;
+    locate(child: WebdriverIOLocator): Locator<wdio.Element<'async'>, string>;
     element(): PageElement<wdio.Element<'async'>>;
     allElements(): Promise<Array<PageElement<wdio.Element<'async'>>>>;
 }
+//# sourceMappingURL=WebdriverIOLocator.d.ts.map

package/lib/screenplay/models/locators/WebdriverIOLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOLocator.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/WebdriverIOLocator.ts"],"names":[],"mappings":"AACA,OAAO,EAAmE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAChJ,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAIrE;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAKtE,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAF7B,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAC1C,QAAQ,EAAE,QAAQ,EACD,YAAY,EAAE,uBAAuB;IAM1D,SAAS,CAAC,cAAc,IAAI,MAAM;IA4B5B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAU7B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YASvC,oBAAoB;IAgB5B,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAKhE,EAAE,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAItE,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAIzE,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAIvC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAc1E"}