@serenity-js/protractor 2.33.1 → 3.0.0-rc.11

package/lib/screenplay/questions/text/Text.d.ts

@@ -1,41 +0,0 @@
-import { MetaQuestion, Question } from '@serenity-js/core';
-import { ElementArrayFinder, ElementFinder } from 'protractor';
-/**
- * @desc
- *  Resolves to the visible (i.e. not hidden by CSS) `innerText` of:
- *  - a given {@link WebElement}, represented by {@link ElementFinder} or `Question<ElementFinder>`,
- *  - a group of {@link WebElement}s, represented by {@link ElementArrayFinder} or `Question<ElementArrayFinder>`.
- *
- *  The result includes the visible text of any sub-elements, without any leading or trailing whitespace.
- *
- * @public
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export declare class Text {
-    /**
-     * @desc
-     *  Retrieves text of a single {@link WebElement},
-     *  represented by {@link ElementFinder}
-     *  or `Question<ElementFinder>`.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {Question<Promise<string>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    static of(target: Question<ElementFinder> | ElementFinder): Question<Promise<string>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string>>;
-    /**
-     * @desc
-     *  Retrieves text of a group of {@link WebElement}s,
-     *  represented by {@link ElementArrayFinder}
-     *  or `Question<ElementArrayFinder>`
-     *
-     * @param {Question<ElementArrayFinder> | ElementArrayFinder} target
-     * @returns {Question<Promise<string[]>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string[]>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    static ofAll(target: Question<ElementArrayFinder> | ElementArrayFinder): Question<Promise<string[]>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string[]>>;
-}

package/lib/screenplay/questions/text/Text.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Text = void 0;
-const TextOfMultipleElements_1 = require("./TextOfMultipleElements");
-const TextOfSingleElement_1 = require("./TextOfSingleElement");
-/**
- * @desc
- *  Resolves to the visible (i.e. not hidden by CSS) `innerText` of:
- *  - a given {@link WebElement}, represented by {@link ElementFinder} or `Question<ElementFinder>`,
- *  - a group of {@link WebElement}s, represented by {@link ElementArrayFinder} or `Question<ElementArrayFinder>`.
- *
- *  The result includes the visible text of any sub-elements, without any leading or trailing whitespace.
- *
- * @public
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-class Text {
-    /**
-     * @desc
-     *  Retrieves text of a single {@link WebElement},
-     *  represented by {@link ElementFinder}
-     *  or `Question<ElementFinder>`.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {Question<Promise<string>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    static of(target) {
-        return new TextOfSingleElement_1.TextOfSingleElement(target);
-    }
-    /**
-     * @desc
-     *  Retrieves text of a group of {@link WebElement}s,
-     *  represented by {@link ElementArrayFinder}
-     *  or `Question<ElementArrayFinder>`
-     *
-     * @param {Question<ElementArrayFinder> | ElementArrayFinder} target
-     * @returns {Question<Promise<string[]>> & MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string[]>>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    static ofAll(target) {
-        return new TextOfMultipleElements_1.TextOfMultipleElements(target);
-    }
-}
-exports.Text = Text;
-//# sourceMappingURL=Text.js.map

package/lib/screenplay/questions/text/Text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/text/Text.ts"],"names":[],"mappings":";;;AAGA,qEAAkE;AAClE,+DAA4D;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAa,IAAI;IAEb;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,CAAC,MAA+C;QAGrD,OAAO,IAAI,yCAAmB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,CAAC,MAAyD;QAGlE,OAAO,IAAI,+CAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;CACJ;AAnCD,oBAmCC"}

package/lib/screenplay/questions/text/TextOfMultipleElements.d.ts

@@ -1,23 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementArrayFinder, ElementFinder } from 'protractor';
-/**
- * @package
- */
-export declare class TextOfMultipleElements extends Question<Promise<string[]>> implements MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string[]>> {
-    protected readonly target: Question<ElementArrayFinder> | ElementArrayFinder;
-    constructor(target: Question<ElementArrayFinder> | ElementArrayFinder);
-    of(parent: Question<ElementFinder> | ElementFinder): Question<Promise<string[]>>;
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string[]>;
-}

