@serenity-js/web 3.41.1 → 3.42.0

package/esm/screenplay/questions/index.js

@@ -0,0 +1,8 @@
+export * from './Attribute.js';
+export * from './ComputedStyle.js';
+export * from './CssClasses.js';
+export * from './LastScriptExecution.js';
+export * from './Selected.js';
+export * from './Text.js';
+export * from './Value.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/esm/scripts/dragAndDrop.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simulates HTML5 drag and drop events.
+ *
+ * This script is a workaround for Selenium WebDriver's inability to properly
+ * trigger HTML5 drag events using the Actions API. It manually dispatches
+ * the required drag events (dragstart, dragenter, dragover, drop, dragend)
+ * to simulate a complete drag and drop operation.
+ *
+ * @param source - The element to drag
+ * @param target - The element to drop onto
+ */
+export declare function dragAndDrop(source: HTMLElement, target: HTMLElement): void;
+//# sourceMappingURL=dragAndDrop.d.ts.map

package/esm/scripts/dragAndDrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragAndDrop.d.ts","sourceRoot":"","sources":["../../src/scripts/dragAndDrop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAgE1E"}

package/esm/scripts/dragAndDrop.js

@@ -0,0 +1,72 @@
+/* c8 ignore start */
+/**
+ * Simulates HTML5 drag and drop events.
+ *
+ * This script is a workaround for Selenium WebDriver's inability to properly
+ * trigger HTML5 drag events using the Actions API. It manually dispatches
+ * the required drag events (dragstart, dragenter, dragover, drop, dragend)
+ * to simulate a complete drag and drop operation.
+ *
+ * @param source - The element to drag
+ * @param target - The element to drop onto
+ */
+export function dragAndDrop(source, target) {
+    function createDragEvent(type, dataTransfer) {
+        return new DragEvent(type, {
+            bubbles: true,
+            cancelable: true,
+            dataTransfer,
+        });
+    }
+    function createDataTransfer() {
+        try {
+            return new DataTransfer();
+        }
+        catch {
+            // Fallback for older browsers
+            const event = document.createEvent('CustomEvent');
+            event.initCustomEvent('', false, false, null);
+            event.dataTransfer = {
+                data: {},
+                setData(format, data) {
+                    this.data[format] = data;
+                },
+                getData(format) {
+                    return this.data[format];
+                },
+                clearData(format) {
+                    if (format) {
+                        delete this.data[format];
+                    }
+                    else {
+                        this.data = {};
+                    }
+                },
+                setDragImage() {
+                    // no-op
+                },
+                dropEffect: 'none',
+                effectAllowed: 'all',
+                files: [],
+                items: [],
+                types: [],
+            };
+            return event.dataTransfer;
+        }
+    }
+    // Create a DataTransfer object to share between events
+    const dataTransfer = createDataTransfer();
+    // Dispatch dragstart on source
+    source.dispatchEvent(createDragEvent('dragstart', dataTransfer));
+    // Dispatch dragenter on target
+    target.dispatchEvent(createDragEvent('dragenter', dataTransfer));
+    // Dispatch dragover on target (required for drop to work)
+    const dragOverEvent = createDragEvent('dragover', dataTransfer);
+    target.dispatchEvent(dragOverEvent);
+    // Dispatch drop on target
+    target.dispatchEvent(createDragEvent('drop', dataTransfer));
+    // Dispatch dragend on source
+    source.dispatchEvent(createDragEvent('dragend', dataTransfer));
+}
+/* c8 ignore stop */
+//# sourceMappingURL=dragAndDrop.js.map

package/esm/scripts/dragAndDrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragAndDrop.js","sourceRoot":"","sources":["../../src/scripts/dragAndDrop.ts"],"names":[],"mappings":"AACA,qBAAqB;AACrB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,MAAmB;IAEhE,SAAS,eAAe,CAAC,IAAY,EAAE,YAA0B;QAC7D,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE;YACvB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,YAAY;SACf,CAAC,CAAC;IACP,CAAC;IAED,SAAS,kBAAkB;QACvB,IAAI,CAAC;YACD,OAAO,IAAI,YAAY,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,CAAC;YACH,8BAA8B;YAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAQ,CAAC;YACzD,KAAK,CAAC,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC9C,KAAK,CAAC,YAAY,GAAG;gBACjB,IAAI,EAAE,EAA4B;gBAClC,OAAO,CAAC,MAAc,EAAE,IAAY;oBAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;gBAC7B,CAAC;gBACD,OAAO,CAAC,MAAc;oBAClB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;gBACD,SAAS,CAAC,MAAe;oBACrB,IAAI,MAAM,EAAE,CAAC;wBACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC7B,CAAC;yBAAM,CAAC;wBACJ,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACnB,CAAC;gBACL,CAAC;gBACD,YAAY;oBACR,QAAQ;gBACZ,CAAC;gBACD,UAAU,EAAE,MAAoC;gBAChD,aAAa,EAAE,KAAsC;gBACrD,KAAK,EAAE,EAAyB;gBAChC,KAAK,EAAE,EAAqC;gBAC5C,KAAK,EAAE,EAAc;aACxB,CAAC;YACF,OAAO,KAAK,CAAC,YAAY,CAAC;QAC9B,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEjE,+BAA+B;IAC/B,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEjE,0DAA0D;IAC1D,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAChE,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAEpC,0BAA0B;IAC1B,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AACnE,CAAC;AACD,oBAAoB"}

