@serenity-js/webdriverio 3.1.6 → 3.2.1

package/esm/adapter/reporter/TagPrinter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagPrinter.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/TagPrinter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,GAAG,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,mBAAmB,GAAG,YAAY,CAAC,eAAe,GAAG,GAAG,EAAE;IAS3F,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,KAAK;CAGhB"}

package/esm/adapter/reporter/TagPrinter.js

@@ -0,0 +1,52 @@
+import { BrowserTag, PlatformTag } from '@serenity-js/core/lib/model/index.js';
+/**
+ * @package
+ */
+export class TagPrinter {
+    tagsFor(capability) {
+        const desiredCapabilities = this.desired(capability);
+        return [
+            this.browserTagFor(desiredCapabilities),
+            this.platformTagFor(desiredCapabilities),
+        ];
+    }
+    browserTagFor(capabilities) {
+        return new BrowserTag(this.browserNameFrom(capabilities), this.browserVersionFrom(capabilities));
+    }
+    platformTagFor(capabilities) {
+        return new PlatformTag(this.platformNameFrom(capabilities), this.platformVersionFrom(capabilities));
+    }
+    browserNameFrom(capabilities) {
+        return capabilities.browserName
+            || capabilities.browser
+            || (capabilities['appium:app'] && capabilities['appium:app'].replace('sauce-storage:', ''))
+            || 'unknown';
+    }
+    browserVersionFrom(capabilities) {
+        return capabilities.deviceName // mobile web
+            || capabilities['appium:deviceName']
+            || capabilities.browserVersion // W3C format
+            || capabilities.version // JSONWP format
+            || capabilities.browser_version; // BrowserStack
+    }
+    platformNameFrom(capabilities) {
+        return capabilities.platformName
+            || capabilities['appium:platformName']
+            || capabilities.platform
+            || capabilities.os
+            || 'unknown';
+    }
+    platformVersionFrom(capabilities) {
+        return capabilities['appium:platformVersion']
+            || capabilities.os_version;
+    }
+    desired(capabilities) {
+        return this.isW3C(capabilities)
+            ? capabilities.alwaysMatch
+            : capabilities;
+    }
+    isW3C(capabilities) {
+        return !!capabilities.alwaysMatch;
+    }
+}
+//# sourceMappingURL=TagPrinter.js.map

package/esm/adapter/reporter/TagPrinter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagPrinter.js","sourceRoot":"","sources":["../../../src/adapter/reporter/TagPrinter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAO,MAAM,sCAAsC,CAAC;AAGpF;;GAEG;AACH,MAAM,OAAO,UAAU;IACnB,OAAO,CAAC,UAA2E;QAC/E,MAAM,mBAAmB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAErD,OAAO;YACH,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC;SAC3C,CAAC;IACN,CAAC;IAEO,aAAa,CAAC,YAA8C;QAChE,OAAO,IAAI,UAAU,CACjB,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAClC,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CACxC,CAAC;IACN,CAAC;IAEO,cAAc,CAAC,YAA8C;QACjE,OAAO,IAAI,WAAW,CAClB,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EACnC,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CACzC,CAAC;IACN,CAAC;IAEO,eAAe,CAAC,YAA8C;QAClE,OAAO,YAAY,CAAC,WAAW;eACxB,YAAY,CAAC,OAAO;eACpB,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;eACxF,SAAS,CAAC;IACrB,CAAC;IAEO,kBAAkB,CAAC,YAA8C;QACrE,OAAO,YAAY,CAAC,UAAU,CAAU,aAAa;eAC9C,YAAY,CAAC,mBAAmB,CAAC;eACjC,YAAY,CAAC,cAAc,CAAM,aAAa;eAC9C,YAAY,CAAC,OAAO,CAAa,gBAAgB;eACjD,YAAY,CAAC,eAAe,CAAC,CAAI,eAAe;IAC3D,CAAC;IAEO,gBAAgB,CAAC,YAA8C;QACnE,OAAO,YAAY,CAAC,YAAY;eACzB,YAAY,CAAC,qBAAqB,CAAC;eACnC,YAAY,CAAC,QAAQ;eACrB,YAAY,CAAC,EAAE;eACf,SAAS,CAAC;IACrB,CAAC;IAEO,mBAAmB,CAAC,YAA8C;QACtE,OAAO,YAAY,CAAC,wBAAwB,CAAC;eACtC,YAAY,CAAC,UAAU,CAAC;IACnC,CAAC;IAEO,OAAO,CAAC,YAA2C;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;YAC3B,CAAC,CAAC,YAAY,CAAC,WAAW;YAC1B,CAAC,CAAC,YAAY,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,YAA2C;QACrD,OAAO,CAAC,CAAE,YAA6C,CAAC,WAAW,CAAC;IACxE,CAAC;CACJ"}