package/lib/screenplay/questions/text/TextOfMultipleElements.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextOfMultipleElements = void 0;
-const core_1 = require("@serenity-js/core");
-const withAnswerOf_1 = require("../../withAnswerOf");
-const targets_1 = require("../targets");
-/**
- * @package
- */
-class TextOfMultipleElements extends core_1.Question {
-    constructor(target) {
-        super(`the text of ${target}`);
-        this.target = target;
-    }
-    of(parent) {
-        return new TextOfMultipleElements(new targets_1.TargetNestedElements(parent, this.target));
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor) {
-        // protractor ignores type definitions for the ElementArrayFinder, hence the `any`
-        // https://github.com/angular/protractor/blob/c3978ec166760ac07db01e700c4aaaa19d9b5c38/lib/element.ts#L92
-        return (0, withAnswerOf_1.withAnswerOf)(actor, this.target, eaf => Promise.resolve(eaf.getText()));
-    }
-}
-exports.TextOfMultipleElements = TextOfMultipleElements;
-//# sourceMappingURL=TextOfMultipleElements.js.map

package/lib/screenplay/questions/text/TextOfMultipleElements.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TextOfMultipleElements.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/text/TextOfMultipleElements.ts"],"names":[],"mappings":";;;AAAA,4CAA4F;AAG5F,qDAAkD;AAClD,wCAAkD;AAElD;;GAEG;AACH,MAAa,sBACT,SAAQ,eAA2B;IAGnC,YAA+B,MAAyD;QACpF,KAAK,CAAC,eAAgB,MAAO,EAAE,CAAC,CAAC;QADN,WAAM,GAAN,MAAM,CAAmD;IAExF,CAAC;IAED,EAAE,CAAC,MAA+C;QAC9C,OAAO,IAAI,sBAAsB,CAAC,IAAI,8BAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAE9C,kFAAkF;QAClF,yGAAyG;QACzG,OAAO,IAAA,2BAAY,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAS,CAAsB,CAAC,CAAC;IAC/G,CAAC;CACJ;AA9BD,wDA8BC"}

package/lib/screenplay/questions/text/TextOfSingleElement.d.ts

@@ -1,23 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-/**
- * @package
- */
-export declare class TextOfSingleElement extends Question<Promise<string>> implements MetaQuestion<Question<ElementFinder> | ElementFinder, Promise<string>> {
-    protected readonly target: Question<ElementFinder> | ElementFinder;
-    constructor(target: Question<ElementFinder> | ElementFinder);
-    of(parent: Question<ElementFinder> | ElementFinder): Question<Promise<string>>;
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string>;
-}

package/lib/screenplay/questions/text/TextOfSingleElement.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextOfSingleElement = void 0;
-const core_1 = require("@serenity-js/core");
-const withAnswerOf_1 = require("../../withAnswerOf");
-const targets_1 = require("../targets");
-/**
- * @package
- */
-class TextOfSingleElement extends core_1.Question {
-    constructor(target) {
-        super(`the text of ${target}`);
-        this.target = target;
-    }
-    of(parent) {
-        return new TextOfSingleElement(new targets_1.TargetNestedElement(parent, this.target));
-    }
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  answer this {@link @serenity-js/core/lib/screenplay~Question}.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     */
-    answeredBy(actor) {
-        return (0, withAnswerOf_1.withAnswerOf)(actor, this.target, elf => elf.getText());
-    }
-}
-exports.TextOfSingleElement = TextOfSingleElement;
-//# sourceMappingURL=TextOfSingleElement.js.map

package/lib/screenplay/questions/text/TextOfSingleElement.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TextOfSingleElement.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/text/TextOfSingleElement.ts"],"names":[],"mappings":";;;AAAA,4CAA4F;AAG5F,qDAAkD;AAClD,wCAAiD;AAEjD;;GAEG;AACH,MAAa,mBACT,SAAQ,eAAyB;IAGjC,YAA+B,MAA+C;QAC1E,KAAK,CAAC,eAAgB,MAAO,EAAE,CAAC,CAAC;QADN,WAAM,GAAN,MAAM,CAAyC;IAE9E,CAAC;IAED,EAAE,CAAC,MAA+C;QAC9C,OAAO,IAAI,mBAAmB,CAAC,IAAI,6BAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,IAAA,2BAAY,EAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAS,CAAC,CAAC;IACzE,CAAC;CACJ;AA3BD,kDA2BC"}

package/lib/screenplay/questions/text/index.d.ts

@@ -1 +0,0 @@
-export * from './Text';

package/lib/screenplay/questions/text/index.js

@@ -1,14 +0,0 @@
-"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]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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("./Text"), exports);
-//# sourceMappingURL=index.js.map

