@serenity-js/webdriverio-8 3.31.0

package/lib/screenplay/models/WebdriverIOPage.js

@@ -0,0 +1,256 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOPage = void 0;
+require("webdriverio");
+const core_1 = require("@serenity-js/core");
+const web_1 = require("@serenity-js/web");
+const scripts = __importStar(require("@serenity-js/web/lib/scripts/index.js"));
+const url_1 = require("url");
+const index_js_1 = require("./locators/index.js");
+const WebdriverIOCookie_js_1 = require("./WebdriverIOCookie.js");
+const WebdriverIOPageElement_js_1 = require("./WebdriverIOPageElement.js");
+/**
+ * WebdriverIO-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
+ *
+ * @group Models
+ */
+class WebdriverIOPage extends web_1.Page {
+    browser;
+    errorHandler;
+    lastScriptExecutionSummary;
+    /* eslint-disable unicorn/consistent-function-scoping */
+    dehydrator = new web_1.ArgumentDehydrator((item) => item instanceof web_1.PageElement, (item) => item.nativeElement());
+    /* eslint-enable */
+    constructor(session, browser, modalDialogHandler, errorHandler, pageId) {
+        super(session, new index_js_1.WebdriverIORootLocator(browser), modalDialogHandler, pageId);
+        this.browser = browser;
+        this.errorHandler = errorHandler;
+    }
+    createPageElement(nativeElement) {
+        return new WebdriverIOPageElement_js_1.WebdriverIOPageElement(new index_js_1.WebdriverIOExistingElementLocator(this.rootLocator, new web_1.ByCss(String(nativeElement.selector)), this.errorHandler, nativeElement));
+    }
+    locate(selector) {
+        return new WebdriverIOPageElement_js_1.WebdriverIOPageElement(new index_js_1.WebdriverIOLocator(this.rootLocator, selector, this.errorHandler));
+    }
+    locateAll(selector) {
+        return core_1.List.of(new web_1.PageElementsLocator(new index_js_1.WebdriverIOLocator(this.rootLocator, selector, this.errorHandler)));
+    }
+    async navigateTo(destination) {
+        await this.inContextOfThisPage(() => this.browser.url(destination));
+    }
+    async navigateBack() {
+        await this.inContextOfThisPage(() => this.browser.back());
+    }
+    async navigateForward() {
+        await this.inContextOfThisPage(() => this.browser.forward());
+    }
+    async reload() {
+        await this.inContextOfThisPage(() => this.browser.refresh());
+    }
+    async sendKeys(keys) {
+        const keySequence = keys.map(key => {
+            if (!web_1.Key.isKey(key)) {
+                return key;
+            }
+            return key.utf16codePoint;
+        });
+        await this.inContextOfThisPage(() => this.browser.keys(keySequence));
+    }
+    async executeScript(script, ...args) {
+        const serialisedScript = typeof script === 'function'
+            ? String(script)
+            : String(`function script() { ${script} }`);
+        const executableScript = new Function(`
+            var parameters = (${scripts.rehydrate}).apply(null, arguments);
+            return (${serialisedScript}).apply(null, parameters);
+        `);
+        const result = await this.inContextOfThisPage(async () => {
+            const dehydratedArguments = await this.dehydrator.dehydrate(args);
+            return await this.browser.execute(executableScript, ...dehydratedArguments);
+        });
+        this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
+        return result;
+    }
+    async executeAsyncScript(script, ...args) {
+        const serialisedScript = typeof script === 'function'
+            ? String(script)
+            : String(`function script() { ${script} }`);
+        const executableScript = new Function(`
+            var args = Array.prototype.slice.call(arguments, 0, -1);
+            var callback = arguments[arguments.length - 1];
+            var parameters = (${scripts.rehydrate}).apply(null, args);
+            (${serialisedScript}).apply(null, parameters.concat(callback));
+        `);
+        const result = await this.inContextOfThisPage(async () => {
+            const dehydratedArguments = await this.dehydrator.dehydrate(args);
+            return this.browser.executeAsync(executableScript, ...dehydratedArguments);
+        });
+        this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
+        return result;
+    }
+    lastScriptExecutionResult() {
+        if (!this.lastScriptExecutionSummary) {
+            throw new core_1.LogicError(`Make sure to execute a script before checking on the result`);
+        }
+        // Selenium returns `null` when the script it executed returns `undefined`
+        // so we're mapping the result back.
+        return this.lastScriptExecutionSummary.result === null
+            ? undefined
+            : this.lastScriptExecutionSummary.result;
+    }
+    async takeScreenshot() {
+        return await this.inContextOfThisPage(async () => {
+            try {
+                return await this.browser.takeScreenshot();
+            }
+            catch (error) {
+                if (error.name === 'ProtocolError' && error.message.includes('Target closed')) {
+                    throw new web_1.BrowserWindowClosedError(`Couldn't take screenshot since the browser window is already closed`, error);
+                }
+                throw error;
+            }
+        });
+    }
+    async cookie(name) {
+        return new WebdriverIOCookie_js_1.WebdriverIOCookie(this.browser, name);
+    }
+    async setCookie(cookieData) {
+        return await this.inContextOfThisPage(() => {
+            return this.browser.setCookies({
+                name: cookieData.name,
+                value: cookieData.value,
+                path: cookieData.path,
+                domain: cookieData.domain,
+                secure: cookieData.secure,
+                httpOnly: cookieData.httpOnly,
+                expiry: cookieData.expiry
+                    ? cookieData.expiry.toSeconds()
+                    : undefined,
+                sameSite: cookieData.sameSite,
+            });
+        });
+    }
+    async deleteAllCookies() {
+        return await this.inContextOfThisPage(() => {
+            return this.browser.deleteCookies();
+        });
+    }
+    async title() {
+        return await this.inContextOfThisPage(() => this.browser.execute(`return document.title`));
+    }
+    async name() {
+        return await this.inContextOfThisPage(() => this.browser.execute(`return window.name`));
+    }
+    async url() {
+        return await this.inContextOfThisPage(async () => {
+            return new url_1.URL(await this.browser.execute(`return window.location.href`));
+        });
+    }
+    async viewportSize() {
+        return await this.inContextOfThisPage(async () => {
+            if (!this.browser.isDevTools) {
+                const calculatedViewportSize = await this.browser.execute(`
+                    return {
+                        width:  Math.max(document.documentElement.clientWidth,  window.innerWidth || 0),
+                        height: Math.max(document.documentElement.clientHeight, window.innerHeight || 0),
+                    }
+                `);
+                // Chrome headless hard-codes window.innerWidth and window.innerHeight to 0
+                if (calculatedViewportSize.width > 0 && calculatedViewportSize.height > 0) {
+                    return calculatedViewportSize;
+                }
+            }
+            return this.browser.getWindowSize();
+        });
+    }
+    async setViewportSize(size) {
+        return await this.inContextOfThisPage(async () => {
+            let desiredWindowSize = size;
+            if (!this.browser.isDevTools) {
+                desiredWindowSize = await this.browser.execute(`
+                    var currentViewportWidth  = Math.max(document.documentElement.clientWidth, window.innerWidth || 0)
+                    var currentViewportHeight = Math.max(document.documentElement.clientHeight, window.innerHeight || 0)
+                    
+                    return {
+                        width:  Math.max(window.outerWidth  - currentViewportWidth  + ${size.width},  ${size.width}),
+                        height: Math.max(window.outerHeight - currentViewportHeight + ${size.height}, ${size.height}),
+                    };
+                `);
+            }
+            return this.browser.setWindowSize(desiredWindowSize.width, desiredWindowSize.height);
+        });
+    }
+    async close() {
+        await this.inContextOfThisPage(() => this.browser.closeWindow());
+    }
+    async closeOthers() {
+        await this.session.closePagesOtherThan(this);
+    }
+    async isPresent() {
+        const allPages = await this.session.allPages();
+        for (const page of allPages) {
+            if (page === this) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async inContextOfThisPage(action) {
+        let originalCurrentPage;
+        try {
+            originalCurrentPage = await this.session.currentPage();
+            await this.session.changeCurrentPageTo(this);
+            return await action();
+        }
+        catch (error) {
+            return await this.errorHandler.executeIfHandled(error, action);
+        }
+        finally {
+            await this.session.changeCurrentPageTo(originalCurrentPage);
+        }
+    }
+}
+exports.WebdriverIOPage = WebdriverIOPage;
+/**
+ * @package
+ */
+class LastScriptExecutionSummary {
+    result;
+    constructor(result) {
+        this.result = result;
+    }
+}
+//# sourceMappingURL=WebdriverIOPage.js.map

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

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

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

@@ -0,0 +1,34 @@
+import 'webdriverio';
+import type { SwitchableOrigin } from '@serenity-js/web';
+import { PageElement, SelectOption } from '@serenity-js/web';
+/**
+ * WebdriverIO-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
+ *
+ * @group Models
+ */
+export declare class WebdriverIOPageElement extends PageElement<WebdriverIO.Element> {
+    of(parent: WebdriverIOPageElement): WebdriverIOPageElement;
+    closestTo(child: WebdriverIOPageElement): WebdriverIOPageElement;
+    clearValue(): Promise<void>;
+    click(): Promise<void>;
+    doubleClick(): Promise<void>;
+    enterValue(value: string | number | Array<string | number>): Promise<void>;
+    scrollIntoView(): Promise<void>;
+    hoverOver(): Promise<void>;
+    rightClick(): Promise<void>;
+    selectOptions(...options: SelectOption[]): Promise<void>;
+    selectedOptions(): Promise<SelectOption[]>;
+    attribute(name: string): Promise<string>;
+    text(): Promise<string>;
+    value(): Promise<string>;
+    html(): Promise<string>;
+    switchTo(): Promise<SwitchableOrigin>;
+    isActive(): Promise<boolean>;
+    isClickable(): Promise<boolean>;
+    isEnabled(): Promise<boolean>;
+    isPresent(): Promise<boolean>;
+    isSelected(): Promise<boolean>;
+    isVisible(): Promise<boolean>;
+    private browserFor;
+}
+//# sourceMappingURL=WebdriverIOPageElement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOPageElement.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPageElement.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAO,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMlE;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;IACxE,EAAE,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB;IAI1D,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB;IAI1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,aAAa,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxD,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA4B1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA4DrC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAK5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAK7B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAK7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;YAgCrB,UAAU;CAM3B"}

package/lib/screenplay/models/WebdriverIOPageElement.js

@@ -0,0 +1,257 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOPageElement = void 0;
+require("webdriverio");
+const core_1 = require("@serenity-js/core");
+const web_1 = require("@serenity-js/web");
+const scripts = __importStar(require("@serenity-js/web/lib/scripts/index.js"));
+const WebdriverProtocolErrorCode_js_1 = require("./WebdriverProtocolErrorCode.js");
+/**
+ * WebdriverIO-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
+ *
+ * @group Models
+ */
+class WebdriverIOPageElement extends web_1.PageElement {
+    of(parent) {
+        return new WebdriverIOPageElement(this.locator.of(parent.locator));
+    }
+    closestTo(child) {
+        return new WebdriverIOPageElement(this.locator.closestTo(child.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) {
+            await browser.execute(
+            /* c8 ignore next */
+            function focusOn(element) {
+                element.focus();
+            }, element);
+            await browser.keys([
+                web_1.Key.Home.utf16codePoint,
+                ...times(numberOfCharacters, web_1.Key.Delete.utf16codePoint),
+            ]);
+        }
+        const element = await this.nativeElement();
+        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();
+        await element.click();
+    }
+    async doubleClick() {
+        const element = await this.nativeElement();
+        await element.doubleClick();
+    }
+    async enterValue(value) {
+        const text = Array.isArray(value) ? value.join('') : value;
+        const element = await this.nativeElement();
+        await element.addValue(text);
+    }
+    async scrollIntoView() {
+        const element = await this.nativeElement();
+        await element.scrollIntoView();
+    }
+    async hoverOver() {
+        const element = await this.nativeElement();
+        await element.moveTo();
+    }
+    async rightClick() {
+        const element = await this.nativeElement();
+        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(
+        /* c8 ignore start */
+        (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
+        /* c8 ignore stop */
+        );
+        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 await element.getAttribute(name);
+    }
+    async text() {
+        const element = await this.nativeElement();
+        return await element.getText();
+    }
+    async value() {
+        const element = await this.nativeElement();
+        return await element.getValue();
+    }
+    async html() {
+        const element = await this.nativeElement();
+        return await element.getHTML(true);
+    }
+    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 () => {
+                        try {
+                            await locator.switchToParentFrame();
+                        }
+                        catch {
+                            // switchToParentFrame doesn't work on iOS devices, so we need a workaround
+                            // https://github.com/appium/appium/issues/14882#issuecomment-1693326102
+                            await locator.switchToFrame(null); // eslint-disable-line unicorn/no-null
+                        }
+                    }
+                };
+            }
+            else {
+                // focus on element
+                const previouslyFocusedElement = await browser.execute(
+                /* c8 ignore next */
+                function focusOn(element) {
+                    const currentlyFocusedElement = document.activeElement;
+                    element.focus();
+                    return currentlyFocusedElement;
+                }, element);
+                return {
+                    switchBack: async () => {
+                        await browser.execute(
+                        /* c8 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 await element.isFocused();
+    }
+    async isClickable() {
+        const element = await this.nativeElement();
+        return await element.isClickable();
+    }
+    async isEnabled() {
+        const element = await this.nativeElement();
+        return await element.isEnabled();
+    }
+    async isPresent() {
+        const element = await this.nativeElement();
+        return await element.isExisting();
+    }
+    async isSelected() {
+        const element = await this.nativeElement();
+        return await element.isSelected();
+    }
+    async isVisible() {
+        try {
+            const element = await this.nativeElement();
+            if (!await element.isDisplayed()) {
+                return false;
+            }
+            if (!await element.isDisplayedInViewport()) {
+                return false;
+            }
+            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_js_1.WebdriverProtocolErrorCode.NoSuchElementError ||
+                error.error === WebdriverProtocolErrorCode_js_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) {
+        const element = nativeElement;
+        return element.parent
+            ? this.browserFor(element.parent)
+            : nativeElement;
+    }
+}
+exports.WebdriverIOPageElement = WebdriverIOPageElement;
+//# sourceMappingURL=WebdriverIOPageElement.js.map

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

@@ -0,0 +1 @@
+{"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,30 @@
+import type { ModalDialog } from '@serenity-js/web';
+import { ModalDialogHandler } from '@serenity-js/web';
+import type { Page } from 'puppeteer-core';
+/**
+ * WebdriverIO-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/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
+ */
+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,KAAK,EACR,WAAW,EAAC,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAIH,kBAAkB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;GAWG;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"}