package/esm/adapter/reporter/index.d.ts

@@ -0,0 +1,6 @@
+export * from './BrowserCapabilitiesReporter.js';
+export * from './InitialisesReporters.js';
+export * from './OutputStreamBuffer.js';
+export * from './ProvidesWriteStream.js';
+export * from './TagPrinter.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/adapter/reporter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapter/reporter/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/esm/adapter/reporter/index.js

@@ -0,0 +1,6 @@
+export * from './BrowserCapabilitiesReporter.js';
+export * from './InitialisesReporters.js';
+export * from './OutputStreamBuffer.js';
+export * from './ProvidesWriteStream.js';
+export * from './TagPrinter.js';
+//# sourceMappingURL=index.js.map

package/esm/adapter/reporter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapter/reporter/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/esm/api.d.ts

@@ -0,0 +1,3 @@
+export { WebdriverIOConfig } from './config/index.js';
+export * from './screenplay/index.js';
+//# sourceMappingURL=api.d.ts.map

package/esm/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,cAAc,uBAAuB,CAAC"}

package/esm/api.js

@@ -0,0 +1,2 @@
+export * from './screenplay/index.js';
+//# sourceMappingURL=api.js.map

package/esm/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAC"}

package/esm/config/WebdriverIOConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOConfig.d.ts","sourceRoot":"","sources":["../../src/config/WebdriverIOConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4GG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,UAAU;IAEzD;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,cAAc,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD"}

package/esm/config/WebdriverIOConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WebdriverIOConfig.js.map

package/esm/config/WebdriverIOConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebdriverIOConfig.js","sourceRoot":"","sources":["../../src/config/WebdriverIOConfig.ts"],"names":[],"mappings":""}

package/esm/config/index.d.ts

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

package/esm/config/index.d.ts.map

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

package/esm/config/index.js

@@ -0,0 +1,2 @@
+export * from './WebdriverIOConfig.js';
+//# sourceMappingURL=index.js.map

package/esm/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/esm/index.d.ts

@@ -0,0 +1,16 @@
+import { Capabilities } from '@wdio/types';
+import { EventEmitter } from 'events';
+import { InitialisesReporters, ProvidesWriteStream } from './adapter/reporter/index.js';
+import { WebdriverIOConfig } from './config/index.js';
+/**
+ * WebdriverIO Framework Adapter integrates WebdriverIO with Serenity/JS
+ */
+declare const _default: {
+    init(cid: string, config: WebdriverIOConfig, specs: string[], capabilities: Capabilities.RemoteCapability, reporter: EventEmitter & ProvidesWriteStream & InitialisesReporters): Promise<{
+        hasTests: () => boolean;
+        run: () => Promise<number>;
+    }>;
+};
+export default _default;
+export * from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;GAEG;;cAGU,MAAM,UACH,iBAAiB,SAClB,MAAM,EAAE,gBACD,aAAa,gBAAgB,YACjC,YAAY,GAAG,mBAAmB,GAAG,oBAAoB,GACpE,QAAQ;QAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,QAAQ,MAAM,CAAC,CAAA;KAAE,CAAC;;AAPvE,wBAkBE;AAEF,cAAc,UAAU,CAAC"}

