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

package/lib/screenplay/abilities/BrowseTheWebWithWebdriverIO.js

@@ -1,319 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BrowseTheWebWithWebdriverIO = void 0;
-const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const models_1 = require("../models");
-const locators_1 = require("../models/locators");
 /**
- * @desc
- *  An {@link @serenity-js/core/lib/screenplay~Ability} that enables the {@link @serenity-js/core/lib/screenplay/actor~Actor}
- *  to interact with Web apps using [WebdriverIO](https://webdriver.io/).
+ * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
+ * enables the {@apilink Actor} to interact with web front-ends using [WebdriverIO](https://webdriver.io/).
  *
- *  *Please note*: this class is still marked as experimental while new WebdriverIO Interactions and Questions are being developed.
- *  This means that its interface can change without affecting the major version of Serenity/JS itself.
- *  In particular, please don't rely on the `browser` field to remain `public` in future releases.
+ * ## Using WebdriverIO to `BrowseTheWeb`
  *
- * @example <caption>Using the WebdriverIO browser</caption>
- *  import { Actor } from '@serenity-js/core';
- *  import { BrowseTheWeb, by, Navigate, Target } from '@serenity-js/webdriverio'
- *  import { Ensure, equals } from '@serenity-js/assertions';
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { BrowseTheWebWithWebdriverIO } from '@serenity-js/webdriverio'
+ * import { By, Navigate, PageElement, Text } from '@serenity-js/web'
+ * import { Ensure, equals } from '@serenity-js/assertions'
  *
- *  const actor = Actor.named('Wendy').whoCan(
- *      BrowseTheWeb.using(browser),
- *  );
+ * const HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
  *
- *  const HomePage = {
- *      Title: Target.the('title').located(by.css('h1')),
- *  };
+ * await actorCalled('Wendy')
+ *   .whoCan(BrowseTheWebWithWebdriverIO.using(browser))  // `browser` is global in WebdriverIO tests
+ *   .attemptsTo(
+ *     Navigate.to(`https://serenity-js.org`),
+ *     Ensure.that(Text.of(HomePage.title()), equals('Serenity/JS')),
+ *   );
+ * ```
  *
- *  actor.attemptsTo(
- *      Navigate.to(`https://serenity-js.org`),
- *      Ensure.that(Text.of(HomePage.Title), equals('Serenity/JS')),
- *  );
+ * ## Learn more
+ * - [WebdriverIO website](https://webdriver.io/)
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink Ability}
+ * - {@apilink Actor}
  *
- * @see https://webdriver.io/
- *
- * @public
- * @implements {@serenity-js/core/lib/screenplay~Ability}
- * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
+ * @group Abilities
  */
 class BrowseTheWebWithWebdriverIO extends web_1.BrowseTheWeb {
-    /**
-     * @param {@wdio/types~Browser} browser
-     */
-    constructor(browser) {
-        super(new Map()
-            .set(web_1.ByCss, (selector) => locators_1.WebdriverIOLocator.createRootLocator(this.browser, selector, selector.value))
-            .set(web_1.ByCssContainingText, (selector) => locators_1.WebdriverIOLocator.createRootLocator(this.browser, selector, `${selector.value}*=${selector.text}`))
-            .set(web_1.ById, (selector) => locators_1.WebdriverIOLocator.createRootLocator(this.browser, selector, `#${selector.value}`))
-            .set(web_1.ByTagName, (selector) => locators_1.WebdriverIOLocator.createRootLocator(this.browser, selector, `<${selector.value} />`))
-            .set(web_1.ByXPath, (selector) => locators_1.WebdriverIOLocator.createRootLocator(this.browser, selector, selector.value)));
-        this.browser = browser;
-        if (!this.browser.$ || !this.browser.$$) {
-            throw new core_1.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?`);
-        }
-    }
-    /**
-     * @param {@wdio/types~Browser} browserInstance
-     * @returns {BrowseTheWebWithWebdriverIO}
-     */
     static using(browserInstance) {
         return new BrowseTheWebWithWebdriverIO(browserInstance);
     }
+    constructor(browser) {
+        super(new models_1.WebdriverIOBrowsingSession(browser));
+        this.browser = browser;
+    }
     browserCapabilities() {
         return Promise.resolve(this.browser.capabilities);
     }
-    async cookie(name) {
-        return new models_1.WebdriverIOCookie(this.browser, name);
-    }
-    async setCookie(cookieData) {
-        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,
-        });
-    }
-    deleteAllCookies() {
-        return this.browser.deleteCookies();
-    }
-    /**
-     * @desc
-     *  Navigate to a given destination, specified as an absolute URL
-     *  or a path relative to WebdriverIO `baseUrl`.
-     *
-     * @param {string} destination
-     * @returns {Promise<void>}
-     */
-    navigateTo(destination) {
-        return this.browser.url(destination); // todo: check if this returns a string or is mistyped
-    }
-    navigateBack() {
-        return this.browser.back();
-    }
-    navigateForward() {
-        return this.browser.forward();
-    }
-    reloadPage() {
-        return this.browser.refresh();
-    }
-    /**
-     * @desc
-     *  Returns a {@link Page} representing the currently active top-level browsing context.
-     *
-     * @returns {Promise<Page>}
-     */
-    async currentPage() {
-        const windowHandle = await this.browser.getWindowHandle();
-        return new models_1.WebdriverIOPage(this.browser, windowHandle);
-    }
-    /**
-     * @desc
-     *  Returns an array of {@link Page} objects representing all the available
-     *  top-level browsing context, e.g. all the open browser tabs.
-     *
-     * @returns {Promise<Array<Page>>}
-     */
-    async allPages() {
-        const windowHandles = await this.browser.getWindowHandles();
-        return windowHandles.map(windowHandle => new models_1.WebdriverIOPage(this.browser, windowHandle));
-    }
-    async modalDialog() {
-        return new models_1.WebdriverIOModalDialog(this.browser);
-    }
-    // todo: remove
-    switchToFrame(targetOrIndex) {
-        throw new Error('Not implemented, yet');
-    }
-    // todo: remove
-    switchToParentFrame() {
-        throw new Error('Not implemented, yet');
-    }
-    // todo: remove
-    switchToDefaultContent() {
-        throw new Error('Not implemented, yet');
-    }
-    /**
-     * @desc
-     *  Send a sequence of {@link Key} strokes to the active element.
-     *
-     * @param {Array<Key | string>} keys
-     *  Keys to enter
-     *
-     * @returns {Promise<void>}
-     *
-     * @see https://webdriver.io/docs/api/browser/keys/
-     */
-    sendKeys(keys) {
-        const keySequence = keys.map(key => {
-            if (!web_1.Key.isKey(key)) {
-                return key;
-            }
-            if (this.browser.isDevTools) {
-                return key.devtoolsName;
-            }
-            return key.utf16codePoint;
-        });
-        return this.browser.keys(keySequence);
-    }
-    /**
-     * @desc
-     *  Take a screenshot of the top-level browsing context's viewport.
-     *
-     * @return {Promise<string>}
-     *  A promise that will resolve to a base64-encoded screenshot PNG
-     */
-    takeScreenshot() {
-        return this.browser.takeScreenshot();
-    }
-    /**
-     * @desc
-     *  Schedules a command to execute JavaScript in the context of the currently selected frame or window.
-     *  The script fragment will be executed as the body of an anonymous function.
-     *  If the script is provided as a function object, that function will be converted to a string for injection
-     *  into the target window.
-     *
-     *  Any arguments provided in addition to the script will be included as script arguments and may be referenced
-     *  using the `arguments` object. Arguments may be a `boolean`, `number`, `string` or `WebElement`.
-     *  Arrays and objects may also be used as script arguments as long as each item adheres
-     *  to the types previously mentioned.
-     *
-     *  The script may refer to any variables accessible from the current window.
-     *  Furthermore, the script will execute in the window's context, thus `document` may be used to refer
-     *  to the current document. Any local variables will not be available once the script has finished executing,
-     *  though global variables will persist.
-     *
-     *  If the script has a return value (i.e. if the script contains a `return` statement),
-     *  then the following steps will be taken for resolving this functions return value:
-     *
-     *  For a HTML element, the value will resolve to a WebElement
-     *  - Null and undefined return values will resolve to null
-     *  - Booleans, numbers, and strings will resolve as is
-     *  - Functions will resolve to their string representation
-     *  - For arrays and objects, each member item will be converted according to the rules above
-     *
-     * @example <caption>Perform a sleep in the browser under test</caption>
-     * BrowseTheWeb.as(actor).executeAsyncScript(`
-     *   return arguments[0].tagName;
-     * `, Target.the('header').located(by.css(h1))
-     *
-     * @see https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeScript-java.lang.String-java.lang.Object...-
-     *
-     * @param {string | Function} script
-     * @param {any[]} args
-     *
-     * @returns {Promise<any>}
-     *
-     * @see {@link BrowseTheWeb#getLastScriptExecutionResult}
-     */
-    async executeScript(script, ...args) {
-        const nativeArguments = await Promise.all(args.map(arg => arg instanceof models_1.WebdriverIOPageElement ? arg.nativeElement() : arg));
-        return this.browser.execute(script, ...nativeArguments)
-            .then(result => {
-            this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
-            return result;
-        });
-    }
-    /**
-     * @desc
-     *  Schedules a command to execute asynchronous JavaScript in the context of the currently selected frame or window.
-     *  The script fragment will be executed as the body of an anonymous function.
-     *  If the script is provided as a function object, that function will be converted to a string for injection
-     *  into the target window.
-     *
-     *  Any arguments provided in addition to the script will be included as script arguments and may be referenced
-     *  using the `arguments` object. Arguments may be a `boolean`, `number`, `string` or `WebElement`
-     *  Arrays and objects may also be used as script arguments as long as each item adheres
-     *  to the types previously mentioned.
-     *
-     *  Unlike executing synchronous JavaScript with {@link BrowseTheWebWithWebdriverIO#executeScript},
-     *  scripts executed with this function must explicitly signal they are finished by invoking the provided callback.
-     *
-     *  This callback will always be injected into the executed function as the last argument,
-     *  and thus may be referenced with `arguments[arguments.length - 1]`.
-     *
-     *  The following steps will be taken for resolving this functions return value against
-     *  the first argument to the script's callback function:
-     *
-     *  - For a HTML element, the value will resolve to a WebElement
-     *  - Null and undefined return values will resolve to null
-     *  - Booleans, numbers, and strings will resolve as is
-     *  - Functions will resolve to their string representation
-     *  - For arrays and objects, each member item will be converted according to the rules above
-     *
-     * @example <caption>Perform a sleep in the browser under test</caption>
-     * BrowseTheWeb.as(actor).executeAsyncScript(`
-     *   var delay    = arguments[0];
-     *   var callback = arguments[arguments.length - 1];
-     *
-     *   window.setTimeout(callback, delay);
-     * `, 500)
-     *
-     * @example <caption>Return a value asynchronously</caption>
-     * BrowseTheWeb.as(actor).executeAsyncScript(`
-     *   var callback = arguments[arguments.length - 1];
-     *
-     *   callback('some return value')
-     * `).then(value => doSomethingWithThe(value))
-     *
-     * @see https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeAsyncScript-java.lang.String-java.lang.Object...-
-     *
-     * @param {string|Function} script
-     * @param {any[]} args
-     *
-     * @returns {Promise<any>}
-     *
-     * @see {@link BrowseTheWeb#getLastScriptExecutionResult}
-     */
-    async executeAsyncScript(script, ...args) {
-        const nativeArguments = await Promise.all(args.map(arg => arg instanceof models_1.WebdriverIOPageElement ? arg.nativeElement() : arg));
-        return this.browser.executeAsync(script, ...nativeArguments)
-            .then(result => {
-            this.lastScriptExecutionSummary = new LastScriptExecutionSummary(result);
-            return result;
-        });
-    }
-    /**
-     * @desc
-     *  Returns the last result of calling {@link BrowseTheWebWithWebdriverIO#executeAsyncScript}
-     *  or {@link BrowseTheWebWithWebdriverIO#executeScript}
-     *
-     * @returns {any}
-     */
-    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
-            ? this.lastScriptExecutionSummary.result
-            : undefined;
-    }
-    waitFor(duration) {
-        return this.browser.pause(duration.inMilliseconds());
-    }
-    waitUntil(condition, timeout) {
-        return this.browser.waitUntil(condition, {
-            timeout: timeout.inMilliseconds(),
-            timeoutMsg: `Wait timed out after ${timeout}`,
-        });
-    }
 }
 exports.BrowseTheWebWithWebdriverIO = BrowseTheWebWithWebdriverIO;
-/**
- * @package
- */
-class LastScriptExecutionSummary {
-    constructor(result) {
-        this.result = result;
-    }
-}
 //# sourceMappingURL=BrowseTheWebWithWebdriverIO.js.map

package/lib/screenplay/abilities/BrowseTheWebWithWebdriverIO.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrowseTheWebWithWebdriverIO.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithWebdriverIO.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BrowseTheWebWithWebdriverIO.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithWebdriverIO.ts"],"names":[],"mappings":";;;AAAA,0CAAqE;AAGrE,sCAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAa,2BAA4B,SAAQ,kBAAmC;IAEhF,MAAM,CAAC,KAAK,CAAC,eAAsC;QAC/C,OAAO,IAAI,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,YAA+B,OAA8B;QACzD,KAAK,CAAC,IAAI,mCAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QADpB,YAAO,GAAP,OAAO,CAAuB;IAE7D,CAAC;IAED,mBAAmB;QACf,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAmC,CAAC,CAAC;IAC7E,CAAC;CACJ;AAbD,kEAaC"}

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

@@ -1 +1,2 @@
 export * from './BrowseTheWebWithWebdriverIO';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC"}

package/lib/screenplay/abilities/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];

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C"}

package/lib/screenplay/index.d.ts

@@ -1,2 +1,3 @@
 export * from './abilities';
 export * from './models';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/lib/screenplay/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];

package/lib/screenplay/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,2CAAyB"}

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

@@ -0,0 +1,24 @@
+import { BrowsingSession } from '@serenity-js/web';
+import * as wdio from 'webdriverio';
+import { WebdriverIOPage } from '../models';
+/**
+ * WebdriverIO-specific implementation of {@apilink BrowsingSession}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOBrowsingSession extends BrowsingSession<WebdriverIOPage> {
+    protected readonly browser: wdio.Browser<'async'>;
+    constructor(browser: wdio.Browser<'async'>);
+    allPages(): Promise<Array<WebdriverIOPage>>;
+    /**
+     * @override
+     * @param page
+     */
+    changeCurrentPageTo(page: WebdriverIOPage): Promise<void>;
+    private activeWindowHandle;
+    currentPage(): Promise<WebdriverIOPage>;
+    protected registerCurrentPage(): Promise<WebdriverIOPage>;
+    private modalDialogHandlerFor;
+    private puppeteerPageFor;
+}
+//# sourceMappingURL=WebdriverIOBrowsingSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOBrowsingSession.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOBrowsingSession.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAsB,MAAM,kBAAkB,CAAC;AAEvE,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAK5C;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,eAAe,CAAC,eAAe,CAAC;IAEhE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBAA9B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAQvD,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IA8BjD;;;OAGG;IACG,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAoBjD,kBAAkB;IAmBjB,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC;cAwBtC,mBAAmB,IAAI,OAAO,CAAC,eAAe,CAAC;YAkBjD,qBAAqB;YAMrB,gBAAgB;CAuBjC"}

package/lib/screenplay/models/WebdriverIOBrowsingSession.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebdriverIOBrowsingSession = void 0;
+const core_1 = require("@serenity-js/core");
+const model_1 = require("@serenity-js/core/lib/model");
+const web_1 = require("@serenity-js/web");
+const models_1 = require("../models");
+const WebdriverIOErrorHandler_1 = require("./WebdriverIOErrorHandler");
+const WebdriverIOModalDialogHandler_1 = require("./WebdriverIOModalDialogHandler");
+const WebdriverIOPuppeteerModalDialogHandler_1 = require("./WebdriverIOPuppeteerModalDialogHandler");
+/**
+ * WebdriverIO-specific implementation of {@apilink BrowsingSession}.
+ *
+ * @group Models
+ */
+class WebdriverIOBrowsingSession extends web_1.BrowsingSession {
+    constructor(browser) {
+        super();
+        this.browser = browser;
+        if (!browser.$ || !browser.$$) {
+            throw new core_1.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_1.WebdriverIOErrorHandler();
+            this.register(new models_1.WebdriverIOPage(this, this.browser, await this.modalDialogHandlerFor(newlyOpenedWindowHandle, errorHandler), errorHandler, new model_1.CorrelationId(newlyOpenedWindowHandle)));
+        }
+        return super.allPages();
+    }
+    /**
+     * @override
+     * @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[allHandles.length - 1];
+                    await this.browser.switchToWindow(handle);
+                    return handle;
+                }
+            }
+            throw error;
+        }
+    }
+    async currentPage() {
+        const actualCurrentPageHandle = await this.activeWindowHandle();
+        const actualCurrentPageId = model_1.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_1.WebdriverIOErrorHandler();
+        const page = new models_1.WebdriverIOPage(this, this.browser, await this.modalDialogHandlerFor(windowHandle, errorHandler), errorHandler, new model_1.CorrelationId(windowHandle));
+        this.register(page);
+        return page;
+    }
+    async modalDialogHandlerFor(windowHandle, errorHandler) {
+        return this.browser.isDevTools
+            ? new WebdriverIOPuppeteerModalDialogHandler_1.WebdriverIOPuppeteerModalDialogHandler(await this.puppeteerPageFor(windowHandle))
+            : new WebdriverIOModalDialogHandler_1.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 core_1.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 core_1.LogicError(`Couldn't find Puppeteer page for WebdriverIO window handle ${windowHandle}.`);
+        }
+        return page;
+    }
+}
+exports.WebdriverIOBrowsingSession = WebdriverIOBrowsingSession;
+//# sourceMappingURL=WebdriverIOBrowsingSession.js.map