package/lib/screenplay/questions/text/index.js.map

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

package/lib/screenplay/withAnswerOf.d.ts

@@ -1,8 +0,0 @@
-import { AnswersQuestions, Question, UsesAbilities } from '@serenity-js/core';
-/**
- * @private
- * @param actor
- * @param maybeQuestion
- * @param fn
- */
-export declare function withAnswerOf<T, O>(actor: AnswersQuestions & UsesAbilities, maybeQuestion: Question<T> | T, fn: (item: T) => O): O;

package/lib/screenplay/withAnswerOf.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withAnswerOf = void 0;
-const core_1 = require("@serenity-js/core");
-/**
- * @private
- * @param actor
- * @param maybeQuestion
- * @param fn
- */
-function withAnswerOf(actor, maybeQuestion, fn) {
-    const answer = core_1.Question.isAQuestion(maybeQuestion)
-        ? maybeQuestion.answeredBy(actor)
-        : maybeQuestion;
-    return fn(answer);
-}
-exports.withAnswerOf = withAnswerOf;
-//# sourceMappingURL=withAnswerOf.js.map

package/lib/screenplay/withAnswerOf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"withAnswerOf.js","sourceRoot":"","sources":["../../src/screenplay/withAnswerOf.ts"],"names":[],"mappings":";;;AAAA,4CAA8E;AAE9E;;;;;GAKG;AACH,SAAgB,YAAY,CACxB,KAAuC,EACvC,aAA8B,EAC9B,EAAkB;IAElB,MAAM,MAAM,GAAG,eAAQ,CAAC,WAAW,CAAC,aAAa,CAAC;QAC9C,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;QACjC,CAAC,CAAC,aAAa,CAAC;IAEpB,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAVD,oCAUC"}

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

@@ -1 +0,0 @@
-export * from './photographer';

package/lib/stage/crew/index.js.map

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

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

@@ -1,83 +0,0 @@
-import { DomainEvent } from '@serenity-js/core/lib/events';
-import { Stage, StageCrewMember } from '@serenity-js/core/lib/stage';
-import { PhotoTakingStrategy } from './strategies';
-/**
- * @desc
- *  The Photographer is a {@link @serenity-js/core/lib/stage~StageCrewMember} who takes screenshots
- *  of the web browser the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight is using.
- *
- * @example <caption>Assigning the Photographer to the Stage</caption>
- *
- * const { ArtifactArchiver } = require('@serenity-js/core');
- * const { Photographer, TakePhotosOfFailures } = require('@serenity-js/protractor');
- *
- * exports.config = {
- *
- *     serenity: {
- *         crew: [
- *             ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
- *             Photographer.whoWill(TakePhotosOfFailures),
- *         ]
- *     },
- *
- *     // ... rest of the config omitted for brevity
- * };
- *
- * @example <caption>Taking photos upon failures only</caption>
- *
- * const { Photographer, TakePhotosOfFailures } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosOfFailures)
- *
- * @example <caption>Taking photos of all the interactions</caption>
- *
- * const { Photographer, TakePhotosOfInteractions } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosOfInteractions)
- *
- * @example <caption>Taking photos before and after all the interactions</caption>
- *
- * const { Photographer, TakePhotosBeforeAndAfterInteractions } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosBeforeAndAfterInteractions)
- *
- * @see {@link @serenity-js/core/lib/stage~Stage}
- * @see {@link TakePhotosBeforeAndAfterInteractions}
- * @see {@link TakePhotosOfFailures}
- * @see {@link TakePhotosOfInteractions}
- */
-export declare class Photographer implements StageCrewMember {
-    private readonly photoTakingStrategy;
-    private stage?;
-    /**
-     * @desc
-     *  Instantiates a new {@link Photographer} configured to take photos (screenshots)
-     *  as per the specified {@link PhotoTakingStrategy}.
-     *
-     * @param {Function} strategy - A no-arg constructor function that instantiates a {@link PhotoTakingStrategy}.
-     * @returns {StageCrewMember}
-     */
-    static whoWill(strategy: new () => PhotoTakingStrategy): StageCrewMember;
-    /**
-     * @param {PhotoTakingStrategy} photoTakingStrategy
-     * @param {Stage} stage
-     */
-    constructor(photoTakingStrategy: PhotoTakingStrategy, stage?: Stage);
-    /**
-     * @desc
-     *  Creates a new instance of this {@link StageCrewMember} and assigns it to a given {@link 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}
-     */
-    assignedTo(stage: Stage): StageCrewMember;
-    /**
-     * @desc
-     *  Handles {@link DomainEvent} objects emitted by the {@link Stage}
-     *  this {@link StageCrewMember} is assigned to.
-     *
-     * @param {DomainEvent} event
-     * @returns {void}
-     */
-    notifyOf(event: DomainEvent): void;
-}

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

