@serenity-js/web 3.41.1 → 3.42.0

package/esm/stage/crew/photographer/Photographer.js

@@ -0,0 +1,215 @@
+import { ConfigurationError, LogicError } from '@serenity-js/core';
+import { ActivityFinished, ActivityStarts } from '@serenity-js/core/events';
+import * as strategies from './strategies/index.js';
+/**
+ * The Photographer is a [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) who takes screenshots
+ * using the web browser associated with the [actor](https://serenity-js.org/api/core/class/Actor/) that is
+ * currently [in the spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
+ *
+ * ## Registering Photographer programmatically
+ *
+ * ```ts
+ * import { configure, ArtifactArchiver } from '@serenity-js/core'
+ * import { Photographer, TakePhotosOfFailures } from '@serenity-js/web'
+ *
+ * configure({
+ *   crew: [
+ *     ArtifactArchiver.storingArtifactsAt(process.cwd(), 'target/site/serenity'),
+ *     Photographer.whoWill(TakePhotosOfFailures),
+ *   ]
+ * })
+ * ```
+ *
+ * ## Using Photographer with Playwright Test
+ *
+ * ```ts
+ * // playwright.config.ts
+ * import { defineConfig } from '@playwright/test'
+ * import type { SerenityFixtures, SerenityWorkerFixtures } from '@serenity-js/playwright-test'
+ *
+ * export default defineConfig<SerenityFixtures, SerenityWorkerFixtures>({
+ *   reporter: [
+ *       [ '@serenity-js/playwright-test', {
+ *           crew: [
+ *               '@serenity-js/serenity-bdd',
+ *               [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *           ]
+ *           // other Serenity/JS config
+ *       }]
+ *   ],
+ *
+ *   use: {
+ *     crew: [
+ *       [ '@serenity-js/web:Photographer', {
+ *         strategy: 'TakePhotosOfFailures',
+ *         // strategy: 'TakePhotosOfInteractions',
+ *       } ]
+ *     ],
+ *   },
+ * })
+ * ```
+ *
+ * #### Learn more
+ * - [`SerenityFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityFixtures/)
+ * - [`SerenityWorkerFixtures`](https://serenity-js.org/api/playwright-test/interface/SerenityWorkerFixtures/)
+ *
+ * ## Using Photographer with WebdriverIO
+ *
+ * ```ts
+ * // wdio.conf.ts
+ * import { ArtifactArchiver } from '@serenity-js/core'
+ * import { WebdriverIOConfig } from '@serenity-js/webdriverio'
+ *
+ * export const config: WebdriverIOConfig= {
+ *
+ *   // Tell WebdriverIO to use Serenity/JS framework
+ *   framework: '@serenity-js/webdriverio',
+ *
+ *   serenity: {
+ *     // Configure Serenity/JS to use an appropriate test runner adapter
+ *     runner: 'cucumber',
+ *     // runner: 'mocha',
+ *     // runner: 'jasmine',
+ *
+ *     // register custom Actors class to configure your Serenity/JS actors
+ *     actors: new Actors(),
+ *
+ *     // Register StageCrewMembers we've imported at the top of this file
+ *     crew: [
+ *       '@serenity-js/serenity-bdd',
+ *       [ '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *       [ '@serenity-js/web:Photographer', {
+ *         strategy: 'TakePhotosOfFailures',
+ *         // strategy: 'TakePhotosOfInteractions',
+ *       } ]
+ *     ]
+ *   },
+ *
+ *   // ... rest of the config omitted for brevity
+ * }
+ * ```
+ *
+ * ## Using Photographer with Protractor
+ *
+ * ```ts
+ * // protractor.conf.js
+ * exports.config = {
+ *
+ *   // Tell Protractor to use the Serenity/JS framework Protractor Adapter
+ *   framework:      'custom',
+ *   frameworkPath:  require.resolve('@serenity-js/protractor/adapter'),
+ *
+ *   serenity: {
+ *     runner: 'jasmine',
+ *     // runner: 'cucumber',
+ *     // runner: 'mocha',
+ *     crew: [
+ *       @serenity-js/serenity-bdd',
+ *        '@serenity-js/core:ArtifactArchiver', { outputDirectory: 'target/site/serenity' } ],
+ *        '@serenity-js/web:Photographer', {
+ *          strategy: 'TakePhotosOfFailures',
+ *          // strategy: 'TakePhotosOfInteractions',
+ *        ]
+ *     ]
+ *   },
+ *
+ *   // ... rest of the config omitted for brevity
+ * }
+ * ```
+ *
+ * ## Taking photos only upon failures only
+ *
+ * ```ts
+ * import { Photographer, TakePhotosOfFailures } from '@serenity-js/web'
+ *
+ * Photographer.whoWill(TakePhotosOfFailures)
+ * ```
+ *
+ * ## Taking photos of all the interactions
+ *
+ * ```ts
+ * import { Photographer, TakePhotosOfInteractions } from '@serenity-js/web'
+ *
+ * Photographer.whoWill(TakePhotosOfInteractions)
+ * ```
+ *
+ * ## Taking photos before and after all the interactions
+ *
+ * ```ts
+ * import { Photographer, TakePhotosBeforeAndAfterInteractions } from '@serenity-js/web'
+ *
+ * Photographer.whoWill(TakePhotosBeforeAndAfterInteractions)
+ * ```
+ *
+ * ## Learn more
+ * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+ * - [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/)
+ * - [`TakePhotosBeforeAndAfterInteractions`](https://serenity-js.org/api/web/class/TakePhotosBeforeAndAfterInteractions/)
+ * - [`TakePhotosOfFailures`](https://serenity-js.org/api/web/class/TakePhotosOfFailures/)
+ * - [`TakePhotosOfInteractions`](https://serenity-js.org/api/web/class/TakePhotosOfInteractions/)
+ *
+ * @group Stage
+ */
+export class Photographer {
+    photoTakingStrategy;
+    stage;
+    /**
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
+     *
+     * @param strategy
+     *  A no-arg constructor function that instantiates a [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/)
+     */
+    static whoWill(strategy) {
+        return new Photographer(new strategy());
+    }
+    /**
+     * Instantiates a new [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) configured to take photos (screenshots)
+     * as per the specified [`PhotoTakingStrategy`](https://serenity-js.org/api/web/class/PhotoTakingStrategy/).
+     *
+     * @param config
+     */
+    static fromJSON(config) {
+        if (config && config.strategy) {
+            const availableStrategies = Object.keys(strategies).filter(strategy => strategy !== strategies.PhotoTakingStrategy.name); // not the abstract class
+            if (availableStrategies.includes(config.strategy)) {
+                return new Photographer(new strategies[config.strategy]());
+            }
+            throw new ConfigurationError(`'${config.strategy}' is not an available PhotoTakingStrategy, ` +
+                `available strategies: ${availableStrategies.join(', ')}.`);
+        }
+        return new Photographer(new strategies.TakePhotosOfFailures());
+    }
+    constructor(photoTakingStrategy, stage) {
+        this.photoTakingStrategy = photoTakingStrategy;
+        this.stage = stage;
+    }
+    /**
+     * Assigns this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) to a given [`Stage`](https://serenity-js.org/api/core/class/Stage/).
+     *
+     * @param stage
+     *  An instance of a [`Stage`](https://serenity-js.org/api/core/class/Stage/) this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) will be assigned to
+     */
+    assignedTo(stage) {
+        this.stage = stage;
+        return this;
+    }
+    /**
+     * Handles [`DomainEvent`](https://serenity-js.org/api/core-events/class/DomainEvent/) objects emitted by the [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     * this [`StageCrewMember`](https://serenity-js.org/api/core/interface/StageCrewMember/) is assigned to.
+     *
+     * @param event
+     */
+    notifyOf(event) {
+        if (!this.stage) {
+            throw new LogicError(`Photographer needs to be assigned to the Stage before it can be notified of any DomainEvents`);
+        }
+        if (!this.stage.theShowHasStarted()) {
+            return void 0;
+        }
+        if (event instanceof ActivityStarts || event instanceof ActivityFinished) {
+            this.photoTakingStrategy.considerTakingPhoto(event, this.stage);
+        }
+    }
+}
+//# sourceMappingURL=Photographer.js.map

