@serenity-js/webdriverio 3.1.6 → 3.2.1

package/esm/screenplay/models/WebdriverIOModalDialogHandler.js

@@ -0,0 +1,73 @@
+import { AbsentModalDialog, AcceptedModalDialog, DismissedModalDialog, ModalDialogHandler } from '@serenity-js/web';
+import { WebdriverProtocolErrorCode } from './WebdriverProtocolErrorCode.js';
+/**
+ * WebdriverIO-specific implementation of {@apilink ModalDialogHandler},
+ * used with the [WebDriver protocol](https://webdriver.io/docs/api/webdriver).
+ *
+ * ## Learn more
+ * - {@apilink WebdriverIOPuppeteerModalDialogHandler}
+ *
+ * @group Models
+ */
+export class WebdriverIOModalDialogHandler extends ModalDialogHandler {
+    constructor(browser, errorHandler) {
+        super();
+        this.browser = browser;
+        this.errorHandler = errorHandler;
+        this.defaultHandler = async () => {
+            const message = await this.browser.getAlertText();
+            await this.browser.dismissAlert();
+            this.modalDialog = new DismissedModalDialog(message);
+        };
+        this.currentHandler = this.defaultHandler;
+        this.errorHandler.setHandlerFor(WebdriverProtocolErrorCode.UnexpectedAlertOpenError, error_ => this.tryToHandleDialog());
+    }
+    async tryToHandleDialog() {
+        try {
+            await this.currentHandler();
+        }
+        catch (error) {
+            if (error.name === WebdriverProtocolErrorCode.NoSuchAlertError) {
+                this.modalDialog = new AbsentModalDialog();
+                return;
+            }
+            throw error;
+        }
+    }
+    async acceptNext() {
+        this.currentHandler = async () => {
+            const message = await this.browser.getAlertText();
+            await this.browser.acceptAlert();
+            this.modalDialog = new AcceptedModalDialog(message);
+        };
+    }
+    async acceptNextWithValue(text) {
+        this.currentHandler = async () => {
+            await this.browser.sendAlertText(String(text));
+            const message = await this.browser.getAlertText();
+            await this.browser.acceptAlert();
+            this.modalDialog = new AcceptedModalDialog(message);
+        };
+    }
+    async dismissNext() {
+        this.currentHandler = async () => {
+            const message = await this.browser.getAlertText();
+            await this.browser.dismissAlert();
+            this.modalDialog = new DismissedModalDialog(message);
+        };
+    }
+    async reset() {
+        this.modalDialog = new AbsentModalDialog();
+        this.currentHandler = this.defaultHandler;
+    }
+    /**
+     * @override
+     */
+    async last() {
+        if (this.modalDialog instanceof AbsentModalDialog) {
+            await this.tryToHandleDialog();
+        }
+        return this.modalDialog;
+    }
+}
+//# sourceMappingURL=WebdriverIOModalDialogHandler.js.map

package/esm/screenplay/models/WebdriverIOModalDialogHandler.js.map

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

package/esm/screenplay/models/WebdriverIOPage.d.ts