@@ -1,102 +0,0 @@
-"use strict";
-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");
-/**
- * @desc
- *  The Photographer is a {@link @serenity-js/core/lib/stage~StageCrewMember} who takes screenshots
- *  of the web browser the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight is using.
- *
- * @example <caption>Assigning the Photographer to the Stage</caption>
- *
- * const { ArtifactArchiver } = require('@serenity-js/core');
- * const { Photographer, TakePhotosOfFailures } = require('@serenity-js/protractor');
- *
- * exports.config = {
- *
- *     serenity: {
- *         crew: [
- *             ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
- *             Photographer.whoWill(TakePhotosOfFailures),
- *         ]
- *     },
- *
- *     // ... rest of the config omitted for brevity
- * };
- *
- * @example <caption>Taking photos upon failures only</caption>
- *
- * const { Photographer, TakePhotosOfFailures } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosOfFailures)
- *
- * @example <caption>Taking photos of all the interactions</caption>
- *
- * const { Photographer, TakePhotosOfInteractions } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosOfInteractions)
- *
- * @example <caption>Taking photos before and after all the interactions</caption>
- *
- * const { Photographer, TakePhotosBeforeAndAfterInteractions } = require('@serenity-js/protractor');
- *
- * Photographer.whoWill(TakePhotosBeforeAndAfterInteractions)
- *
- * @see {@link @serenity-js/core/lib/stage~Stage}
- * @see {@link TakePhotosBeforeAndAfterInteractions}
- * @see {@link TakePhotosOfFailures}
- * @see {@link TakePhotosOfInteractions}
- */
-class Photographer {
-    /**
-     * @param {PhotoTakingStrategy} photoTakingStrategy
-     * @param {Stage} stage
-     */
-    constructor(photoTakingStrategy, stage) {
-        this.photoTakingStrategy = photoTakingStrategy;
-        this.stage = stage;
-    }
-    /**
-     * @desc
-     *  Instantiates a new {@link Photographer} configured to take photos (screenshots)
-     *  as per the specified {@link PhotoTakingStrategy}.
-     *
-     * @param {Function} strategy - A no-arg constructor function that instantiates a {@link PhotoTakingStrategy}.
-     * @returns {StageCrewMember}
-     */
-    static whoWill(strategy) {
-        return new Photographer(new strategy());
-    }
-    /**
-     * @desc
-     *  Creates a new instance of this {@link StageCrewMember} and assigns it to a given {@link 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}
-     */
-    assignedTo(stage) {
-        return new Photographer(this.photoTakingStrategy, stage);
-    }
-    /**
-     * @desc
-     *  Handles {@link DomainEvent} objects emitted by the {@link Stage}
-     *  this {@link StageCrewMember} is assigned to.
-     *
-     * @param {DomainEvent} event
-     * @returns {void}
-     */
-    notifyOf(event) {
-        if (!this.stage) {
-            throw new core_1.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 events_1.ActivityStarts || event instanceof events_1.ActivityFinished) {
-            this.photoTakingStrategy.considerTakingPhoto(event, this.stage);
-        }
-    }
-}
-exports.Photographer = Photographer;
-//# sourceMappingURL=Photographer.js.map

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,2 +0,0 @@
-export * from './Photographer';
-export * from './strategies';

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

