npm - @serenity-js/webdriverio - Versions diffs - 2.32.4 → 3.0.0-rc.2 - Mend

@serenity-js/webdriverio 2.32.4 → 3.0.0-rc.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (240) hide show

package/CHANGELOG.md +70 -0
package/lib/adapter/WebdriverIOFrameworkAdapter.js +1 -1
package/lib/adapter/WebdriverIOFrameworkAdapter.js.map +1 -1
package/lib/adapter/WebdriverIONotifier.d.ts +35 -1
package/lib/adapter/WebdriverIONotifier.js +174 -13
package/lib/adapter/WebdriverIONotifier.js.map +1 -1
package/lib/index.d.ts +0 -3
package/lib/index.js +0 -3
package/lib/index.js.map +1 -1
package/lib/screenplay/abilities/{BrowseTheWeb.d.ts → BrowseTheWebWithWebdriverIO.d.ts} +79 -23
package/lib/screenplay/abilities/{BrowseTheWeb.js → BrowseTheWebWithWebdriverIO.js} +160 -25
package/lib/screenplay/abilities/BrowseTheWebWithWebdriverIO.js.map +1 -0
package/lib/screenplay/abilities/index.d.ts +1 -1
package/lib/screenplay/abilities/index.js +1 -1
package/lib/screenplay/abilities/index.js.map +1 -1
package/lib/screenplay/index.d.ts +1 -2
package/lib/screenplay/index.js +1 -2
package/lib/screenplay/index.js.map +1 -1
package/lib/screenplay/models/WebdriverIOCookie.d.ts +8 -0
package/lib/screenplay/models/WebdriverIOCookie.js +39 -0
package/lib/screenplay/models/WebdriverIOCookie.js.map +1 -0
package/lib/screenplay/models/WebdriverIOModalDialog.d.ts +11 -0
package/lib/screenplay/models/WebdriverIOModalDialog.js +40 -0
package/lib/screenplay/models/WebdriverIOModalDialog.js.map +1 -0
package/lib/screenplay/models/WebdriverIONativeElementRoot.d.ts +2 -0
package/lib/screenplay/{interactions/EnterBuilder.js → models/WebdriverIONativeElementRoot.js} +1 -1
package/lib/screenplay/models/WebdriverIONativeElementRoot.js.map +1 -0
package/lib/screenplay/models/WebdriverIOPage.d.ts +24 -0
package/lib/screenplay/models/WebdriverIOPage.js +98 -0
package/lib/screenplay/models/WebdriverIOPage.js.map +1 -0
package/lib/screenplay/models/WebdriverIOPageElement.d.ts +22 -0
package/lib/screenplay/models/WebdriverIOPageElement.js +75 -0
package/lib/screenplay/models/WebdriverIOPageElement.js.map +1 -0
package/lib/screenplay/models/WebdriverIOPageElements.d.ts +15 -0
package/lib/screenplay/models/WebdriverIOPageElements.js +65 -0
package/lib/screenplay/models/WebdriverIOPageElements.js.map +1 -0
package/lib/screenplay/models/index.d.ts +6 -0
package/lib/{input → screenplay/models}/index.js +6 -1
package/lib/screenplay/models/index.js.map +1 -0
package/package.json +18 -28
package/src/adapter/WebdriverIOFrameworkAdapter.ts +2 -0
package/src/adapter/WebdriverIONotifier.ts +225 -23
package/src/index.ts +0 -3
package/src/screenplay/abilities/{BrowseTheWeb.ts → BrowseTheWebWithWebdriverIO.ts} +200 -31
package/src/screenplay/abilities/index.ts +1 -1
package/src/screenplay/index.ts +1 -2
package/src/screenplay/models/WebdriverIOCookie.ts +44 -0
package/src/screenplay/models/WebdriverIOModalDialog.ts +45 -0
package/src/screenplay/models/WebdriverIONativeElementRoot.ts +3 -0
package/src/screenplay/models/WebdriverIOPage.ts +120 -0
package/src/screenplay/models/WebdriverIOPageElement.ts +92 -0
package/src/screenplay/models/WebdriverIOPageElements.ts +91 -0
package/src/screenplay/models/index.ts +6 -0
package/lib/expectations/ElementExpectation.d.ts +0 -11
package/lib/expectations/ElementExpectation.js +0 -27
package/lib/expectations/ElementExpectation.js.map +0 -1
package/lib/expectations/index.d.ts +0 -6
package/lib/expectations/index.js +0 -19
package/lib/expectations/index.js.map +0 -1
package/lib/expectations/isActive.d.ts +0 -15
package/lib/expectations/isActive.js +0 -21
package/lib/expectations/isActive.js.map +0 -1
package/lib/expectations/isClickable.d.ts +0 -20
package/lib/expectations/isClickable.js +0 -26
package/lib/expectations/isClickable.js.map +0 -1
package/lib/expectations/isEnabled.d.ts +0 -14
package/lib/expectations/isEnabled.js +0 -20
package/lib/expectations/isEnabled.js.map +0 -1
package/lib/expectations/isPresent.d.ts +0 -15
package/lib/expectations/isPresent.js +0 -21
package/lib/expectations/isPresent.js.map +0 -1
package/lib/expectations/isSelected.d.ts +0 -14
package/lib/expectations/isSelected.js +0 -20
package/lib/expectations/isSelected.js.map +0 -1
package/lib/expectations/isVisible.d.ts +0 -14
package/lib/expectations/isVisible.js +0 -20
package/lib/expectations/isVisible.js.map +0 -1
package/lib/input/Key.d.ts +0 -73
package/lib/input/Key.js +0 -84
package/lib/input/Key.js.map +0 -1
package/lib/input/index.d.ts +0 -1
package/lib/input/index.js.map +0 -1
package/lib/screenplay/abilities/BrowseTheWeb.js.map +0 -1
package/lib/screenplay/interactions/Clear.d.ts +0 -79
package/lib/screenplay/interactions/Clear.js +0 -97
package/lib/screenplay/interactions/Clear.js.map +0 -1
package/lib/screenplay/interactions/Click.d.ts +0 -73
package/lib/screenplay/interactions/Click.js +0 -84
package/lib/screenplay/interactions/Click.js.map +0 -1
package/lib/screenplay/interactions/DoubleClick.d.ts +0 -90
package/lib/screenplay/interactions/DoubleClick.js +0 -101
package/lib/screenplay/interactions/DoubleClick.js.map +0 -1
package/lib/screenplay/interactions/Enter.d.ts +0 -73
package/lib/screenplay/interactions/Enter.js +0 -87
package/lib/screenplay/interactions/Enter.js.map +0 -1
package/lib/screenplay/interactions/EnterBuilder.d.ts +0 -25
package/lib/screenplay/interactions/EnterBuilder.js.map +0 -1
package/lib/screenplay/interactions/ExecuteScript.d.ts +0 -206
package/lib/screenplay/interactions/ExecuteScript.js +0 -311
package/lib/screenplay/interactions/ExecuteScript.js.map +0 -1
package/lib/screenplay/interactions/Hover.d.ts +0 -78
package/lib/screenplay/interactions/Hover.js +0 -89
package/lib/screenplay/interactions/Hover.js.map +0 -1
package/lib/screenplay/interactions/Navigate.d.ts +0 -141
package/lib/screenplay/interactions/Navigate.js +0 -197
package/lib/screenplay/interactions/Navigate.js.map +0 -1
package/lib/screenplay/interactions/Press.d.ts +0 -84
package/lib/screenplay/interactions/Press.js +0 -152
package/lib/screenplay/interactions/Press.js.map +0 -1
package/lib/screenplay/interactions/PressBuilder.d.ts +0 -26
package/lib/screenplay/interactions/PressBuilder.js +0 -3
package/lib/screenplay/interactions/PressBuilder.js.map +0 -1
package/lib/screenplay/interactions/RightClick.d.ts +0 -89
package/lib/screenplay/interactions/RightClick.js +0 -100
package/lib/screenplay/interactions/RightClick.js.map +0 -1
package/lib/screenplay/interactions/Scroll.d.ts +0 -75
package/lib/screenplay/interactions/Scroll.js +0 -86
package/lib/screenplay/interactions/Scroll.js.map +0 -1
package/lib/screenplay/interactions/Wait.d.ts +0 -143
package/lib/screenplay/interactions/Wait.js +0 -247
package/lib/screenplay/interactions/Wait.js.map +0 -1
package/lib/screenplay/interactions/WaitBuilder.d.ts +0 -32
package/lib/screenplay/interactions/WaitBuilder.js +0 -3
package/lib/screenplay/interactions/WaitBuilder.js.map +0 -1
package/lib/screenplay/interactions/WebElementInteraction.d.ts +0 -37
package/lib/screenplay/interactions/WebElementInteraction.js +0 -52
package/lib/screenplay/interactions/WebElementInteraction.js.map +0 -1
package/lib/screenplay/interactions/index.d.ts +0 -13
package/lib/screenplay/interactions/index.js +0 -26
package/lib/screenplay/interactions/index.js.map +0 -1
package/lib/screenplay/questions/Attribute.d.ts +0 -82
package/lib/screenplay/questions/Attribute.js +0 -102
package/lib/screenplay/questions/Attribute.js.map +0 -1
package/lib/screenplay/questions/CSSClasses.d.ts +0 -92
package/lib/screenplay/questions/CSSClasses.js +0 -112
package/lib/screenplay/questions/CSSClasses.js.map +0 -1
package/lib/screenplay/questions/LastScriptExecution.d.ts +0 -14
package/lib/screenplay/questions/LastScriptExecution.js +0 -22
package/lib/screenplay/questions/LastScriptExecution.js.map +0 -1
package/lib/screenplay/questions/NestedTargetBuilder.d.ts +0 -27
package/lib/screenplay/questions/NestedTargetBuilder.js +0 -3
package/lib/screenplay/questions/NestedTargetBuilder.js.map +0 -1
package/lib/screenplay/questions/TargetBuilder.d.ts +0 -25
package/lib/screenplay/questions/TargetBuilder.js +0 -3
package/lib/screenplay/questions/TargetBuilder.js.map +0 -1
package/lib/screenplay/questions/Text.d.ts +0 -95
package/lib/screenplay/questions/Text.js +0 -130
package/lib/screenplay/questions/Text.js.map +0 -1
package/lib/screenplay/questions/Value.d.ts +0 -63
package/lib/screenplay/questions/Value.js +0 -78
package/lib/screenplay/questions/Value.js.map +0 -1
package/lib/screenplay/questions/Website.d.ts +0 -21
package/lib/screenplay/questions/Website.js +0 -31
package/lib/screenplay/questions/Website.js.map +0 -1
package/lib/screenplay/questions/index.d.ts +0 -10
package/lib/screenplay/questions/index.js +0 -23
package/lib/screenplay/questions/index.js.map +0 -1
package/lib/screenplay/questions/lists.d.ts +0 -86
package/lib/screenplay/questions/lists.js +0 -137
package/lib/screenplay/questions/lists.js.map +0 -1
package/lib/screenplay/questions/locators.d.ts +0 -196
package/lib/screenplay/questions/locators.js +0 -219
package/lib/screenplay/questions/locators.js.map +0 -1
package/lib/screenplay/questions/targets.d.ts +0 -254
package/lib/screenplay/questions/targets.js +0 -334
package/lib/screenplay/questions/targets.js.map +0 -1
package/lib/stage/crew/index.d.ts +0 -1
package/lib/stage/crew/index.js +0 -14
package/lib/stage/crew/index.js.map +0 -1
package/lib/stage/crew/photographer/Photographer.d.ts +0 -83
package/lib/stage/crew/photographer/Photographer.js +0 -102
package/lib/stage/crew/photographer/Photographer.js.map +0 -1
package/lib/stage/crew/photographer/index.d.ts +0 -2
package/lib/stage/crew/photographer/index.js +0 -15
package/lib/stage/crew/photographer/index.js.map +0 -1
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.d.ts +0 -28
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js +0 -65
package/lib/stage/crew/photographer/strategies/PhotoTakingStrategy.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.d.ts +0 -18
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js +0 -30
package/lib/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.d.ts +0 -17
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js +0 -28
package/lib/stage/crew/photographer/strategies/TakePhotosOfFailures.js.map +0 -1
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.d.ts +0 -19
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js +0 -28
package/lib/stage/crew/photographer/strategies/TakePhotosOfInteractions.js.map +0 -1
package/lib/stage/crew/photographer/strategies/index.d.ts +0 -4
package/lib/stage/crew/photographer/strategies/index.js +0 -17
package/lib/stage/crew/photographer/strategies/index.js.map +0 -1
package/lib/stage/index.d.ts +0 -1
package/lib/stage/index.js +0 -14
package/lib/stage/index.js.map +0 -1
package/src/expectations/ElementExpectation.ts +0 -31
package/src/expectations/index.ts +0 -6
package/src/expectations/isActive.ts +0 -21
package/src/expectations/isClickable.ts +0 -26
package/src/expectations/isEnabled.ts +0 -19
package/src/expectations/isPresent.ts +0 -20
package/src/expectations/isSelected.ts +0 -19
package/src/expectations/isVisible.ts +0 -19
package/src/input/Key.ts +0 -83
package/src/input/index.ts +0 -1
package/src/screenplay/interactions/Clear.ts +0 -102
package/src/screenplay/interactions/Click.ts +0 -85
package/src/screenplay/interactions/DoubleClick.ts +0 -102
package/src/screenplay/interactions/Enter.ts +0 -93
package/src/screenplay/interactions/EnterBuilder.ts +0 -27
package/src/screenplay/interactions/ExecuteScript.ts +0 -344
package/src/screenplay/interactions/Hover.ts +0 -90
package/src/screenplay/interactions/Navigate.ts +0 -208
package/src/screenplay/interactions/Press.ts +0 -172
package/src/screenplay/interactions/PressBuilder.ts +0 -28
package/src/screenplay/interactions/RightClick.ts +0 -100
package/src/screenplay/interactions/Scroll.ts +0 -87
package/src/screenplay/interactions/Wait.ts +0 -267
package/src/screenplay/interactions/WaitBuilder.ts +0 -34
package/src/screenplay/interactions/WebElementInteraction.ts +0 -56
package/src/screenplay/interactions/index.ts +0 -13
package/src/screenplay/questions/Attribute.ts +0 -112
package/src/screenplay/questions/CSSClasses.ts +0 -116
package/src/screenplay/questions/LastScriptExecution.ts +0 -21
package/src/screenplay/questions/NestedTargetBuilder.ts +0 -30
package/src/screenplay/questions/TargetBuilder.ts +0 -27
package/src/screenplay/questions/Text.ts +0 -140
package/src/screenplay/questions/Value.ts +0 -82
package/src/screenplay/questions/Website.ts +0 -34
package/src/screenplay/questions/index.ts +0 -10
package/src/screenplay/questions/lists.ts +0 -161
package/src/screenplay/questions/locators.ts +0 -254
package/src/screenplay/questions/targets.ts +0 -401
package/src/stage/crew/index.ts +0 -1
package/src/stage/crew/photographer/Photographer.ts +0 -108
package/src/stage/crew/photographer/index.ts +0 -2
package/src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts +0 -103
package/src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts +0 -28
package/src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts +0 -26
package/src/stage/crew/photographer/strategies/TakePhotosOfInteractions.ts +0 -26
package/src/stage/crew/photographer/strategies/index.ts +0 -4
package/src/stage/index.ts +0 -1