package/esm/index.js

@@ -0,0 +1,14 @@
+import { serenity } from '@serenity-js/core';
+import { ModuleLoader, Path } from '@serenity-js/core/lib/io/index.js';
+/**
+ * WebdriverIO Framework Adapter integrates WebdriverIO with Serenity/JS
+ */
+export default {
+    async init(cid, config, specs, capabilities, reporter) {
+        const { WebdriverIOFrameworkAdapterFactory } = await import('./adapter/index.js');
+        const adapterFactory = new WebdriverIOFrameworkAdapterFactory(serenity, new ModuleLoader(process.cwd()), Path.from(process.cwd()));
+        return adapterFactory.init(cid, config, specs, capabilities, reporter);
+    }
+};
+export * from './api.js';
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAOvE;;GAEG;AACH,eAAe;IACX,KAAK,CAAC,IAAI,CACN,GAAW,EACX,MAAyB,EACzB,KAAe,EACf,YAA2C,EAC3C,QAAmE;QAEnE,MAAM,EAAE,kCAAkC,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAElF,MAAM,cAAc,GAAG,IAAI,kCAAkC,CACzD,QAAQ,EACR,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAC/B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAC3B,CAAC;QAEF,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3E,CAAC;CACJ,CAAC;AAEF,cAAc,UAAU,CAAC"}

package/esm/screenplay/abilities/BrowseTheWebWithWebdriverIO.d.ts

@@ -0,0 +1,42 @@
+import { BrowserCapabilities, BrowseTheWeb } from '@serenity-js/web';
+import type { Browser, Element } from 'webdriverio';
+/**
+ * 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/).
+ *
+ * ## Using WebdriverIO to `BrowseTheWeb`
+ *
+ * ```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 HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
+ *
+ * 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')),
+ *   );
+ * ```
+ *
+ * ## Learn more
+ * - [WebdriverIO website](https://webdriver.io/)
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink Ability}
+ * - {@apilink Actor}
+ *
+ * @group Abilities
+ */
+export declare class BrowseTheWebWithWebdriverIO extends BrowseTheWeb<Element> {
+    protected readonly browser: Browser;
+    static using(browserInstance: Browser): BrowseTheWebWithWebdriverIO;
+    constructor(browser: Browser);
+    browserCapabilities(): Promise<BrowserCapabilities>;
+}
+//# sourceMappingURL=BrowseTheWebWithWebdriverIO.d.ts.map

package/esm/screenplay/abilities/BrowseTheWebWithWebdriverIO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowseTheWebWithWebdriverIO.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithWebdriverIO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,2BAA4B,SAAQ,YAAY,CAAC,OAAO,CAAC;IAMtD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAJ/C,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,GAAG,2BAA2B;gBAIpC,OAAO,EAAE,OAAO;IAI/C,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAGtD"}

package/esm/screenplay/abilities/BrowseTheWebWithWebdriverIO.js

