@serenity-js/webdriverio-8 3.31.0

package/esm/screenplay/models/WebdriverIOBrowsingSession.js

@@ -0,0 +1,125 @@
+import 'webdriverio';
+import { LogicError } from '@serenity-js/core';
+import { CorrelationId } from '@serenity-js/core/lib/model/index.js';
+import { BrowsingSession } from '@serenity-js/web';
+import { WebdriverIOPage } from '../models/index.js';
+import { WebdriverIOErrorHandler } from './WebdriverIOErrorHandler.js';
+import { WebdriverIOModalDialogHandler } from './WebdriverIOModalDialogHandler.js';
+import { WebdriverIOPuppeteerModalDialogHandler } from './WebdriverIOPuppeteerModalDialogHandler.js';
+/**
+ * WebdriverIO-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/).
+ *
+ * @group Models
+ */
+export class WebdriverIOBrowsingSession extends BrowsingSession {
+    browser;
+    constructor(browser) {
+        super();
+        this.browser = browser;
+        if (!browser.$ || !browser.$$) {
+            throw new LogicError(`WebdriverIO browser object is not initialised yet, so can't be assigned to an actor. Are you trying to instantiate an actor outside of a test or a test hook?`);
+        }
+    }
+    async allPages() {
+        // scan all the active window handles and add any newly opened windows if needed
+        const windowHandles = await this.browser.getWindowHandles();
+        // remove pages that are no longer open
+        const closedPageIds = this.registeredPageIds()
+            .filter(id => !windowHandles.includes(id.value));
+        this.deregister(...closedPageIds);
+        // add any new pages that might have been opened (e.g. popup windows)
+        const registeredWindowHandles = new Set(this.registeredPageIds().map(id => id.value));
+        const newlyOpenedWindowHandles = windowHandles.filter(windowHandle => !registeredWindowHandles.has(windowHandle));
+        for (const newlyOpenedWindowHandle of newlyOpenedWindowHandles) {
+            const errorHandler = new WebdriverIOErrorHandler();
+            this.register(new WebdriverIOPage(this, this.browser, await this.modalDialogHandlerFor(newlyOpenedWindowHandle, errorHandler), errorHandler, new CorrelationId(newlyOpenedWindowHandle)));
+        }
+        return super.allPages();
+    }
+    /**
+     * @param page
+     */
+    async changeCurrentPageTo(page) {
+        const currentPage = await this.currentPage();
+        // are we already on this page?
+        if (currentPage.id.equals(page.id)) {
+            return void 0;
+        }
+        // does the new page exist, or has it been closed in the meantime by user action, script, or similar?
+        if (!await page.isPresent()) {
+            return void 0;
+        }
+        // the page seems to be legit, switch to it
+        await this.browser.switchToWindow(page.id.value);
+        // and update the cached reference
+        await super.changeCurrentPageTo(page);
+    }
+    async activeWindowHandle() {
+        try {
+            return await this.browser.getWindowHandle();
+        }
+        catch (error) {
+            // If the window is closed by user action Webdriver will still hold the reference to the closed window.
+            if (['NoSuchWindowError', 'no such window'].includes(error.name)) {
+                const allHandles = await this.browser.getWindowHandles();
+                if (allHandles.length > 0) {
+                    const handle = allHandles.at(-1);
+                    await this.browser.switchToWindow(handle);
+                    return handle;
+                }
+            }
+            throw error;
+        }
+    }
+    async currentPage() {
+        const actualCurrentPageHandle = await this.activeWindowHandle();
+        const actualCurrentPageId = CorrelationId.fromJSON(actualCurrentPageHandle);
+        if (this.currentBrowserPage && this.currentBrowserPage.id.equals(actualCurrentPageId)) {
+            return this.currentBrowserPage;
+        }
+        // Looks like the actual current page is not what we thought the current page was.
+        // Is it one of the pages we are aware of?
+        const allPages = await this.allPages();
+        const found = allPages.find(page => page.id.equals(actualCurrentPageId));
+        if (found) {
+            this.currentBrowserPage = found;
+            return this.currentBrowserPage;
+        }
+        // OK, so that's a handle that we haven't seen before, let's register it and set as current page.
+        this.currentBrowserPage = await this.registerCurrentPage();
+        return this.currentBrowserPage;
+    }
+    async registerCurrentPage() {
+        const windowHandle = await this.browser.getWindowHandle();
+        const errorHandler = new WebdriverIOErrorHandler();
+        const page = new WebdriverIOPage(this, this.browser, await this.modalDialogHandlerFor(windowHandle, errorHandler), errorHandler, new CorrelationId(windowHandle));
+        this.register(page);
+        return page;
+    }
+    async modalDialogHandlerFor(windowHandle, errorHandler) {
+        return this.browser.isDevTools
+            ? new WebdriverIOPuppeteerModalDialogHandler(await this.puppeteerPageFor(windowHandle))
+            : new WebdriverIOModalDialogHandler(this.browser, errorHandler);
+    }
+    async puppeteerPageFor(windowHandle) {
+        const puppeteer = await this.browser.getPuppeteer();
+        const pages = await puppeteer.pages();
+        const handles = await this.browser.getWindowHandles();
+        if (handles.length !== pages.length) {
+            throw new LogicError(`The number of registered Puppeteer pages doesn't match WebdriverIO window handles`);
+        }
+        const index = handles.indexOf(windowHandle);
+        // We cast to `unknown` first because the version of Page in Puppeteer-core
+        // might be slightly out-of-sync with what the WebdriverIO uses.
+        // This doesn't really matter since we're only using it to work with Dialogs.
+        const page = pages[index];
+        if (!page) {
+            throw new LogicError(`Couldn't find Puppeteer page for WebdriverIO window handle ${windowHandle}`);
+        }
+        return page;
+    }
+    browserCapabilities() {
+        return Promise.resolve(this.browser.capabilities);
+    }
+}
+//# sourceMappingURL=WebdriverIOBrowsingSession.js.map

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

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

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