package/src/screenplay/questions/targets.ts DELETED Viewed

@@ -1,401 +0,0 @@
-/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
-import { Answerable, AnswersQuestions, Expectation, List, LogicError, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { formatted } from '@serenity-js/core/lib/io';
-import type { Element, ElementArray } from 'webdriverio';
-import { ElementArrayListAdapter } from './lists';
-import { Locator } from './locators';
-import { NestedTargetBuilder } from './NestedTargetBuilder';
-import { TargetBuilder } from './TargetBuilder';
-/**
- * @desc
- *  A type alias representing a {@link @serenity-js/core/lib/screenplay/questions~List} of WebdriverIO Web elements.
- *
- * @public
- *
- * @see {@link @serenity-js/core/lib/screenplay/questions~List}
- *
- * @typedef {List<ElementArrayListAdapter, Promise<Element<'async'>>, Promise<ElementArray>>} TargetList
- */
-export type TargetList = List<ElementArrayListAdapter, Promise<Element<'async'>>, Promise<ElementArray>>;
-/**
- * @desc
- *  Provides a convenient way to retrieve a single web element or multiple web elements,
- *  so that they can be used with Serenity/JS {@link @serenity-js/core/lib/screenplay~Interaction}s.
- *
- *  Check out the examples below, as well as the unit tests demonstrating the usage.
- *
- *  @example <caption>Imaginary website under test</caption>
- *   <body>
- *       <ul id="basket">
- *           <li><a href="#">Apple</a></li>
- *           <li><a href="#">Banana</a></li>
- *           <li><a href="#">Coconut</a></li>
- *           <li><a href="#" class="has-discount">Date</a></li>
- *       </ul>
- *       <div id="summary">
- *           <strong class="out-of-stock">Coconut</strong> is not available
- *       </div>
- *       <button type="submit">Proceed to Checkout</button>
- *   </body>
- *
- *  @example <caption>Locating a single element</caption>
- *   import { by, Target, TargetElement } from '@serenity-js/webdriverio';
- *
- *   const proceedToCheckoutButton: TargetElement =
- *       Target.the('Proceed to Checkout button').located(by.css(`button[type='submit']`));
- *
- *  @example <caption>Locating multiple elements</caption>
- *   import { by, Target, TargetElements } from '@serenity-js/webdriverio';
- *
- *   const basketItems: TargetElements =
- *       Target.all('items in the basket').located(by.css('ul#basket li'));
- *
- *  @example <caption>Locating element relative to another element</caption>
- *   import { by, Target, TargetElement } from '@serenity-js/webdriverio';
- *
- *   const summary: TargetElement =
- *       Target.the('summary').located(by.id('message'));
- *
- *   const outOfStockItem: TargetElement =
- *       Target.the('out of stock item').of(summary).located(by.css('.out-of-stock'))
- *
- *  @example <caption>Filtering elements matched by a locator</caption>
- *   import { by, Target, Text } from '@serenity-js/webdriverio';
- *   import { endsWith } from '@serenity-js/assertions';
- *
- *   const basketItems =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .where(Text, endsWith('e'));    // Apple, Date
- *
- *  @example <caption>Counting items matched by a locator</caption>
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { Question } from '@serenity-js/core';
- *   import { by, Target, Text } from '@serenity-js/webdriverio';
- *
- *   const basketItemsCount: Question<Promise<number>> =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .count()    // 4
- *
- *  @example <caption>Getting first item matched by a locator</caption>
- *   import { Question } from '@serenity-js/core';
- *   import { by, Target } from '@serenity-js/webdriverio';
- *   import { Element } from 'webdriverio';
- *
- *   const apple: Question<Promise<Element<'async'>>>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .first()
- *
- *  @example <caption>Getting last item matched by a locator</caption>
- *   import { Question } from '@serenity-js/core';
- *   import { by, Target } from '@serenity-js/webdriverio';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { Element } from 'webdriverio';
- *
- *   const date: Question<Promise<Element<'async'>>>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .last()
- *
- *  @example <caption>Getting nth item matched by a locator</caption>
- *   import { Question } from '@serenity-js/core';
- *   import { by, Target } from '@serenity-js/webdriverio';
- *   import { Element } from 'webdriverio';
- *
- *   const banana: Question<Promise<Element<'async'>>>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .get(1)
- *
- *  @example <caption>Using multiple filters and nested targets</caption>
- *   import { Question } from '@serenity-js/core';
- *   import { contain, endsWith } from '@serenity-js/assertions';
- *   import { by, CSSClasses, Target, Text } from '@serenity-js/webdriverio';
- *   import { Element } from 'webdriverio';
- *
- *   class Basket {
- *       static component = Target.the('basket').located(by.id('basket'));
- *
- *       static items     = Target.all('items').located(by.css('li'))
- *          .of(Basket.component);
- *
- *       static link      = Target.the('link').located(by.css('a'));
- *   }
- *
- *   const date: Question<Promise<Element<'async'>>>  =
- *       Basket.items
- *          .where(Text, endsWith('e'))
- *          .where(CSSClasses.of(Basket.link), contain('has-discount'))
- *          .first()
- *
- *  @example <caption>Clicking on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click } from '@serenity-js/webdriverio';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(browser))
- *       .attemptsTo(
- *           Click.on(proceedToCheckoutButton),
- *       );
- *
- *  @example <caption>Retrieving text of multiple elements and performing an assertion</caption>
- *   import { Ensure, contain } from '@serenity-js/assertions';
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Text } from '@serenity-js/webdriverio';
- *
- *   const basketItemNames = Text.ofAll(basketItems);
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(browser))
- *       .attemptsTo(
- *           Ensure.that(basketItemNames, contain('Apple'))
- *       );
- *
- *  @example <caption>Waiting on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Wait, isClickable } from '@serenity-js/webdriverio';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(browser))
- *       .attemptsTo(
- *           Wait.until(proceedToCheckoutButton, isClickable()),
- *       );
- */
-export class Target {
-    /**
-     * @desc
-     *  Locates a single Web element
-     *
-     * @param {string} description
-     *  A human-readable name of the element, which will be used in the report
-     *
-     * @returns {TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement>}
-     */
-    static the(description: string): TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement> {
-        return {
-            located(locator: Locator): TargetElement {
-                return new TargetElement(`the ${ description }`, locator);
-            },
-            of(parent: Answerable<Element<'async'>>) {
-                return {
-                    located(locator: Locator): TargetNestedElement {
-                        return new TargetNestedElement(parent, new TargetElement(description, locator));
-                    }
-                }
-            }
-        }
-    }
-    /**
-     * @desc
-     *  Locates a group of Web elements
-     *
-     * @param {string} description
-     *  A human-readable name of the group of elements, which will be used in the report
-     *
-     * @returns {TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements>}
-     */
-    static all(description: string): TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements> {
-        return {
-            located(locator: Locator): TargetElements {
-                return new TargetElements(description, locator);
-            },
-            of(parent: Answerable<Element<'async'>>) {
-                return {
-                    located(locator: Locator): TargetNestedElements {
-                        return new TargetNestedElements(parent, new TargetElements(description, locator));
-                    }
-                }
-            }
-        }
-    }
-}
-/**
- * @desc
- *  You probably don't want to use this class directly. See {@link Target} instead.
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- *
- * @see {@link Target}
- */
-export class TargetElements
-    extends Question<Promise<ElementArray>>
-    implements MetaQuestion<Answerable<Element<'async'>>, Promise<ElementArray>>
-{
-    private readonly list: List<ElementArrayListAdapter, Promise<Element<'async'>>, Promise<ElementArray>>;
-    constructor(
-        description: string,
-        private readonly locator: Locator,
-    ) {
-        super(description);
-        this.list = new List(new ElementArrayListAdapter(this));
-    }
-    of(parent: Answerable<Element<'async'>>): TargetNestedElements {
-        return new TargetNestedElements(parent, this);
-    }
-    count(): Question<Promise<number>> {
-        return this.list.count();
-    }
-    first(): Question<Promise<Element<'async'>>> {
-        return this.list.first()
-    }
-    last(): Question<Promise<Element<'async'>>> {
-        return this.list.last()
-    }
-    get(index: number): Question<Promise<Element<'async'>>> {
-        return this.list.get(index);
-    }
-    where<Answer_Type>(
-        question: MetaQuestion<Answerable<Element<'async'>>, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>,
-    ): TargetList {
-        return this.list.where(question, expectation);
-    }
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<ElementArray> {
-        return this.locator.allMatching()
-            .describedAs(this.subject)
-            .answeredBy(actor);
-    }
-}
-/**
- * @desc
- *  You probably don't want to use this class directly. See {@link Target} instead.
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- *
- * @see {@link Target}
- */
-export class TargetNestedElements
-    extends Question<Promise<ElementArray>>
-    implements MetaQuestion<Answerable<Element<'async'>>, Promise<ElementArray>>
-{
-    private readonly list: List<ElementArrayListAdapter, Promise<Element<'async'>>, Promise<ElementArray>>;
-    constructor(
-        private readonly parent: Answerable<Element<'async'>>,
-        private readonly children: Answerable<ElementArray>,
-    ) {
-        super(`${ children } of ${ parent }`);
-        this.list = new List(new ElementArrayListAdapter(this));
-    }
-    of(parent: Answerable<Element<'async'>>): Question<Promise<ElementArray>> {
-        return new TargetNestedElements(parent, this);
-    }
-    count(): Question<Promise<number>> {
-        return this.list.count();
-    }
-    first(): Question<Promise<Element<'async'>>> {
-        return this.list.first()
-    }
-    last(): Question<Promise<Element<'async'>>> {
-        return this.list.last()
-    }
-    get(index: number): Question<Promise<Element<'async'>>> {
-        return this.list.get(index);
-    }
-    where<Answer_Type>(
-        question: MetaQuestion<Answerable<Element<'async'>>, Promise<Answer_Type> | Answer_Type>,
-        expectation: Expectation<any, Answer_Type>,
-    ): TargetList {
-        return this.list.where(question, expectation);
-    }
-    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<ElementArray> {
-        const parent   = await actor.answer(this.parent);
-        const children = await actor.answer(this.children);
-        if (! parent) {
-            throw new LogicError(formatted `Couldn't find ${ this.parent }`);
-        }
-        return parent.$$(children.selector);
-    }
-}
-/**
- * @desc
- *  You probably don't want to use this class directly. See {@link Target} instead.
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- *
- * @see {@link Target}
- */
-export class TargetElement
-    extends Question<Promise<Element<'async'>>>
-    implements MetaQuestion<Answerable<Element<'async'>>, Promise<Element<'async'>>>
-{
-    constructor(
-        description: string,
-        private readonly locator: Locator,
-    ) {
-        super(description);
-    }
-    of(parent: Answerable<Element<'async'>>): Question<Promise<Element<'async'>>> {
-        return new TargetNestedElement(parent, this);
-    }
-    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Element<'async'>> {
-        return this.locator.firstMatching()
-            .describedAs(this.subject)
-            .answeredBy(actor);
-    }
-}
-/**
- * @desc
- *  You probably don't want to use this class directly. See {@link Target} instead.
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- *
- * @see {@link Target}
- */
-export class TargetNestedElement
-    extends Question<Promise<Element<'async'>>>
-    implements MetaQuestion<Answerable<Element<'async'>>, Promise<Element<'async'>>>
-{
-    constructor(
-        private readonly parent: Answerable<Element<'async'>>,
-        private readonly child: Answerable<Element<'async'>>,
-    ) {
-        super(`${ child } of ${ parent }`);
-    }
-    of(parent: Answerable<Element<'async'>>): Question<Promise<Element<'async'>>> {
-        return new TargetNestedElement(parent, this);
-    }
-    async answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Element<'async'>> {
-        const parent = await actor.answer(this.parent);
-        const child  = await actor.answer(this.child);
-        if (! parent) {
-            throw new LogicError(formatted `Couldn't find ${ this.parent }`);
-        }
-        return parent.$(child.selector);
-    }
-}

package/src/stage/crew/index.ts DELETED Viewed

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

package/src/stage/crew/photographer/Photographer.ts DELETED Viewed

@@ -1,108 +0,0 @@
-import { LogicError } from '@serenity-js/core';
-import { ActivityFinished, ActivityStarts, 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 that the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight is using.
- *
- * @example <caption>Assigning the Photographer to the Stage</caption>
- * // wdio.conf.ts
- * import { ArtifactArchiver } from '@serenity-js/core';
- * import { Photographer, TakePhotosOfFailures } from '@serenity-js/webdriverio';
- *
- * export const config = {
- *
- *     serenity: {
- *         crew: [
- *             ArtifactArchiver.storingArtifactsAt(process.cwd(), 'target/site/serenity'),
- *             Photographer.whoWill(TakePhotosOfFailures),
- *         ]
- *     },
- *
- *     // ... rest of the config omitted for brevity
- * };
- *
- * @example <caption>Taking photos upon failures only</caption>
- *
- * import { Photographer, TakePhotosOfFailures } from '@serenity-js/webdriverio';
- *
- * Photographer.whoWill(TakePhotosOfFailures)
- *
- * @example <caption>Taking photos of all the interactions</caption>
- *
- * import { Photographer, TakePhotosOfInteractions } from '@serenity-js/webdriverio';
- *
- * Photographer.whoWill(TakePhotosOfInteractions)
- *
- * @example <caption>Taking photos before and after all the interactions</caption>
- *
- * import { Photographer, TakePhotosBeforeAndAfterInteractions } from '@serenity-js/webdriverio';
- *
- * Photographer.whoWill(TakePhotosBeforeAndAfterInteractions)
- *
- * @see {@link @serenity-js/core/lib/stage~Stage}
- * @see {@link TakePhotosBeforeAndAfterInteractions}
- * @see {@link TakePhotosOfFailures}
- * @see {@link TakePhotosOfInteractions}
- */
-export class Photographer implements StageCrewMember {
-    /**
-     * @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 {
-        return new Photographer(new strategy());
-    }
-    /**
-     * @param {PhotoTakingStrategy} photoTakingStrategy
-     * @param {Stage} stage
-     */
-    constructor(
-        private readonly photoTakingStrategy: PhotoTakingStrategy,
-        private 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 {
-        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: DomainEvent): void {
-        if (! this.stage) {
-            throw new LogicError(`Photographer needs to be assigned to the Stage before it can be notified of any DomainEvents`);
-        }
-        if (! this.stage.theShowHasStarted()) {
-            return void 0;
-        }
-        if (event instanceof ActivityStarts || event instanceof ActivityFinished) {
-            this.photoTakingStrategy.considerTakingPhoto(event, this.stage);
-        }
-    }
-}

package/src/stage/crew/photographer/index.ts DELETED Viewed

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

package/src/stage/crew/photographer/strategies/PhotoTakingStrategy.ts DELETED Viewed

@@ -1,103 +0,0 @@
-import { Stage } from '@serenity-js/core';
-import {
-    ActivityFinished,
-    ActivityRelatedArtifactGenerated,
-    ActivityStarts,
-    AsyncOperationAttempted,
-    AsyncOperationCompleted,
-    AsyncOperationFailed,
-    DomainEvent,
-} from '@serenity-js/core/lib/events';
-import { CorrelationId, Description, Name, Photo } from '@serenity-js/core/lib/model';
-import { Capabilities } from '@wdio/types';
-import { BrowseTheWeb } from '../../../../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
- */
-export 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 {
-        if (this.shouldTakeAPhotoOf(event)) {
-            let browseTheWeb: BrowseTheWeb;
-            try {
-                browseTheWeb = BrowseTheWeb.as(stage.theActorInTheSpotlight());
-            } catch {
-                return void 0;
-            }
-            const
-                id              = CorrelationId.create(),
-                nameSuffix      = this.photoNameFor(event),
-                // todo: test if this type def is really DesiredCapabilities when multi-capabilities are used
-                capabilities    = browseTheWeb.browser.capabilities as Capabilities.DesiredCapabilities;
-            stage.announce(new AsyncOperationAttempted(
-                new Description(`[Photographer:${ this.constructor.name }] Taking screenshot of '${ nameSuffix }'...`),
-                id,
-            ));
-            browseTheWeb.takeScreenshot().then(screenshot => {
-                const
-                    context   = [ capabilities.platformName, capabilities.browserName, capabilities.browserVersion ],
-                    photoName = this.combinedNameFrom(...context, nameSuffix);
-                stage.announce(new ActivityRelatedArtifactGenerated(
-                    event.sceneId,
-                    event.activityId,
-                    photoName,
-                    Photo.fromBase64(screenshot),
-                ));
-                stage.announce(new AsyncOperationCompleted(
-                    new Description(`[${ this.constructor.name }] Took screenshot of '${ nameSuffix }' on ${ context }`),
-                    id,
-                ));
-            }).catch(error => {
-                if (this.shouldIgnore(error)) {
-                    stage.announce(new AsyncOperationCompleted(
-                        new Description(`[${ this.constructor.name }] Aborted taking screenshot of '${ nameSuffix }' because of ${ error.constructor && error.constructor.name }`),
-                        id,
-                    ));
-                }
-                else {
-                    stage.announce(new AsyncOperationFailed(error, id));
-                }
-            });
-        }
-    }
-    protected abstract shouldTakeAPhotoOf(event: DomainEvent): boolean;
-    protected abstract photoNameFor(event: DomainEvent): string;
-    private combinedNameFrom(...parts: string[]): Name {
-        return new Name(parts.filter(v => !! v).join('-'));
-    }
-    private shouldIgnore(error: Error) {
-        // todo
-        // return error instanceof webdriver.NoSuchSessionError
-        //     || error instanceof webdriver.UnexpectedAlertOpenError
-        return false;
-    }
-}

package/src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts DELETED Viewed

@@ -1,28 +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 class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy {
-    protected shouldTakeAPhotoOf(event: DomainEvent): boolean {
-        return event instanceof InteractionStarts
-            || event instanceof InteractionFinished;
-    }
-    protected photoNameFor(event: InteractionStarts | InteractionFinished): string {
-        return event instanceof InteractionStarts
-            ? `Before ${ event.details.name.value }`
-            : `After ${ event.details.name.value }`;
-    }
-}

package/src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts DELETED Viewed

@@ -1,26 +0,0 @@
-import { DomainEvent, InteractionFinished } from '@serenity-js/core/lib/events';
-import { ImplementationPending } from '@serenity-js/core/lib/model';
-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.
- *
- *  This strategy works best when you are interested in the screenshots only when
- *  a scenario fails.
- *
- * @extends {PhotoTakingStrategy}
- */
-export class TakePhotosOfFailures extends PhotoTakingStrategy {
-    protected shouldTakeAPhotoOf(event: DomainEvent): boolean {
-        return event instanceof InteractionFinished
-            && event.outcome.isWorseThan(ImplementationPending);
-    }
-    protected photoNameFor(event: InteractionFinished): string {
-        return event.details.name.value;
-    }
-}