@serenity-js/web 3.0.0-rc.9 → 3.0.1

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

@@ -1,90 +1,209 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = 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];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Photographer = void 0;
 const core_1 = require("@serenity-js/core");
 const events_1 = require("@serenity-js/core/lib/events");
+const strategies = __importStar(require("./strategies"));
 /**
- * @desc
- *  The Photographer is a {@link @serenity-js/core/lib/stage~StageCrewMember} who takes screenshots
- *  of the web browser that the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight is using.
+ * The Photographer is a {@apilink StageCrewMember} who takes screenshots
+ * using the web browser associated with the {@apilink Actor} that is currently {@apilink actorInTheSpotlight|in the spotlight}.
+ *
+ * ## Programmatically assigning the `Photographer` to the {@apilink Stage}
+ *
+ * ```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 WebdriverIO
  *
- * @example <caption>Assigning the Photographer to the Stage</caption>
+ * ```ts
  * // wdio.conf.ts
- * import { ArtifactArchiver } from '@serenity-js/core';
- * import { Photographer, TakePhotosOfFailures } from '@serenity-js/webdriverio';
+ * import { ArtifactArchiver } from '@serenity-js/core'
+ * import { Photographer, TakePhotosOfFailures } from '@serenity-js/web'
+ * 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: [
+ *       ArtifactArchiver.storingArtifactsAt(process.cwd(), 'target/site/serenity'),
+ *       Photographer.whoWill(TakePhotosOfFailures),
+ *     ]
+ *   },
  *
- * export const config = {
+ *   // ... rest of the config omitted for brevity
+ * }
+ * ```
  *
- *     serenity: {
+ * ## Using `Photographer` with Playwright Test
+ *
+ * ```ts
+ * // playwright.config.ts
+ * import type { PlaywrightTestConfig } from '@serenity-js/playwright-test'
+ *
+ * const config: PlaywrightTestConfig = {
+ *     use: {
  *         crew: [
- *             ArtifactArchiver.storingArtifactsAt(process.cwd(), 'target/site/serenity'),
+ *             [ '@serenity-js/web:Photographer', { strategy: 'TakePhotosOfFailures' } ] // or 'TakePhotosOfInteractions'
+ *         ],
+ *     },
+ * };
+ * export default config;
+ * ```
+ *
+ * #### Learn more
+ * - {@apilink SerenityOptions}
+ *
+ * ## Using `Photographer` with Protractor
+ *
+ * ```ts
+ * // protractor.conf.js
+ * const { ArtifactArchiver } = require('@serenity-js/core')
+ * const { Photographer, TakePhotosOfFailures } = require('@serenity-js/web')
+ *
+ * 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: [
+ *             ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
  *             Photographer.whoWill(TakePhotosOfFailures),
  *         ]
  *     },
  *
  *     // ... rest of the config omitted for brevity
- * };
+ * }
+ * ```
  *
- * @example <caption>Taking photos upon failures only</caption>
+ * ## Taking photos only upon failures only
  *
- * import { Photographer, TakePhotosOfFailures } from '@serenity-js/webdriverio';
+ * ```ts
+ * import { Photographer, TakePhotosOfFailures } from '@serenity-js/web'
  *
  * Photographer.whoWill(TakePhotosOfFailures)
+ * ```
  *
- * @example <caption>Taking photos of all the interactions</caption>
+ * ## Taking photos of all the interactions
  *
- * import { Photographer, TakePhotosOfInteractions } from '@serenity-js/webdriverio';
+ * ```ts
+ * import { Photographer, TakePhotosOfInteractions } from '@serenity-js/web'
  *
  * Photographer.whoWill(TakePhotosOfInteractions)
+ * ```
  *
- * @example <caption>Taking photos before and after all the interactions</caption>
+ * ## Taking photos before and after all the interactions
  *
- * import { Photographer, TakePhotosBeforeAndAfterInteractions } from '@serenity-js/webdriverio';
+ * ```ts
+ * import { Photographer, TakePhotosBeforeAndAfterInteractions } from '@serenity-js/web'
  *
  * Photographer.whoWill(TakePhotosBeforeAndAfterInteractions)
+ * ```
  *
- * @see {@link @serenity-js/core/lib/stage~Stage}
- * @see {@link TakePhotosBeforeAndAfterInteractions}
- * @see {@link TakePhotosOfFailures}
- * @see {@link TakePhotosOfInteractions}
+ * ## Learn more
+ * - {@apilink Stage}
+ * - {@apilink StageCrewMember}
+ * - {@apilink TakePhotosBeforeAndAfterInteractions}
+ * - {@apilink TakePhotosOfFailures}
+ * - {@apilink TakePhotosOfInteractions}
+ *
+ * @group Stage
  */
 class Photographer {
     /**
-     * @param {PhotoTakingStrategy} photoTakingStrategy
-     * @param {Stage} stage
+     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
+     * as per the specified {@apilink PhotoTakingStrategy}.
+     *
+     * @param strategy
+     *  A no-arg constructor function that instantiates a {@apilink PhotoTakingStrategy}
      */
-    constructor(photoTakingStrategy, stage) {
-        this.photoTakingStrategy = photoTakingStrategy;
-        this.stage = stage;
+    static whoWill(strategy) {
+        return new Photographer(new strategy());
     }
     /**
-     * @desc
-     *  Instantiates a new {@link Photographer} configured to take photos (screenshots)
-     *  as per the specified {@link PhotoTakingStrategy}.
+     * Instantiates a new {@apilink Photographer} configured to take photos (screenshots)
+     * as per the specified {@apilink PhotoTakingStrategy}.
      *
-     * @param {Function} strategy - A no-arg constructor function that instantiates a {@link PhotoTakingStrategy}.
-     * @returns {StageCrewMember}
+     * @param config
      */
-    static whoWill(strategy) {
-        return new Photographer(new strategy());
+    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 core_1.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;
     }
     /**
-     * @desc
-     *  Creates a new instance of this {@link StageCrewMember} and assigns it to a given {@link Stage}.
+     * Assigns this {@apilink StageCrewMember} to a given {@apilink Stage}.
      *
-     * @param {Stage} stage - An instance of a {@link Stage} this {@link StageCrewMember} will be assigned to
-     * @returns {StageCrewMember} - A new instance of this {@link StageCrewMember}
+     * @param stage
+     *  An instance of a {@apilink Stage} this {@apilink StageCrewMember} will be assigned to
      */
     assignedTo(stage) {
-        return new Photographer(this.photoTakingStrategy, stage);
+        this.stage = stage;
+        return this;
     }
     /**
-     * @desc
-     *  Handles {@link DomainEvent} objects emitted by the {@link Stage}
-     *  this {@link StageCrewMember} is assigned to.
+     * Handles {@apilink DomainEvent} objects emitted by the {@apilink Stage}
+     * this {@apilink StageCrewMember} is assigned to.
      *
-     * @param {DomainEvent} event
-     * @returns {void}
+     * @param event
      */
     notifyOf(event) {
         if (!this.stage) {

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

@@ -1 +1 @@
-{"version":3,"file":"Photographer.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":";;;AAAA,4CAA+C;AAC/C,yDAA6F;AAK7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAa,YAAY;IAcrB;;;OAGG;IACH,YACqB,mBAAwC,EACjD,KAAa;QADJ,wBAAmB,GAAnB,mBAAmB,CAAqB;QACjD,UAAK,GAAL,KAAK,CAAQ;IAEzB,CAAC;IApBD;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,QAAuC;QAClD,OAAO,IAAI,YAAY,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IAYD;;;;;;OAMG;IACH,UAAU,CAAC,KAAY;QACnB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAkB;QACvB,IAAI,CAAE,IAAI,CAAC,KAAK,EAAE;YACd,MAAM,IAAI,iBAAU,CAAC,8FAA8F,CAAC,CAAC;SACxH;QAED,IAAI,CAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,KAAK,YAAY,uBAAc,IAAI,KAAK,YAAY,yBAAgB,EAAE;YACtE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;SACnE;IACL,CAAC;CACJ;AAxDD,oCAwDC"}
+{"version":3,"file":"Photographer.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAAmE;AACnE,yDAA6F;AAG7F,yDAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiIG;AACH,MAAa,YAAY;IAErB;;;;;;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;YAC3B,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;gBACzD,OAAO,IAAI,YAAY,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAkB,CAAC,EAAE,CAAC,CAAC;aACxE;YAED,MAAM,IAAI,yBAAkB,CACxB,IAAK,MAAM,CAAC,QAAS,6CAA6C;gBAClE,yBAA0B,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAE,GAAG,CAC/D,CAAC;SACL;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;YACd,MAAM,IAAI,iBAAU,CAAC,8FAA8F,CAAC,CAAC;SACxH;QAED,IAAI,CAAE,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,KAAK,YAAY,uBAAc,IAAI,KAAK,YAAY,yBAAgB,EAAE;YACtE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;SACnE;IACL,CAAC;CACJ;AAxED,oCAwEC"}

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

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

package/lib/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,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/lib/stage/crew/photographer/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/stage/crew/photographer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B"}

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

@@ -1,24 +1,24 @@
 import { Stage } from '@serenity-js/core';
 import { ActivityFinished, ActivityStarts, DomainEvent } from '@serenity-js/core/lib/events';
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots)
- *  of the {@link @serenity-js/core/lib/screenplay~Activity} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight
- *  under specific conditions.
+ * Configures the {@apilink Photographer} to take {@apilink Photo|photos}, a.k.a. screenshots,
+ * of the {@apilink Activity} performed by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * when desired conditions are met.
  *
- * @abstract
+ * @group Stage
  */
 export declare abstract class PhotoTakingStrategy {
     /**
-     * @desc
-     *  Takes a photo of the web browser held by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight.
+     * Takes a photo of the web browser used by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
      *
-     * @param {@serenity-js/core/lib/events~ActivityStarts | @serenity-js/core/lib/events~ActivityFinished} event
-     * @param {@serenity-js/core/lib/stage~Stage} stage - the Stage that holds reference to the Actor in the spotlight
-     * @returns {void}
+     * #### Learn more
+     * - {@apilink ActivityStarts}
+     * - {@apilink ActivityFinished}
+     * - {@apilink Stage}
      *
-     * @see {@link @serenity-js/core/lib/stage~Stage#theActorInTheSpotlight}
+     * @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;
@@ -26,3 +26,4 @@ export declare abstract class PhotoTakingStrategy {
     private combinedNameFrom;
     private shouldIgnore;
 }
+//# sourceMappingURL=PhotoTakingStrategy.d.ts.map

package/lib/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,EAAc,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAoC,cAAc,EAAiG,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAK9N;;;;;;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/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js

@@ -1,28 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PhotoTakingStrategy = void 0;
+const core_1 = require("@serenity-js/core");
 const events_1 = require("@serenity-js/core/lib/events");
 const model_1 = require("@serenity-js/core/lib/model");
 const screenplay_1 = require("../../../../screenplay");
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots)
- *  of the {@link @serenity-js/core/lib/screenplay~Activity} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight
- *  under specific conditions.
+ * Configures the {@apilink Photographer} to take {@apilink Photo|photos}, a.k.a. screenshots,
+ * of the {@apilink Activity} performed by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * when desired conditions are met.
  *
- * @abstract
+ * @group Stage
  */
 class PhotoTakingStrategy {
     /**
-     * @desc
-     *  Takes a photo of the web browser held by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight.
+     * Takes a photo of the web browser used by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
      *
-     * @param {@serenity-js/core/lib/events~ActivityStarts | @serenity-js/core/lib/events~ActivityFinished} event
-     * @param {@serenity-js/core/lib/stage~Stage} stage - the Stage that holds reference to the Actor in the spotlight
-     * @returns {void}
+     * #### Learn more
+     * - {@apilink ActivityStarts}
+     * - {@apilink ActivityFinished}
+     * - {@apilink Stage}
      *
-     * @see {@link @serenity-js/core/lib/stage~Stage#theActorInTheSpotlight}
+     * @param event
+     * @param stage
+     *  The Stage that holds reference to the Actor in the spotlight
      */
     async considerTakingPhoto(event, stage) {
         if (!this.shouldTakeAPhotoOf(event)) {
@@ -37,30 +38,21 @@ class PhotoTakingStrategy {
             return void 0;
         }
         const id = model_1.CorrelationId.create(), nameSuffix = this.photoNameFor(event);
-        stage.announce(new events_1.AsyncOperationAttempted(new model_1.Description(`[Photographer:${this.constructor.name}] Taking screenshot of '${nameSuffix}'...`), id));
-        let dialogIsPresent;
-        try {
-            dialogIsPresent = await browseTheWeb.modalDialog().then(dialog => dialog.isPresent());
-            if (dialogIsPresent) {
-                return stage.announce(new events_1.AsyncOperationCompleted(new model_1.Description(`[${this.constructor.name}] Aborted taking screenshot of '${nameSuffix}' because of a modal dialog obstructing the view`), id));
-            }
-        }
-        catch (error) {
-            return stage.announce(new events_1.AsyncOperationFailed(error, id));
-        }
+        stage.announce(new events_1.AsyncOperationAttempted(new model_1.Name(`Photographer:${this.constructor.name}`), new model_1.Description(`Taking screenshot of '${nameSuffix}'...`), id, stage.currentTime()));
         try {
             const capabilities = await browseTheWeb.browserCapabilities();
-            const screenshot = await browseTheWeb.takeScreenshot();
+            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 events_1.ActivityRelatedArtifactGenerated(event.sceneId, event.activityId, photoName, model_1.Photo.fromBase64(screenshot)));
-            return stage.announce(new events_1.AsyncOperationCompleted(new model_1.Description(`[${this.constructor.name}] Took screenshot of '${nameSuffix}' on ${context}`), id));
+            stage.announce(new events_1.ActivityRelatedArtifactGenerated(event.sceneId, event.activityId, photoName, model_1.Photo.fromBase64(screenshot), stage.currentTime()));
+            return stage.announce(new events_1.AsyncOperationCompleted(id, stage.currentTime()));
         }
         catch (error) {
             if (this.shouldIgnore(error)) {
-                stage.announce(new events_1.AsyncOperationCompleted(new model_1.Description(`[${this.constructor.name}] Aborted taking screenshot of '${nameSuffix}' because of ${error.constructor && error.constructor.name}`), id));
+                stage.announce(new events_1.AsyncOperationAborted(new model_1.Description(`Aborted taking screenshot of '${nameSuffix}' because of ${error.constructor && error.constructor.name}`), id, stage.currentTime()));
             }
             else {
-                stage.announce(new events_1.AsyncOperationFailed(error, id));
+                stage.announce(new events_1.AsyncOperationFailed(error, id, stage.currentTime()));
             }
         }
     }
@@ -68,11 +60,8 @@ class PhotoTakingStrategy {
         return new model_1.Name(parts.filter(v => !!v).join('-'));
     }
     shouldIgnore(error) {
-        return error.name && (error.name === 'NoSuchSessionError' ||
-            (error.name === 'ProtocolError' && error.message.includes('Target closed')));
-        // todo: add SauceLabs
-        //  [0-0] 2021-12-02T01:32:36.402Z ERROR webdriver: Request failed with status 404 due to no such window: no such window: target window already closed
-        //  [0-0] from unknown error: web view not found
+        return error instanceof core_1.LogicError
+            || (error.name && error.name === core_1.LogicError.name);
     }
 }
 exports.PhotoTakingStrategy = PhotoTakingStrategy;

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

@@ -1 +1 @@
-{"version":3,"file":"PhotoTakingStrategy.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts"],"names":[],"mappings":";;;AACA,yDAAuM;AACvM,uDAAsF;AAEtF,uDAAsD;AAEtD;;;;;;;;GAQG;AACH,MAAsB,mBAAmB;IAErC;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAwC,EAAE,KAAY;QAC5E,IAAI,CAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,YAA0B,CAAC;QAE/B,IAAI;YACA,YAAY,GAAG,yBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC;SAClE;QAAC,MAAM;YACJ,sCAAsC;YACtC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,MACI,EAAE,GAAgB,qBAAa,CAAC,MAAM,EAAE,EACxC,UAAU,GAAQ,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE/C,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CACtC,IAAI,mBAAW,CAAC,iBAAkB,IAAI,CAAC,WAAW,CAAC,IAAK,2BAA4B,UAAW,MAAM,CAAC,EACtG,EAAE,CACL,CAAC,CAAC;QAEH,IAAI,eAAwB,CAAC;QAE7B,IAAI;YACA,eAAe,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAEtF,IAAI,eAAe,EAAE;gBACjB,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CAC7C,IAAI,mBAAW,CAAC,IAAK,IAAI,CAAC,WAAW,CAAC,IAAK,mCAAoC,UAAW,kDAAkD,CAAC,EAC7I,EAAE,CACL,CAAC,CAAC;aACN;SACJ;QAAC,OAAO,KAAK,EAAE;YACZ,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,6BAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;SAC9D;QAED,IAAI;YACA,MAAM,YAAY,GAAI,MAAM,YAAY,CAAC,mBAAmB,EAAE,CAAC;YAC/D,MAAM,UAAU,GAAM,MAAM,YAAY,CAAC,cAAc,EAAE,CAAC;YAE1D,MACI,OAAO,GAAK,CAAE,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,cAAc,CAAE,EAChG,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,CAAC;YAE9D,KAAK,CAAC,QAAQ,CAAC,IAAI,yCAAgC,CAC/C,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,UAAU,EAChB,SAAS,EACT,aAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAC/B,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CAC7C,IAAI,mBAAW,CAAC,IAAK,IAAI,CAAC,WAAW,CAAC,IAAK,yBAA0B,UAAW,QAAS,OAAQ,EAAE,CAAC,EACpG,EAAE,CACL,CAAC,CAAC;SACN;QACD,OAAO,KAAK,EAAE;YACV,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;gBAC1B,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CACtC,IAAI,mBAAW,CAAC,IAAK,IAAI,CAAC,WAAW,CAAC,IAAK,mCAAoC,UAAW,gBAAiB,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,IAAK,EAAE,CAAC,EAC1J,EAAE,CACL,CAAC,CAAC;aACN;iBACI;gBACD,KAAK,CAAC,QAAQ,CAAC,IAAI,6BAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;aACvD;SACJ;IACL,CAAC;IAMO,gBAAgB,CAAC,GAAG,KAAe;QACvC,OAAO,IAAI,YAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAEO,YAAY,CAAC,KAAY;QAC7B,OAAO,KAAK,CAAC,IAAI,IAAI,CACjB,KAAK,CAAC,IAAI,KAAK,oBAAoB;YACnC,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAC9E,CAAC;QACF,sBAAsB;QACtB,sJAAsJ;QACtJ,gDAAgD;IACpD,CAAC;CACJ;AApGD,kDAoGC"}
+{"version":3,"file":"PhotoTakingStrategy.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts"],"names":[],"mappings":";;;AAAA,4CAAsD;AACtD,yDAA8N;AAC9N,uDAAsF;AAEtF,uDAAsD;AAEtD;;;;;;GAMG;AACH,MAAsB,mBAAmB;IAErC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAwC,EAAE,KAAY;QAC5E,IAAI,CAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;YAClC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,IAAI,YAA0B,CAAC;QAE/B,IAAI;YACA,YAAY,GAAG,yBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC;SAClE;QAAC,MAAM;YACJ,sCAAsC;YACtC,OAAO,KAAK,CAAC,CAAC;SACjB;QAED,MACI,EAAE,GAAgB,qBAAa,CAAC,MAAM,EAAE,EACxC,UAAU,GAAQ,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE/C,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CACtC,IAAI,YAAI,CAAC,gBAAiB,IAAI,CAAC,WAAW,CAAC,IAAK,EAAE,CAAC,EACnD,IAAI,mBAAW,CAAC,yBAA0B,UAAW,MAAM,CAAC,EAC5D,EAAE,EACF,KAAK,CAAC,WAAW,EAAE,CACtB,CAAC,CAAC;QAEH,IAAI;YACA,MAAM,YAAY,GAAI,MAAM,YAAY,CAAC,mBAAmB,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAY,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;YACvD,MAAM,UAAU,GAAM,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAElD,MACI,OAAO,GAAK,CAAE,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,cAAc,CAAE,EAChG,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,CAAC;YAE9D,KAAK,CAAC,QAAQ,CAAC,IAAI,yCAAgC,CAC/C,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,UAAU,EAChB,SAAS,EACT,aAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAC5B,KAAK,CAAC,WAAW,EAAE,CACtB,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CAC7C,EAAE,EACF,KAAK,CAAC,WAAW,EAAE,CACtB,CAAC,CAAC;SACN;QACD,OAAO,KAAK,EAAE;YACV,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;gBAC1B,KAAK,CAAC,QAAQ,CAAC,IAAI,8BAAqB,CACpC,IAAI,mBAAW,CAAC,iCAAkC,UAAW,gBAAiB,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,IAAK,EAAE,CAAC,EAC7H,EAAE,EACF,KAAK,CAAC,WAAW,EAAE,CACtB,CAAC,CAAC;aACN;iBACI;gBACD,KAAK,CAAC,QAAQ,CAAC,IAAI,6BAAoB,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;aAC5E;SACJ;IACL,CAAC;IAMO,gBAAgB,CAAC,GAAG,KAAe;QACvC,OAAO,IAAI,YAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAEO,YAAY,CAAC,KAAY;QAC7B,OAAO,KAAK,YAAY,iBAAU;eAC3B,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAU,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;CACJ;AAvFD,kDAuFC"}

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

@@ -1,18 +1,18 @@
 import { DomainEvent, InteractionFinished, InteractionStarts } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) both before and after
- *  every single {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots) **both before and after**
+ * every single {@apilink Interaction} performed
+ * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
  *
- *  *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.
+ * **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.
  *
- * @extends {PhotoTakingStrategy}
+ * @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/lib/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,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;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/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js

@@ -4,16 +4,15 @@ exports.TakePhotosBeforeAndAfterInteractions = void 0;
 const events_1 = require("@serenity-js/core/lib/events");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) both before and after