@@ -0,0 +1,15 @@
+import 'webdriverio';
+import type { CookieData } from '@serenity-js/web';
+import { Cookie } from '@serenity-js/web';
+/**
+ * WebdriverIO-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
+ *
+ * @group Models
+ */
+export declare class WebdriverIOCookie extends Cookie {
+    private readonly browser;
+    constructor(browser: WebdriverIO.Browser, cookieName: string);
+    delete(): Promise<void>;
+    protected read(): Promise<CookieData>;
+}
+//# sourceMappingURL=WebdriverIOCookie.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOCookie.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOCookie.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAsB,MAAM,kBAAkB,CAAC;AAG9D;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,MAAM;IAGrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW,CAAC,OAAO,EAC7C,UAAU,EAAE,MAAM;IAMhB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;cAIb,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;CAwB9C"}

package/esm/screenplay/models/WebdriverIOCookie.js

@@ -0,0 +1,42 @@
+import 'webdriverio';
+import { Timestamp } from '@serenity-js/core';
+import { Cookie, CookieMissingError } from '@serenity-js/web';
+import { ensure, isDefined } from 'tiny-types';
+/**
+ * WebdriverIO-specific implementation of [`Cookie`](https://serenity-js.org/api/web/class/Cookie/).
+ *
+ * @group Models
+ */
+export class WebdriverIOCookie extends Cookie {
+    browser;
+    constructor(browser, cookieName) {
+        super(cookieName);
+        this.browser = browser;
+        ensure('browser', browser, isDefined());
+    }
+    async delete() {
+        await this.browser.deleteCookies(this.cookieName);
+    }
+    async read() {
+        const [cookie] = await this.browser.getCookies(this.cookieName);
+        if (!cookie) {
+            throw new CookieMissingError(`Cookie '${this.cookieName}' not set`);
+        }
+        // There _might_ be a bug in WDIO where the expiry date is set on "expires" rather than the "expiry" key
+        // and possibly another one around deserialising the timestamp, since WDIO seems to add several hundred milliseconds
+        // to the original expiry date
+        const expiry = cookie.expiry || cookie.expires;
+        return {
+            name: cookie.name,
+            value: cookie.value,
+            domain: cookie.domain,
+            path: cookie.path,
+            expiry: typeof expiry === 'number' && expiry >= 0
+                ? Timestamp.fromTimestampInSeconds(Math.round(expiry))
+                : undefined,
+            httpOnly: cookie.httpOnly,
+            secure: cookie.secure,
+        };
+    }
+}
+//# sourceMappingURL=WebdriverIOCookie.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOCookie.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOCookie.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,MAAM;IAGpB;IADrB,YACqB,OAA4B,EAC7C,UAAkB;QAElB,KAAK,CAAC,UAAU,CAAC,CAAC;QAHD,YAAO,GAAP,OAAO,CAAqB;QAI7C,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM;QACR,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAES,KAAK,CAAC,IAAI;QAChB,MAAM,CAAE,MAAM,CAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAElE,IAAI,CAAE,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,kBAAkB,CAAC,WAAY,IAAI,CAAC,UAAW,WAAW,CAAC,CAAC;QAC1E,CAAC;QAED,wGAAwG;QACxG,oHAAoH;QACpH,8BAA8B;QAC9B,MAAM,MAAM,GAAuB,MAAM,CAAC,MAAM,IAAK,MAAc,CAAC,OAAO,CAAC;QAE5E,OAAO;YACH,IAAI,EAAQ,MAAM,CAAC,IAAI;YACvB,KAAK,EAAO,MAAM,CAAC,KAAK;YACxB,MAAM,EAAM,MAAM,CAAC,MAAM;YACzB,IAAI,EAAQ,MAAM,CAAC,IAAI;YACvB,MAAM,EAAM,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC;gBACjD,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtD,CAAC,CAAC,SAAS;YACf,QAAQ,EAAI,MAAM,CAAC,QAAQ;YAC3B,MAAM,EAAM,MAAM,CAAC,MAAM;SAC5B,CAAA;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,9 @@
+import type { WebdriverProtocolErrorCode } from './WebdriverProtocolErrorCode.js';
+export declare class WebdriverIOErrorHandler {
+    private readonly handlers;
+    constructor(handlers?: Map<WebdriverProtocolErrorCode, (error: Error) => Promise<void> | void>);
+    executeIfHandled<T>(error: Error, action: () => Promise<T> | T): Promise<T>;
+    setHandlerFor(errorType: WebdriverProtocolErrorCode, handler: (error: Error) => Promise<void> | void): void;
+    unsetHandlerFor(errorType: WebdriverProtocolErrorCode): void;
+}
+//# sourceMappingURL=WebdriverIOErrorHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOErrorHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,qBAAa,uBAAuB;IAEpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,GAAE,GAAG,CAAC,0BAA0B,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAa;IAGpH,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAUjF,aAAa,CAAC,SAAS,EAAE,0BAA0B,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI3G,eAAe,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI;CAG/D"}