@@ -0,0 +1,48 @@
+/// <reference types="node" resolution-mode="require"/>
+import { CorrelationId } from '@serenity-js/core/lib/model/index.js';
+import { Cookie, CookieData, Key, ModalDialogHandler, Page, PageElement, PageElements, Selector } from '@serenity-js/web';
+import { URL } from 'url';
+import type { Browser, Element } from 'webdriverio';
+import { WebdriverIOBrowsingSession } from './WebdriverIOBrowsingSession.js';
+import { WebdriverIOErrorHandler } from './WebdriverIOErrorHandler.js';
+/**
+ * WebdriverIO-specific implementation of {@apilink Page}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOPage extends Page<Element> {
+    private readonly browser;
+    private readonly errorHandler;
+    private lastScriptExecutionSummary;
+    constructor(session: WebdriverIOBrowsingSession, browser: Browser, modalDialogHandler: ModalDialogHandler, errorHandler: WebdriverIOErrorHandler, pageId: CorrelationId);
+    locate(selector: Selector): PageElement<Element>;
+    locateAll(selector: Selector): PageElements<Element>;
+    navigateTo(destination: string): Promise<void>;
+    navigateBack(): Promise<void>;
+    navigateForward(): Promise<void>;
+    reload(): Promise<void>;
+    sendKeys(keys: Array<Key | string>): Promise<void>;
+    executeScript<Result, InnerArguments extends any[]>(script: string | ((...parameters: InnerArguments) => Result), ...args: InnerArguments): Promise<Result>;
+    executeAsyncScript<Result, Parameters extends any[]>(script: string | ((...args: [...parameters: Parameters, callback: (result: Result) => void]) => void), ...args: Parameters): Promise<Result>;
+    lastScriptExecutionResult<Result = any>(): Result;
+    takeScreenshot(): Promise<string>;
+    cookie(name: string): Promise<Cookie>;
+    setCookie(cookieData: CookieData): Promise<void>;
+    deleteAllCookies(): Promise<void>;
+    title(): Promise<string>;
+    name(): Promise<string>;
+    url(): Promise<URL>;
+    viewportSize(): Promise<{
+        width: number;
+        height: number;
+    }>;
+    setViewportSize(size: {
+        width: number;
+        height: number;
+    }): Promise<void>;
+    close(): Promise<void>;
+    closeOthers(): Promise<void>;
+    isPresent(): Promise<boolean>;
+    private inContextOfThisPage;
+}
+//# sourceMappingURL=WebdriverIOPage.d.ts.map

package/esm/screenplay/models/WebdriverIOPage.d.ts.map

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

package/esm/screenplay/models/WebdriverIOPage.js

@@ -0,0 +1,203 @@
+import { LogicError } from '@serenity-js/core';
+import { BrowserWindowClosedError, Key, Page, PageElements } from '@serenity-js/web';
+import { URL } from 'url';
+import { WebdriverIOLocator, WebdriverIORootLocator } from './locators/index.js';
+import { WebdriverIOCookie } from './WebdriverIOCookie.js';
+import { WebdriverIOPageElement } from './WebdriverIOPageElement.js';
+/**
+ * WebdriverIO-specific implementation of {@apilink Page}.
+ *
+ * @group Models
+ */
+export class WebdriverIOPage extends Page {
+    constructor(session, browser, modalDialogHandler, errorHandler, pageId) {
+        super(session, new WebdriverIORootLocator(browser), modalDialogHandler, pageId);
+        this.browser = browser;
+        this.errorHandler = errorHandler;
+    }
+    locate(selector) {
+        return new WebdriverIOPageElement(new WebdriverIOLocator(this.rootLocator, selector, this.errorHandler));
+    }
+    locateAll(selector) {
+        return new PageElements(new 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 (!Key.isKey(key)) {
+                return key;
+            }
+            return key.utf16codePoint;
+        });
+        await this.inContextOfThisPage(() => this.browser.keys(keySequence));
+    }
+    async executeScript(script, ...args) {
+        const innerArguments = [];
+        for (const arg of args) {
+            const innerArgument = arg instanceof WebdriverIOPageElement
+                ? await arg.nativeElement()
+                : arg;
+            innerArguments.push(innerArgument);
+        }
+        const result = await this.inContextOfThisPage(() => {
+            return this.browser.execute(script, ...innerArguments);
+        });
+        this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
+        return result;
+    }
+    async executeAsyncScript(script, ...args) {
+        const parameters = [];
+        for (const arg of args) {
+            const parameter = arg instanceof WebdriverIOPageElement
+                ? await arg.nativeElement()
+                : arg;
+            parameters.push(parameter);
+        }
+        const result = await this.inContextOfThisPage(() => {
+            return this.browser.executeAsync(script, ...parameters);
+        });
+        this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
+        return result;
+    }
+    lastScriptExecutionResult() {
+        if (!this.lastScriptExecutionSummary) {
+            throw new 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 BrowserWindowClosedError(`Couldn't take screenshot since the browser window is already closed`, error);
+                }
+                throw error;
+            }
+        });
+    }
+    async cookie(name) {
+        return new 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.getTitle());
+    }
+    async name() {
+        return await this.inContextOfThisPage(() => this.browser.execute(`return window.name`));
+    }
+    async url() {
+        return await this.inContextOfThisPage(async () => {
+            return new URL(await this.browser.getUrl());
+        });
+    }
+    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);
+        }
+    }
+}
+/**
+ * @package
+ */
+class LastScriptExecutionSummary {
+    constructor(result) {
+        this.result = result;
+    }
+}
+//# sourceMappingURL=WebdriverIOPage.js.map

package/esm/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/esm/screenplay/models/WebdriverIOPageElement.d.ts

@@ -0,0 +1,31 @@
+import { PageElement, SelectOption, SwitchableOrigin } from '@serenity-js/web';
+import type { Element } from 'webdriverio';
+/**
+ * WebdriverIO-specific implementation of {@apilink PageElement}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOPageElement extends PageElement<Element> {
+    of(parent: 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>;
+    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/esm/screenplay/models/WebdriverIOPageElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOPageElement.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOPageElement.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,aAAa,CAAC;AAKpD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,WAAW,CAAC,OAAO,CAAC;IAC5D,EAAE,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB;IAIpD,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,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAqDrC,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/esm/screenplay/models/WebdriverIOPageElement.js

@@ -0,0 +1,205 @@
+import { LogicError } from '@serenity-js/core';
+import { Key, PageElement, SelectOption } from '@serenity-js/web';
+import * as scripts from '@serenity-js/web/lib/scripts/index.js';
+import { WebdriverProtocolErrorCode } from './WebdriverProtocolErrorCode.js';
+/**
+ * WebdriverIO-specific implementation of {@apilink PageElement}.
+ *
+ * @group Models
+ */
+export class WebdriverIOPageElement extends 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) {
+            await browser.execute(
+            /* c8 ignore next */
+            function focusOn(element) {
+                element.focus();
+            }, element);
+            await browser.keys([
+                Key.Home.utf16codePoint,
+                ...times(numberOfCharacters, 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 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 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(
+                /* 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 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.NoSuchElementError ||
+                error.error === 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;
+    }
+}
+//# sourceMappingURL=WebdriverIOPageElement.js.map

package/esm/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/esm/screenplay/models/WebdriverIOPuppeteerModalDialogHandler.d.ts

@@ -0,0 +1,32 @@
+import { ModalDialog, ModalDialogHandler } from '@serenity-js/web';
+import type { Page } from 'puppeteer-core';
+/**
+ * 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/esm/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,EAIH,WAAW,EACX,kBAAkB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;;;;;;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"}