- *  every single {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots) **both before and after**
+ * every single {@apilink Interaction} performed
+ * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}.
  *
- *  *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.
+ * **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.
  *
- * @extends {PhotoTakingStrategy}
+ * @group Stage
  */
 class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy_1.PhotoTakingStrategy {
     shouldTakeAPhotoOf(event) {

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

@@ -1 +1 @@
-{"version":3,"file":"TakePhotosBeforeAndAfterInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts"],"names":[],"mappings":";;;AAAA,yDAAmG;AAEnG,+DAA4D;AAE5D;;;;;;;;;;;GAWG;AACH,MAAa,oCAAqC,SAAQ,yCAAmB;IAC/D,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,0BAAiB;eAClC,KAAK,YAAY,4BAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA8C;QACjE,OAAO,KAAK,YAAY,0BAAiB;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;AAXD,oFAWC"}
+{"version":3,"file":"TakePhotosBeforeAndAfterInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts"],"names":[],"mappings":";;;AAAA,yDAAmG;AAEnG,+DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,MAAa,oCAAqC,SAAQ,yCAAmB;IAC/D,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,0BAAiB;eAClC,KAAK,YAAY,4BAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA8C;QACjE,OAAO,KAAK,YAAY,0BAAiB;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;AAXD,oFAWC"}

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