package/esm/screenplay/models/WebdriverIOErrorHandler.js

@@ -0,0 +1,20 @@
+export class WebdriverIOErrorHandler {
+    handlers;
+    constructor(handlers = new Map()) {
+        this.handlers = handlers;
+    }
+    async executeIfHandled(error, action) {
+        if (!this.handlers.has(error.name)) {
+            throw error;
+        }
+        await this.handlers.get(error.name)(error);
+        return action();
+    }
+    setHandlerFor(errorType, handler) {
+        this.handlers.set(errorType, handler);
+    }
+    unsetHandlerFor(errorType) {
+        this.handlers.delete(errorType);
+    }
+}
+//# sourceMappingURL=WebdriverIOErrorHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOErrorHandler.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOErrorHandler.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAuB;IAEH;IAA7B,YAA6B,WAAoF,IAAI,GAAG,EAAE;QAA7F,aAAQ,GAAR,QAAQ,CAAqF;IAC1H,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAI,KAAY,EAAE,MAA4B;QAChE,IAAI,CAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAkC,CAAC,EAAE,CAAC;YAChE,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAkC,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzE,OAAO,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,SAAqC,EAAE,OAA+C;QAChG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,SAAqC;QACjD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;CACJ"}

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

@@ -0,0 +1,27 @@
+import 'webdriverio';
+import type { ModalDialog } from '@serenity-js/web';
+import { ModalDialogHandler } from '@serenity-js/web';
+import type { WebdriverIOErrorHandler } from './WebdriverIOErrorHandler.js';
+/**
+ * WebdriverIO-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/),
+ * used with the [WebDriver protocol](https://webdriver.io/docs/api/webdriver).
+ *
+ * @group Models
+ */
+export declare class WebdriverIOModalDialogHandler extends ModalDialogHandler {
+    private readonly browser;
+    private readonly errorHandler;
+    private readonly defaultHandler;
+    private currentHandler;
+    constructor(browser: WebdriverIO.Browser, errorHandler: WebdriverIOErrorHandler);
+    tryToHandleDialog(): Promise<void>;
+    acceptNext(): Promise<void>;
+    acceptNextWithValue(text: string | number): Promise<void>;
+    dismissNext(): Promise<void>;
+    reset(): Promise<void>;
+    /**
+     * @override
+     */
+    last(): Promise<ModalDialog>;
+}
+//# sourceMappingURL=WebdriverIOModalDialogHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOModalDialogHandler.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOModalDialogHandler.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAgE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEpH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,kBAAkB;IAc7D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAbjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAO1B;IAEL,OAAO,CAAC,cAAc,CAAsB;gBAGvB,OAAO,EAAE,WAAW,CAAC,OAAO,EAC5B,YAAY,EAAE,uBAAuB;IASpD,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;CAQrC"}