package/esm/scripts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './dragAndDrop.js';
+export * from './isVisible.js';
+export * from './rehydrate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scripts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/esm/scripts/index.js

@@ -0,0 +1,4 @@
+export * from './dragAndDrop.js';
+export * from './isVisible.js';
+export * from './rehydrate.js';
+//# sourceMappingURL=index.js.map

package/esm/scripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scripts/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/esm/scripts/isVisible.d.ts

@@ -0,0 +1,2 @@
+export declare function isVisible(domNode: HTMLElement): boolean;
+//# sourceMappingURL=isVisible.d.ts.map

package/esm/scripts/isVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isVisible.d.ts","sourceRoot":"","sources":["../../src/scripts/isVisible.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CA8GvD"}

package/esm/scripts/isVisible.js

@@ -0,0 +1,92 @@
+/* c8 ignore start */
+export function isVisible(domNode) {
+    const style = window.getComputedStyle(domNode);
+    if (style.opacity === '0') {
+        return false;
+    }
+    if (style.visibility === 'hidden') {
+        return false;
+    }
+    if (style.display === 'none') {
+        return false;
+    }
+    if (!domNode.getBoundingClientRect || !domNode.scrollIntoView || !domNode.contains || !domNode.getClientRects || !document.elementFromPoint) {
+        return false;
+    }
+    // Edge before switching to Chromium
+    const isOldEdge = !!window['StyleMedia'];
+    // get overlapping element
+    function getOverlappingElement(element, context) {
+        context = context || document;
+        const dimensions = element.getBoundingClientRect();
+        const x = dimensions.left + (element.clientWidth / 2);
+        const y = dimensions.top + (element.clientHeight / 2);
+        return context.elementFromPoint(x, y);
+    }
+    // get overlapping element rects (currently only the first)
+    // applicable if element's text is multiline.
+    function getOverlappingRects(element, context) {
+        context = context || document;
+        const elements = [];
+        const rects = element.getClientRects();
+        // webdriver clicks on center of the first element's rect (line of text), it might change in future
+        const rect = rects[0];
+        const x = rect.left + (rect.width / 2);
+        const y = rect.top + (rect.height / 2);
+        elements.push(context.elementFromPoint(x, y));
+        return elements;
+    }
+    // get overlapping elements
+    function getOverlappingElements(element, context) {
+        return [getOverlappingElement(element, context)].concat(getOverlappingRects(element, context));
+    }
+    // is a node a descendant of a given node
+    function nodeContains(element, otherNode) {
+        // Edge doesn't support neither Shadow Dom nor contains if ShadowRoot polyfill is used
+        if (isOldEdge) {
+            let tempElement = otherNode;
+            while (tempElement) {
+                if (tempElement === element) {
+                    return true;
+                }
+                tempElement = tempElement.parentNode;
+                // DocumentFragment / ShadowRoot polyfill like ShadyRoot
+                if (tempElement && tempElement.nodeType === 11 && tempElement.host) {
+                    tempElement = tempElement.host;
+                }
+            }
+            return false;
+        }
+        return element.contains(otherNode);
+    }
+    // is one of overlapping elements the `elem` or one of its child
+    function isOverlappingElementMatch(elementsFromPoint, element) {
+        if (elementsFromPoint.some(function (elementFromPoint) {
+            return elementFromPoint === element || nodeContains(element, elementFromPoint);
+        })) {
+            return true;
+        }
+        // shadow root
+        // filter unique elements with shadowRoot
+        const elementsWithShadowRoot = [].concat(elementsFromPoint).filter(function (x) {
+            return x && x.shadowRoot && x.shadowRoot.elementFromPoint;
+        });
+        // getOverlappingElements of every element with shadowRoot
+        let shadowElementsFromPoint = [];
+        for (let i = 0; i < elementsWithShadowRoot.length; ++i) {
+            const shadowElement = elementsWithShadowRoot[i];
+            shadowElementsFromPoint = shadowElementsFromPoint.concat(getOverlappingElements(element, shadowElement.shadowRoot));
+        }
+        // remove duplicates and parents
+        shadowElementsFromPoint = [].concat(shadowElementsFromPoint).filter(function (x) {
+            return !elementsFromPoint.includes(x);
+        });
+        if (shadowElementsFromPoint.length === 0) {
+            return false;
+        }
+        return isOverlappingElementMatch(shadowElementsFromPoint, element);
+    }
+    return isOverlappingElementMatch(getOverlappingElements(domNode), domNode);
+}
+/* c8 ignore stop */
+//# sourceMappingURL=isVisible.js.map