@@ -1,17 +1,18 @@
 import { DomainEvent, InteractionFinished } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight results in an error.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
+ * when then {@apilink Interaction} performed
+ * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * results in an error.
  *
- *  This strategy works best when you are interested in the screenshots only when
- *  a scenario fails.
+ * This strategy works best when you are interested in the screenshots only when
+ * a scenario fails.
  *
- * @extends {PhotoTakingStrategy}
+ * @group Stage
  */
 export declare class TakePhotosOfFailures extends PhotoTakingStrategy {
     protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
     protected photoNameFor(event: InteractionFinished): string;
 }
+//# sourceMappingURL=TakePhotosOfFailures.d.ts.map

package/lib/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,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;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/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js

@@ -5,15 +5,15 @@ const events_1 = require("@serenity-js/core/lib/events");
 const model_1 = require("@serenity-js/core/lib/model");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight results in an error.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
+ * when then {@apilink Interaction} performed
+ * by the {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * results in an error.
  *
- *  This strategy works best when you are interested in the screenshots only when
- *  a scenario fails.
+ * This strategy works best when you are interested in the screenshots only when
+ * a scenario fails.
  *
- * @extends {PhotoTakingStrategy}
+ * @group Stage
  */
 class TakePhotosOfFailures extends PhotoTakingStrategy_1.PhotoTakingStrategy {
     shouldTakeAPhotoOf(event) {

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

@@ -1,19 +1,19 @@
 import { DomainEvent, InteractionFinished } from '@serenity-js/core/lib/events';
 import { PhotoTakingStrategy } from './PhotoTakingStrategy';
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight
- *  performs any {@link @serenity-js/core/lib/screenplay~Interaction}.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
+ * when then {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * performs any {@apilink Interaction}.
  *
- *  This strategy works best when you want the results of your automated tests
- *  to become comprehensive living documentation of your system.
+ * 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.
+ * *Please note* that taking screenshots affects the performance of your tests.
  *
- * @extends {PhotoTakingStrategy}
+ * @group Stage
  */
 export declare class TakePhotosOfInteractions extends PhotoTakingStrategy {
     protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
     protected photoNameFor(event: InteractionFinished): string;
 }
+//# sourceMappingURL=TakePhotosOfInteractions.d.ts.map

package/lib/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,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;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/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js

@@ -4,17 +4,16 @@ exports.TakePhotosOfInteractions = void 0;
 const events_1 = require("@serenity-js/core/lib/events");
 const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
 /**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight
- *  performs any {@link @serenity-js/core/lib/screenplay~Interaction}.
+ * Configures the {@apilink Photographer} to take photos (a.k.a. screenshots)
+ * when then {@apilink Actor} in the {@apilink actorInTheSpotlight|spotlight}
+ * performs any {@apilink Interaction}.
  *
- *  This strategy works best when you want the results of your automated tests
- *  to become comprehensive living documentation of your system.
+ * 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.
+ * *Please note* that taking screenshots affects the performance of your tests.
  *
- * @extends {PhotoTakingStrategy}
+ * @group Stage
  */
 class TakePhotosOfInteractions extends PhotoTakingStrategy_1.PhotoTakingStrategy {
     shouldTakeAPhotoOf(event) {