package/esm/screenplay/models/WebdriverIOModalDialogHandler.js

@@ -0,0 +1,74 @@
+import 'webdriverio';
+import { AbsentModalDialog, AcceptedModalDialog, DismissedModalDialog, ModalDialogHandler } from '@serenity-js/web';
+import { WebdriverProtocolErrorCode } from './WebdriverProtocolErrorCode.js';
+/**
+ * WebdriverIO-specific implementation of [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/),
+ * used with the [WebDriver protocol](https://webdriver.io/docs/api/webdriver).
+ *
+ * @group Models
+ */
+export class WebdriverIOModalDialogHandler extends ModalDialogHandler {
+    browser;
+    errorHandler;
+    defaultHandler = async () => {
+        const message = await this.browser.getAlertText();
+        await this.browser.dismissAlert();
+        this.modalDialog = new DismissedModalDialog(message);
+    };
+    currentHandler;
+    constructor(browser, errorHandler) {
+        super();
+        this.browser = browser;
+        this.errorHandler = errorHandler;
+        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,50 @@
+import 'webdriverio';
+import type { CorrelationId } from '@serenity-js/core/lib/model/index.js';
+import type { Cookie, CookieData, ModalDialogHandler, PageElements, Selector } from '@serenity-js/web';
+import { Key, Page, PageElement } from '@serenity-js/web';
+import { URL } from 'url';
+import type { WebdriverIOBrowsingSession } from './WebdriverIOBrowsingSession.js';
+import type { WebdriverIOErrorHandler } from './WebdriverIOErrorHandler.js';
+/**
+ * WebdriverIO-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
+ *
+ * @group Models
+ */
+export declare class WebdriverIOPage extends Page<WebdriverIO.Element> {
+    private readonly browser;
+    private readonly errorHandler;
+    private lastScriptExecutionSummary;
+    private dehydrator;
+    constructor(session: WebdriverIOBrowsingSession, browser: WebdriverIO.Browser, modalDialogHandler: ModalDialogHandler, errorHandler: WebdriverIOErrorHandler, pageId: CorrelationId);
+    createPageElement(nativeElement: WebdriverIO.Element): PageElement<WebdriverIO.Element>;
+    locate(selector: Selector): PageElement<WebdriverIO.Element>;
+    locateAll(selector: Selector): PageElements<WebdriverIO.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,219 @@
+import 'webdriverio';
+import { List, LogicError } from '@serenity-js/core';
+import { ArgumentDehydrator, BrowserWindowClosedError, ByCss, Key, Page, PageElement, PageElementsLocator } from '@serenity-js/web';
+import * as scripts from '@serenity-js/web/lib/scripts/index.js';
+import { URL } from 'url';
+import { WebdriverIOExistingElementLocator, WebdriverIOLocator, WebdriverIORootLocator } from './locators/index.js';
+import { WebdriverIOCookie } from './WebdriverIOCookie.js';
+import { WebdriverIOPageElement } from './WebdriverIOPageElement.js';
+/**
+ * WebdriverIO-specific implementation of [`Page`](https://serenity-js.org/api/web/class/Page/).
+ *
+ * @group Models
+ */
+export class WebdriverIOPage extends Page {
+    browser;
+    errorHandler;
+    lastScriptExecutionSummary;
+    /* eslint-disable unicorn/consistent-function-scoping */
+    dehydrator = new ArgumentDehydrator((item) => item instanceof PageElement, (item) => item.nativeElement());
+    /* eslint-enable */
+    constructor(session, browser, modalDialogHandler, errorHandler, pageId) {
+        super(session, new WebdriverIORootLocator(browser), modalDialogHandler, pageId);
+        this.browser = browser;
+        this.errorHandler = errorHandler;
+    }
+    createPageElement(nativeElement) {
+        return new WebdriverIOPageElement(new WebdriverIOExistingElementLocator(this.rootLocator, new ByCss(String(nativeElement.selector)), this.errorHandler, nativeElement));
+    }
+    locate(selector) {
+        return new WebdriverIOPageElement(new WebdriverIOLocator(this.rootLocator, selector, this.errorHandler));
+    }
+    locateAll(selector) {
+        return List.of(new PageElementsLocator(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 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 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.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(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);
+        }
+    }
+}
+/**
+ * @package
+ */
+class LastScriptExecutionSummary {
+    result;
+    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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"}