package/esm/scripts/isVisible.js.map

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

package/esm/scripts/rehydrate.d.ts

@@ -0,0 +1,5 @@
+export declare function rehydrate(...result: [{
+    argsCount: number;
+    refsCount: number;
+}, ...any[]]): Array<any>;
+//# sourceMappingURL=rehydrate.d.ts.map

package/esm/scripts/rehydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydrate.d.ts","sourceRoot":"","sources":["../../src/scripts/rehydrate.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,CAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAG,EAAE,CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAmCvG"}

package/esm/scripts/rehydrate.js

@@ -0,0 +1,31 @@
+// todo: instead of manually including isPlainObject, each script from web/lib/scripts should be pre-built and included in the global browser scope
+export function rehydrate(...result) {
+    function isPlainObject(v) {
+        if (typeof v === 'object' && v !== null) {
+            if (typeof Object.getPrototypeOf === 'function') {
+                const proto = Object.getPrototypeOf(v);
+                return proto === Object.prototype || proto === null;
+            }
+            return Object.prototype.toString.call(v) === '[object Object]';
+        }
+        return false;
+    }
+    function rehydrateRecursively(arg, refs) {
+        if (Array.isArray(arg)) {
+            return arg.map(item => rehydrateRecursively(item, refs));
+        }
+        if (isPlainObject(arg)) {
+            return Object.fromEntries(Object.entries(arg)
+                .map(([key, value]) => [key, rehydrateRecursively(value, refs)]));
+        }
+        if (typeof arg === 'string' && arg.startsWith('$ref')) {
+            return refs[Number.parseInt(arg.replace('$ref', ''), 10)];
+        }
+        return arg;
+    }
+    const [{ argsCount }, ...items] = result;
+    const args = items.slice(0, argsCount);
+    const refs = items.slice(argsCount);
+    return args.map(arg => rehydrateRecursively(arg, refs));
+}
+//# sourceMappingURL=rehydrate.js.map

package/esm/scripts/rehydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydrate.js","sourceRoot":"","sources":["../../src/scripts/rehydrate.ts"],"names":[],"mappings":"AACA,mJAAmJ;AACnJ,MAAM,UAAU,SAAS,CAAC,GAAG,MAA8D;IACvF,SAAS,aAAa,CAAC,CAAU;QAC7B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACtC,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;gBACvC,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;YACxD,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,SAAS,oBAAoB,CAAC,GAAQ,EAAE,IAAW;QAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;iBACd,GAAG,CAAC,CAAC,CAAE,GAAG,EAAE,KAAK,CAAE,EAAE,EAAE,CAAC,CAAE,GAAG,EAAE,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAE,CAAC,CAC3E,CAAC;QACN,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IAED,MAAM,CAAE,EAAE,SAAS,EAAE,EAAE,GAAG,KAAK,CAAE,GAAG,MAAM,CAAC;IAE3C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEpC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

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

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

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

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

package/esm/stage/crew/index.js

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

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

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

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

@@ -0,0 +1,189 @@
+import type { DomainEvent } from '@serenity-js/core/events';
+import type { Stage, StageCrewMember } from '@serenity-js/core/stage';
+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 declare class Photographer implements StageCrewMember {
+    private readonly photoTakingStrategy;
+    private 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: new () => strategies.PhotoTakingStrategy): StageCrewMember;
+    /**
+     * 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?: {
+        strategy?: Omit<keyof typeof strategies, 'PhotoTakingStrategy'>;
+    }): StageCrewMember;
+    constructor(photoTakingStrategy: strategies.PhotoTakingStrategy, 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: Stage): StageCrewMember;
+    /**
+     * 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: DomainEvent): void;
+}
+//# sourceMappingURL=Photographer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Photographer.d.ts","sourceRoot":"","sources":["../../../../src/stage/crew/photographer/Photographer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoJG;AACH,qBAAa,YAAa,YAAW,eAAe;IAqC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,KAAK,CAAC;IApClB;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,UAAU,CAAC,mBAAmB,GAAG,eAAe;IAInF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,MAAM,OAAO,UAAU,EAAE,qBAAqB,CAAC,CAAA;KAAE,GAAG,eAAe;gBAkBzF,mBAAmB,EAAE,UAAU,CAAC,mBAAmB,EAC5D,KAAK,CAAC,EAAE,KAAK;IAIzB;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe;IAKzC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAarC"}