package/lib/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/lib/screenplay/models/WebdriverIOCookie.d.ts

@@ -1,8 +1,14 @@
 import { Cookie, CookieData } from '@serenity-js/web';
 import * as wdio from 'webdriverio';
+/**
+ * WebdriverIO-specific implementation of {@apilink Cookie}.
+ *
+ * @group Models
+ */
 export declare class WebdriverIOCookie extends Cookie {
     private readonly browser;
     constructor(browser: wdio.Browser<'async'>, cookieName: string);
     delete(): Promise<void>;
     protected read(): Promise<CookieData>;
 }
+//# sourceMappingURL=WebdriverIOCookie.d.ts.map

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

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

package/lib/screenplay/models/WebdriverIOCookie.js

@@ -4,6 +4,11 @@ exports.WebdriverIOCookie = void 0;
 const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const tiny_types_1 = require("tiny-types");
+/**
+ * WebdriverIO-specific implementation of {@apilink Cookie}.
+ *
+ * @group Models
+ */
 class WebdriverIOCookie extends web_1.Cookie {
     constructor(browser, cookieName) {
         super(cookieName);
@@ -11,7 +16,7 @@ class WebdriverIOCookie extends web_1.Cookie {
         (0, tiny_types_1.ensure)('browser', browser, (0, tiny_types_1.isDefined)());
     }
     async delete() {
-        return this.browser.deleteCookies(this.cookieName);
+        await this.browser.deleteCookies(this.cookieName);
     }
     async read() {
         const [cookie] = await this.browser.getCookies(this.cookieName);
@@ -27,7 +32,7 @@ class WebdriverIOCookie extends web_1.Cookie {
             value: cookie.value,
             domain: cookie.domain,
             path: cookie.path,
-            expiry: expiry !== undefined
+            expiry: typeof expiry === 'number' && expiry >= 0
                 ? core_1.Timestamp.fromTimestampInSeconds(Math.round(expiry))
                 : undefined,
             httpOnly: cookie.httpOnly,

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

@@ -1 +1 @@
-{"version":3,"file":"WebdriverIOCookie.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOCookie.ts"],"names":[],"mappings":";;;AAAA,4CAA8C;AAC9C,0CAA0E;AAC1E,2CAA+C;AAG/C,MAAa,iBAAkB,SAAQ,YAAM;IAEzC,YACqB,OAA8B,EAC/C,UAAkB;QAElB,KAAK,CAAC,UAAU,CAAC,CAAC;QAHD,YAAO,GAAP,OAAO,CAAuB;QAI/C,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAkB,CAAC;IACxE,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;YACV,MAAM,IAAI,wBAAkB,CAAC,WAAY,IAAI,CAAC,UAAW,WAAW,CAAC,CAAC;SACzE;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,MAAM,KAAK,SAAS;gBAC5B,CAAC,CAAC,gBAAS,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;AAtCD,8CAsCC"}
+{"version":3,"file":"WebdriverIOCookie.js","sourceRoot":"","sources":["../../../src/screenplay/models/WebdriverIOCookie.ts"],"names":[],"mappings":";;;AAAA,4CAA8C;AAC9C,0CAA0E;AAC1E,2CAA+C;AAG/C;;;;GAIG;AACH,MAAa,iBAAkB,SAAQ,YAAM;IAEzC,YACqB,OAA8B,EAC/C,UAAkB;QAElB,KAAK,CAAC,UAAU,CAAC,CAAC;QAHD,YAAO,GAAP,OAAO,CAAuB;QAI/C,IAAA,mBAAM,EAAC,SAAS,EAAE,OAAO,EAAE,IAAA,sBAAS,GAAE,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;YACV,MAAM,IAAI,wBAAkB,CAAC,WAAY,IAAI,CAAC,UAAW,WAAW,CAAC,CAAC;SACzE;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,gBAAS,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;AAtCD,8CAsCC"}

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

@@ -0,0 +1,9 @@
+import { WebdriverProtocolErrorCode } from './WebdriverProtocolErrorCode';
+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