@@ -1,15 +0,0 @@
-"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]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-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("./Photographer"), exports);
-__exportStar(require("./strategies"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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,28 +0,0 @@
-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.
- *
- * @abstract
- */
-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.
-     *
-     * @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
-     *
-     * @see {@link @serenity-js/core/lib/stage~Stage#theActorInTheSpotlight}
-     */
-    considerTakingPhoto(event: ActivityStarts | ActivityFinished, stage: Stage): void;
-    protected abstract shouldTakeAPhotoOf(event: DomainEvent): boolean;
-    protected abstract photoNameFor(event: DomainEvent): string;
-    private combinedNameFrom;
-    private shouldIgnore;
-}

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

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PhotoTakingStrategy = void 0;
-const events_1 = require("@serenity-js/core/lib/events");
-const model_1 = require("@serenity-js/core/lib/model");
-const selenium_webdriver_1 = require("selenium-webdriver");
-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.
- *
- * @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.
-     *
-     * @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
-     *
-     * @see {@link @serenity-js/core/lib/stage~Stage#theActorInTheSpotlight}
-     */
-    considerTakingPhoto(event, stage) {
-        if (this.shouldTakeAPhotoOf(event)) {
-            let browseTheWeb;
-            try {
-                browseTheWeb = screenplay_1.BrowseTheWeb.as(stage.theActorInTheSpotlight());
-            }
-            catch {
-                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));
-            Promise.all([
-                browseTheWeb.takeScreenshot(),
-                browseTheWeb.getCapabilities(),
-            ]).then(([screenshot, capabilities]) => {
-                const context = [capabilities.get('platform'), capabilities.get('browserName'), capabilities.get('version')], photoName = this.combinedNameFrom(...context, nameSuffix);
-                stage.announce(new events_1.ActivityRelatedArtifactGenerated(event.sceneId, event.activityId, photoName, model_1.Photo.fromBase64(screenshot)));
-                stage.announce(new events_1.AsyncOperationCompleted(new model_1.Description(`[${this.constructor.name}] Took screenshot of '${nameSuffix}' on ${context}`), id));
-            }).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));
-                }
-                else {
-                    stage.announce(new events_1.AsyncOperationFailed(error, id));
-                }
-            });
-        }
-    }
-    combinedNameFrom(...parts) {
-        return new model_1.Name(parts.filter(v => !!v).join('-'));
-    }
-    shouldIgnore(error) {
-        return error instanceof selenium_webdriver_1.error.NoSuchSessionError
-            || error instanceof selenium_webdriver_1.error.UnexpectedAlertOpenError;
-    }
-}
-exports.PhotoTakingStrategy = PhotoTakingStrategy;
-//# sourceMappingURL=PhotoTakingStrategy.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"PhotoTakingStrategy.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts"],"names":[],"mappings":";;;AACA,yDAQsC;AACtC,uDAAsF;AACtF,2DAAwD;AAExD,uDAAsD;AAEtD;;;;;;;;GAQG;AACH,MAAsB,mBAAmB;IAErC;;;;;;;;;OASG;IACH,mBAAmB,CAAC,KAAwC,EAAE,KAAY;QACtE,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;YAChC,IAAI,YAA0B,CAAC;YAE/B,IAAI;gBACA,YAAY,GAAG,yBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC;aAClE;YAAC,MAAM;gBACJ,OAAO,KAAK,CAAC,CAAC;aACjB;YAED,MACI,EAAE,GAAgB,qBAAa,CAAC,MAAM,EAAE,EACxC,UAAU,GAAQ,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAE/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;YAEH,OAAO,CAAC,GAAG,CAAC;gBACR,YAAY,CAAC,cAAc,EAAE;gBAC7B,YAAY,CAAC,eAAe,EAAE;aACjC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,UAAU,EAAE,YAAY,CAAE,EAAE,EAAE;gBAErC,MACI,OAAO,GAAK,CAAE,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAE,EAC1G,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,CAAC;gBAE9D,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;gBAEH,KAAK,CAAC,QAAQ,CAAC,IAAI,gCAAuB,CACtC,IAAI,mBAAW,CAAC,IAAK,IAAI,CAAC,WAAW,CAAC,IAAK,yBAA0B,UAAW,QAAS,OAAQ,EAAE,CAAC,EACpG,EAAE,CACL,CAAC,CAAC;YACP,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBACb,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE;oBAC1B,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;iBACN;qBACI;oBACD,KAAK,CAAC,QAAQ,CAAC,IAAI,6BAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;iBACvD;YACL,CAAC,CAAC,CAAC;SACN;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,0BAAS,CAAC,kBAAkB;eAC7C,KAAK,YAAY,0BAAS,CAAC,wBAAwB,CAAA;IAC9D,CAAC;CACJ;AA7ED,kDA6EC"}

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

@@ -1,18 +0,0 @@
-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.
- *
- *  *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}
- */
-export declare class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy {
-    protected shouldTakeAPhotoOf(event: DomainEvent): boolean;
-    protected photoNameFor(event: InteractionStarts | InteractionFinished): string;
-}