@@ -0,0 +1,48 @@
+import { BrowseTheWeb } from '@serenity-js/web';
+import { WebdriverIOBrowsingSession } from '../models/index.js';
+/**
+ * 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/).
+ *
+ * ## Using WebdriverIO to `BrowseTheWeb`
+ *
+ * ```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 HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
+ *
+ * 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')),
+ *   );
+ * ```
+ *
+ * ## Learn more
+ * - [WebdriverIO website](https://webdriver.io/)
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink Ability}
+ * - {@apilink Actor}
+ *
+ * @group Abilities
+ */
+export class BrowseTheWebWithWebdriverIO extends BrowseTheWeb {
+    static using(browserInstance) {
+        return new BrowseTheWebWithWebdriverIO(browserInstance);
+    }
+    constructor(browser) {
+        super(new WebdriverIOBrowsingSession(browser));
+        this.browser = browser;
+    }
+    browserCapabilities() {
+        return Promise.resolve(this.browser.capabilities);
+    }
+}
+//# sourceMappingURL=BrowseTheWebWithWebdriverIO.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrowseTheWebWithWebdriverIO.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithWebdriverIO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,2BAA4B,SAAQ,YAAqB;IAElE,MAAM,CAAC,KAAK,CAAC,eAAwB;QACjC,OAAO,IAAI,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,YAA+B,OAAgB;QAC3C,KAAK,CAAC,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;QADpB,YAAO,GAAP,OAAO,CAAS;IAE/C,CAAC;IAED,mBAAmB;QACf,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAmC,CAAC,CAAC;IAC7E,CAAC;CACJ"}

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

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

package/esm/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,kCAAkC,CAAC"}

package/esm/screenplay/abilities/index.js

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

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

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

package/esm/screenplay/index.d.ts

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

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

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

package/esm/screenplay/index.js

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

package/esm/screenplay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/screenplay/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,24 @@
+import { BrowsingSession } from '@serenity-js/web';
+import type { Browser } from 'webdriverio';
+import { WebdriverIOPage } from '../models/index.js';
+/**
+ * WebdriverIO-specific implementation of {@apilink BrowsingSession}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOBrowsingSession extends BrowsingSession<WebdriverIOPage> {
+    protected readonly browser: Browser;
+    constructor(browser: Browser);
+    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/esm/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,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,eAAe,CAAC,eAAe,CAAC;IAEhE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;gBAAhB,OAAO,EAAE,OAAO;IAQzC,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/esm/screenplay/models/WebdriverIOBrowsingSession.js

@@ -0,0 +1,121 @@
+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 {@apilink BrowsingSession}.
+ *
+ * @group Models
+ */
+export class WebdriverIOBrowsingSession extends BrowsingSession {
+    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();
+    }
+    /**
+     * @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 = 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;
+    }
+}
+//# 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,14 @@
+import { Cookie, CookieData } from '@serenity-js/web';
+import type { Browser } from 'webdriverio';
+/**
+ * WebdriverIO-specific implementation of {@apilink Cookie}.
+ *
+ * @group Models
+ */
+export declare class WebdriverIOCookie extends Cookie {
+    private readonly browser;
+    constructor(browser: 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":"AACA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,MAAM;IAGrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO,EACjC,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,40 @@
+import { Timestamp } from '@serenity-js/core';
+import { Cookie, CookieMissingError } from '@serenity-js/web';
+import { ensure, isDefined } from 'tiny-types';
+/**
+ * WebdriverIO-specific implementation of {@apilink Cookie}.
+ *
+ * @group Models
+ */
+export class WebdriverIOCookie extends Cookie {
+    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,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAc,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,MAAM;IAEzC,YACqB,OAAgB,EACjC,UAAkB;QAElB,KAAK,CAAC,UAAU,CAAC,CAAC;QAHD,YAAO,GAAP,OAAO,CAAS;QAIjC,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;YACV,MAAM,IAAI,kBAAkB,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,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 { 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,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,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,19 @@
+export class WebdriverIOErrorHandler {
+    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;IAEhC,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;YAC/D,MAAM,KAAK,CAAC;SACf;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,29 @@
+import { ModalDialog, ModalDialogHandler } from '@serenity-js/web';
+import type { Browser } from 'webdriverio';
+import { WebdriverIOErrorHandler } from './WebdriverIOErrorHandler.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 declare class WebdriverIOModalDialogHandler extends ModalDialogHandler {
+    private readonly browser;
+    private readonly errorHandler;
+    private readonly defaultHandler;
+    private currentHandler;
+    constructor(browser: 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,EAAgE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACjI,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE;;;;;;;;GAQG;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,OAAO,EAChB,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"}