package/esm/stage/crew/photographer/Photographer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Photographer.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoJG;AACH,MAAM,OAAO,YAAY;IAqCA;IACT;IApCZ;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAkD;QAC7D,OAAO,IAAI,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAA4E;QACxF,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAA,CAAI,yBAAyB;YAErJ,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,IAAI,kBAAkB,CACxB,IAAK,MAAM,CAAC,QAAS,6CAA6C;gBAClE,yBAA0B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAE,GAAG,CAC/D,CAAC;QACN,CAAC;QAED,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,YACqB,mBAAmD,EAC5D,KAAa;QADJ,wBAAmB,GAAnB,mBAAmB,CAAgC;QAC5D,UAAK,GAAL,KAAK,CAAQ;IAEzB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAY;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,8FAA8F,CAAC,CAAC;QACzH,CAAC;QAED,IAAI,CAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACvE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC;IACL,CAAC;CACJ"}

package/esm/stage/crew/photographer/index.d.ts

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

package/esm/stage/crew/photographer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/esm/stage/crew/photographer/index.js

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

package/esm/stage/crew/photographer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/esm/stage/crew/photographer/strategies/PhotoTakingStrategy.d.ts

@@ -0,0 +1,29 @@
+import type { Stage } from '@serenity-js/core';
+import type { ActivityFinished, ActivityStarts, DomainEvent } from '@serenity-js/core/events';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos, a.k.a. screenshots,
+ * of the [`Activity`](https://serenity-js.org/api/core/class/Activity/) performed by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * when desired conditions are met.
+ *
+ * @group Stage
+ */
+export declare abstract class PhotoTakingStrategy {
+    /**
+     * Takes a photo of the web browser used by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
+     *
+     * #### Learn more
+     * - [ActivityStarts](https://serenity-js.org/api/core-events/class/ActivityStarts/)
+     * - [ActivityFinished](https://serenity-js.org/api/core-events/class/ActivityFinished/)
+     * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     *
+     * @param event
+     * @param stage
+     *  The Stage that holds reference to the Actor in the spotlight
+     */
+    considerTakingPhoto(event: ActivityStarts | ActivityFinished, stage: Stage): Promise<void>;
+    protected abstract shouldTakeAPhotoOf(event: DomainEvent): boolean;
+    protected abstract photoNameFor(event: DomainEvent): string;
+    private combinedNameFrom;
+    private shouldIgnore;
+}
+//# sourceMappingURL=PhotoTakingStrategy.d.ts.map

package/esm/stage/crew/photographer/strategies/PhotoTakingStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoTakingStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM9F;;;;;;GAMG;AACH,8BAAsB,mBAAmB;IAErC;;;;;;;;;;;OAWG;IACG,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DhG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAElE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAE3D,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,YAAY;CAIvB"}

package/esm/stage/crew/photographer/strategies/PhotoTakingStrategy.js

@@ -0,0 +1,64 @@
+import { LogicError } from '@serenity-js/core';
+import { ActivityRelatedArtifactGenerated, AsyncOperationAborted, AsyncOperationAttempted, AsyncOperationCompleted, AsyncOperationFailed } from '@serenity-js/core/events';
+import { CorrelationId, Description, Name, Photo } from '@serenity-js/core/model';
+import { BrowseTheWeb } from '../../../../screenplay/index.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos, a.k.a. screenshots,
+ * of the [`Activity`](https://serenity-js.org/api/core/class/Activity/) performed by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * when desired conditions are met.
+ *
+ * @group Stage
+ */
+export class PhotoTakingStrategy {
+    /**
+     * Takes a photo of the web browser used by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
+     *
+     * #### Learn more
+     * - [ActivityStarts](https://serenity-js.org/api/core-events/class/ActivityStarts/)
+     * - [ActivityFinished](https://serenity-js.org/api/core-events/class/ActivityFinished/)
+     * - [`Stage`](https://serenity-js.org/api/core/class/Stage/)
+     *
+     * @param event
+     * @param stage
+     *  The Stage that holds reference to the Actor in the spotlight
+     */
+    async considerTakingPhoto(event, stage) {
+        if (!this.shouldTakeAPhotoOf(event)) {
+            return void 0;
+        }
+        let browseTheWeb;
+        try {
+            browseTheWeb = BrowseTheWeb.as(stage.theActorInTheSpotlight());
+        }
+        catch {
+            // actor doesn't have a browser, abort
+            return void 0;
+        }
+        const id = CorrelationId.create(), nameSuffix = this.photoNameFor(event);
+        stage.announce(new AsyncOperationAttempted(new Name(`Photographer:${this.constructor.name}`), new Description(`Taking screenshot of '${nameSuffix}'...`), id, stage.currentTime()));
+        try {
+            const capabilities = await browseTheWeb.browserCapabilities();
+            const page = await browseTheWeb.currentPage();
+            const screenshot = await page.takeScreenshot();
+            const context = [capabilities.platformName, capabilities.browserName, capabilities.browserVersion], photoName = this.combinedNameFrom(...context, nameSuffix);
+            stage.announce(new ActivityRelatedArtifactGenerated(event.sceneId, event.activityId, photoName, Photo.fromBase64(screenshot), stage.currentTime()));
+            return stage.announce(new AsyncOperationCompleted(id, stage.currentTime()));
+        }
+        catch (error) {
+            if (this.shouldIgnore(error)) {
+                stage.announce(new AsyncOperationAborted(new Description(`Aborted taking screenshot of '${nameSuffix}' because of ${error.constructor && error.constructor.name}`), id, stage.currentTime()));
+            }
+            else {
+                stage.announce(new AsyncOperationFailed(error, id, stage.currentTime()));
+            }
+        }
+    }
+    combinedNameFrom(...parts) {
+        return new Name(parts.filter(v => !!v).join('-'));
+    }
+    shouldIgnore(error) {
+        return error instanceof LogicError
+            || (error.name && error.name === LogicError.name);
+    }
+}
+//# sourceMappingURL=PhotoTakingStrategy.js.map

package/esm/stage/crew/photographer/strategies/PhotoTakingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoTakingStrategy.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts"],"names":[],"mappings":"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"}

package/esm/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.d.ts

@@ -0,0 +1,19 @@
+import type { DomainEvent } from '@serenity-js/core/events';
+import { InteractionFinished, InteractionStarts } from '@serenity-js/core/events';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots) **both before and after**
+ * every single [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
+ *
+ * **Please note** that this strategy will result in _a lot_ of screenshots being taken,
+ * which will seriously affect the performance of your tests.
+ * For this reason, it's best to use it only for debugging purposes.
+ *
+ * @group Stage
+ */
+export declare class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy {
+    protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
+    protected photoNameFor(event: InteractionStarts | InteractionFinished): string;
+}
+//# sourceMappingURL=TakePhotosBeforeAndAfterInteractions.d.ts.map

package/esm/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosBeforeAndAfterInteractions.d.ts","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,qBAAa,oCAAqC,SAAQ,mBAAmB;IACzE,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAKzD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,MAAM;CAKjF"}

package/esm/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js

@@ -0,0 +1,25 @@
+import { InteractionFinished, InteractionStarts } from '@serenity-js/core/events';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots) **both before and after**
+ * every single [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/).
+ *
+ * **Please note** that this strategy will result in _a lot_ of screenshots being taken,
+ * which will seriously affect the performance of your tests.
+ * For this reason, it's best to use it only for debugging purposes.
+ *
+ * @group Stage
+ */
+export class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy {
+    shouldTakeAPhotoOf(event) {
+        return event instanceof InteractionStarts
+            || event instanceof InteractionFinished;
+    }
+    photoNameFor(event) {
+        return event instanceof InteractionStarts
+            ? `Before ${event.details.name.value}`
+            : `After ${event.details.name.value}`;
+    }
+}
+//# sourceMappingURL=TakePhotosBeforeAndAfterInteractions.js.map

package/esm/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosBeforeAndAfterInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oCAAqC,SAAQ,mBAAmB;IAC/D,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,iBAAiB;eAClC,KAAK,YAAY,mBAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA8C;QACjE,OAAO,KAAK,YAAY,iBAAiB;YACrC,CAAC,CAAC,UAAW,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAM,EAAE;YACxC,CAAC,CAAC,SAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAM,EAAE,CAAC;IAChD,CAAC;CACJ"}

package/esm/stage/crew/photographer/strategies/TakePhotosOfFailures.d.ts

@@ -0,0 +1,19 @@
+import type { DomainEvent } from '@serenity-js/core/events';
+import { InteractionFinished } from '@serenity-js/core/events';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * results in an error.
+ *
+ * This strategy works best when you are interested in the screenshots only when
+ * a scenario fails.
+ *
+ * @group Stage
+ */
+export declare class TakePhotosOfFailures extends PhotoTakingStrategy {
+    protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
+    protected photoNameFor(event: InteractionFinished): string;
+}
+//# sourceMappingURL=TakePhotosOfFailures.d.ts.map

package/esm/stage/crew/photographer/strategies/TakePhotosOfFailures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosOfFailures.d.ts","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;IACzD,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAKzD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;CAG7D"}

package/esm/stage/crew/photographer/strategies/TakePhotosOfFailures.js

@@ -0,0 +1,24 @@
+import { InteractionFinished } from '@serenity-js/core/events';
+import { ImplementationPending } from '@serenity-js/core/model';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Interaction`](https://serenity-js.org/api/core/class/Interaction/) performed
+ * by the [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * results in an error.
+ *
+ * This strategy works best when you are interested in the screenshots only when
+ * a scenario fails.
+ *
+ * @group Stage
+ */
+export class TakePhotosOfFailures extends PhotoTakingStrategy {
+    shouldTakeAPhotoOf(event) {
+        return event instanceof InteractionFinished
+            && event.outcome.isWorseThan(ImplementationPending);
+    }
+    photoNameFor(event) {
+        return event.details.name.value;
+    }
+}
+//# sourceMappingURL=TakePhotosOfFailures.js.map

package/esm/stage/crew/photographer/strategies/TakePhotosOfFailures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosOfFailures.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAqB,SAAQ,mBAAmB;IAC/C,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,mBAAmB;eACpC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAC5D,CAAC;IAES,YAAY,CAAC,KAA0B;QAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACpC,CAAC;CACJ"}

package/esm/stage/crew/photographer/strategies/TakePhotosOfInteractions.d.ts

@@ -0,0 +1,20 @@
+import type { DomainEvent } from '@serenity-js/core/events';
+import { InteractionFinished } from '@serenity-js/core/events';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * performs any [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
+ *
+ * This strategy works best when you want the results of your automated tests
+ * to become comprehensive living documentation of your system.
+ *
+ * *Please note* that taking screenshots affects the performance of your tests.
+ *
+ * @group Stage
+ */
+export declare class TakePhotosOfInteractions extends PhotoTakingStrategy {
+    protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
+    protected photoNameFor(event: InteractionFinished): string;
+}
+//# sourceMappingURL=TakePhotosOfInteractions.d.ts.map

package/esm/stage/crew/photographer/strategies/TakePhotosOfInteractions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosOfInteractions.d.ts","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfInteractions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC7D,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAIzD,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;CAG7D"}

package/esm/stage/crew/photographer/strategies/TakePhotosOfInteractions.js

@@ -0,0 +1,23 @@
+import { InteractionFinished } from '@serenity-js/core/events';
+import { PhotoTakingStrategy } from './PhotoTakingStrategy.js';
+/**
+ * Configures the [`Photographer`](https://serenity-js.org/api/web/class/Photographer/) to take photos (a.k.a. screenshots)
+ * when then [`Actor`](https://serenity-js.org/api/core/class/Actor/) in the [spotlight](https://serenity-js.org/api/core/function/actorInTheSpotlight/)
+ * performs any [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
+ *
+ * This strategy works best when you want the results of your automated tests
+ * to become comprehensive living documentation of your system.
+ *
+ * *Please note* that taking screenshots affects the performance of your tests.
+ *
+ * @group Stage
+ */
+export class TakePhotosOfInteractions extends PhotoTakingStrategy {
+    shouldTakeAPhotoOf(event) {
+        return event instanceof InteractionFinished;
+    }
+    photoNameFor(event) {
+        return event.details.name.value;
+    }
+}
+//# sourceMappingURL=TakePhotosOfInteractions.js.map

package/esm/stage/crew/photographer/strategies/TakePhotosOfInteractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TakePhotosOfInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfInteractions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,wBAAyB,SAAQ,mBAAmB;IACnD,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,mBAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA0B;QAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACpC,CAAC;CACJ"}

package/esm/stage/crew/photographer/strategies/index.d.ts

@@ -0,0 +1,5 @@
+export * from './PhotoTakingStrategy.js';
+export * from './TakePhotosBeforeAndAfterInteractions.js';
+export * from './TakePhotosOfFailures.js';
+export * from './TakePhotosOfInteractions.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/stage/crew/photographer/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}

package/esm/stage/crew/photographer/strategies/index.js

@@ -0,0 +1,5 @@
+export * from './PhotoTakingStrategy.js';
+export * from './TakePhotosBeforeAndAfterInteractions.js';
+export * from './TakePhotosOfFailures.js';
+export * from './TakePhotosOfInteractions.js';
+//# sourceMappingURL=index.js.map

package/esm/stage/crew/photographer/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}

package/esm/stage/index.d.ts

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

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

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

package/esm/stage/index.js

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

package/esm/stage/index.js.map

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

package/lib/errors/index.d.ts

@@ -1,4 +1,4 @@
-export * from './BrowserWindowClosedError';
-export * from './CookieMissingError';
-export * from './ModalDialogObstructsScreenshotError';
+export * from './BrowserWindowClosedError.js';
+export * from './CookieMissingError.js';
+export * from './ModalDialogObstructsScreenshotError.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0CAA0C,CAAC"}

package/lib/errors/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./BrowserWindowClosedError"), exports);
-__exportStar(require("./CookieMissingError"), exports);
-__exportStar(require("./ModalDialogObstructsScreenshotError"), exports);
+__exportStar(require("./BrowserWindowClosedError.js"), exports);
+__exportStar(require("./CookieMissingError.js"), exports);
+__exportStar(require("./ModalDialogObstructsScreenshotError.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,uDAAqC;AACrC,wEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,0DAAwC;AACxC,2EAAyD"}

package/lib/expectations/index.d.ts

@@ -1,6 +1,6 @@
-export * from './isActive';
-export * from './isClickable';
-export * from './isEnabled';
-export * from './isSelected';
-export * from './isVisible';
+export * from './isActive.js';
+export * from './isClickable.js';
+export * from './isEnabled.js';
+export * from './isSelected.js';
+export * from './isVisible.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/lib/expectations/index.js

@@ -14,9 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./isActive"), exports);
-__exportStar(require("./isClickable"), exports);
-__exportStar(require("./isEnabled"), exports);
-__exportStar(require("./isSelected"), exports);
-__exportStar(require("./isVisible"), exports);
+__exportStar(require("./isActive.js"), exports);
+__exportStar(require("./isClickable.js"), exports);
+__exportStar(require("./isEnabled.js"), exports);
+__exportStar(require("./isSelected.js"), exports);
+__exportStar(require("./isVisible.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/expectations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAC7B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/expectations/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,kDAAgC;AAChC,iDAA+B"}

package/lib/expectations/isActive.d.ts

@@ -1,5 +1,5 @@
 import { Expectation } from '@serenity-js/core';
-import type { PageElement } from '../screenplay';
+import type { PageElement } from '../screenplay/index.js';
 /**
  * [`Expectation`](https://serenity-js.org/api/core/class/Expectation/) that an element is "active", which means it resolves to `true` when:
  *  - the element [is present](https://serenity-js.org/api/assertions/function/isPresent/) in the [DOM](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model)