@serenity-js/protractor 2.32.3 → 3.0.0-rc.1

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

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TakePhotosBeforeAndAfterInteractions = void 0;
-const events_1 = require("@serenity-js/core/lib/events");
-const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
-/**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) both before and after
- *  every single {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight.
- *
- *  *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}
- */
-class TakePhotosBeforeAndAfterInteractions extends PhotoTakingStrategy_1.PhotoTakingStrategy {
-    shouldTakeAPhotoOf(event) {
-        return event instanceof events_1.InteractionStarts
-            || event instanceof events_1.InteractionFinished;
-    }
-    photoNameFor(event) {
-        return event instanceof events_1.InteractionStarts
-            ? `Before ${event.details.name.value}`
-            : `After ${event.details.name.value}`;
-    }
-}
-exports.TakePhotosBeforeAndAfterInteractions = TakePhotosBeforeAndAfterInteractions;
-//# sourceMappingURL=TakePhotosBeforeAndAfterInteractions.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TakePhotosBeforeAndAfterInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosBeforeAndAfterInteractions.ts"],"names":[],"mappings":";;;AAAA,yDAAmG;AAEnG,+DAA4D;AAE5D;;;;;;;;;;;GAWG;AACH,MAAa,oCAAqC,SAAQ,yCAAmB;IAC/D,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,0BAAiB;eAClC,KAAK,YAAY,4BAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA8C;QACjE,OAAO,KAAK,YAAY,0BAAiB;YACrC,CAAC,CAAC,UAAW,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAM,EAAE;YACxC,CAAC,CAAC,SAAU,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAM,EAAE,CAAC;IAChD,CAAC;CACJ;AAXD,oFAWC"}

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

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

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

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TakePhotosOfFailures = void 0;
-const events_1 = require("@serenity-js/core/lib/events");
-const model_1 = require("@serenity-js/core/lib/model");
-const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
-/**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the {@link @serenity-js/core/lib/screenplay~Interaction} performed
- *  by the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight results in an error.
- *
- *  This strategy works best when you are interested in the screenshots only when
- *  the a fails.
- *
- * @extends {PhotoTakingStrategy}
- */
-class TakePhotosOfFailures extends PhotoTakingStrategy_1.PhotoTakingStrategy {
-    shouldTakeAPhotoOf(event) {
-        return event instanceof events_1.InteractionFinished
-            && event.outcome.isWorseThan(model_1.ImplementationPending);
-    }
-    photoNameFor(event) {
-        return event.details.name.value;
-    }
-}
-exports.TakePhotosOfFailures = TakePhotosOfFailures;
-//# sourceMappingURL=TakePhotosOfFailures.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TakePhotosOfFailures.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfFailures.ts"],"names":[],"mappings":";;;AAAA,yDAAgF;AAChF,uDAAoE;AAEpE,+DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,MAAa,oBAAqB,SAAQ,yCAAmB;IAC/C,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,4BAAmB;eACpC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,6BAAqB,CAAC,CAAC;IAC5D,CAAC;IAES,YAAY,CAAC,KAA0B;QAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACpC,CAAC;CACJ;AATD,oDASC"}

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

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

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

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TakePhotosOfInteractions = void 0;
-const events_1 = require("@serenity-js/core/lib/events");
-const PhotoTakingStrategy_1 = require("./PhotoTakingStrategy");
-/**
- * @desc
- *  Configures the {@link Photographer} to take photos (a.k.a. screenshots) when
- *  the the {@link @serenity-js/core/lib/screenplay/actor~Actor} in the spotlight
- *  performs any {@link @serenity-js/core/lib/screenplay~Interaction}.
- *
- *  This strategy works best when you want the results of your automated tests
- *  to become comprehensive living documentation of your system.
- *
- *  *Please note* that taking screenshots affects the performance of your tests.
- *
- * @extends {PhotoTakingStrategy}
- */
-class TakePhotosOfInteractions extends PhotoTakingStrategy_1.PhotoTakingStrategy {
-    shouldTakeAPhotoOf(event) {
-        return event instanceof events_1.InteractionFinished;
-    }
-    photoNameFor(event) {
-        return event.details.name.value;
-    }
-}
-exports.TakePhotosOfInteractions = TakePhotosOfInteractions;
-//# sourceMappingURL=TakePhotosOfInteractions.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TakePhotosOfInteractions.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/TakePhotosOfInteractions.ts"],"names":[],"mappings":";;;AAAA,yDAAgF;AAEhF,+DAA4D;AAE5D;;;;;;;;;;;;GAYG;AACH,MAAa,wBAAyB,SAAQ,yCAAmB;IACnD,kBAAkB,CAAC,KAAkB;QAC3C,OAAO,KAAK,YAAY,4BAAmB,CAAC;IAChD,CAAC;IAES,YAAY,CAAC,KAA0B;QAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACpC,CAAC;CACJ;AARD,4DAQC"}

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

@@ -1,4 +0,0 @@
-export * from './PhotoTakingStrategy';
-export * from './TakePhotosBeforeAndAfterInteractions';
-export * from './TakePhotosOfFailures';
-export * from './TakePhotosOfInteractions';

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

@@ -1,17 +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("./PhotoTakingStrategy"), exports);
-__exportStar(require("./TakePhotosBeforeAndAfterInteractions"), exports);
-__exportStar(require("./TakePhotosOfFailures"), exports);
-__exportStar(require("./TakePhotosOfInteractions"), exports);
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/stage/crew/photographer/strategies/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wDAAsC;AACtC,yEAAuD;AACvD,yDAAuC;AACvC,6DAA2C"}

package/lib/stage/index.d.ts

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

package/lib/stage/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("./crew"), exports);
-//# sourceMappingURL=index.js.map

package/lib/stage/index.js.map

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

package/src/expectations/ElementFinderExpectation.ts

@@ -1,29 +0,0 @@
-import { AnswersQuestions, Expectation, ExpectationMet, ExpectationNotMet, ExpectationOutcome } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { promiseOf } from '../promiseOf';
-
-/**
- * @access private
- */
-export class ElementFinderExpectation extends Expectation<any, ElementFinder> {
-    static forElementTo(message: string, fn: (actual: ElementFinder) => PromiseLike<boolean>): Expectation<any, ElementFinder> {
-        return new ElementFinderExpectation(message, fn);
-    }
-
-    constructor(
-        subject: string,
-        private readonly fn: (actual: ElementFinder) => PromiseLike<boolean>,
-    ) {
-        super(subject);
-    }
-
-    answeredBy(actor: AnswersQuestions): (actual: ElementFinder) => Promise<ExpectationOutcome<boolean, ElementFinder>> {
-
-        return (actual: ElementFinder) =>
-            promiseOf(this.fn(actual)).then(_ => _
-                ? new ExpectationMet(this.toString(), undefined, actual)
-                : new ExpectationNotMet(this.toString(), undefined, actual),
-            );
-    }
-}

package/src/expectations/index.ts

@@ -1,6 +0,0 @@
-export * from './isActive';
-export * from './isClickable';
-export * from './isEnabled';
-export * from './isPresent';
-export * from './isSelected';
-export * from './isVisible';

package/src/expectations/isActive.ts

@@ -1,24 +0,0 @@
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder, WebElement } from 'protractor';
-
-import { ElementFinderExpectation } from './ElementFinderExpectation';
-
-/**
- * @desc
- *  Expectation that the element is active.
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isActive(): Expectation<boolean, ElementFinder> {
-    return ElementFinderExpectation.forElementTo('become active', (actual: ElementFinder) =>
-        actual.getWebElement().then(element =>
-            element.getDriver().switchTo().activeElement().then((active: WebElement) =>
-                actual.equals(active),
-            ),
-        ),
-    );
-}

package/src/expectations/isClickable.ts

@@ -1,20 +0,0 @@
-import { and } from '@serenity-js/assertions';
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { isEnabled } from './isEnabled';
-import { isVisible } from './isVisible';
-
-/**
- * @desc
- *  Expectation that the element is visible and enabled, and therefore clickable
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isClickable(): Expectation<any, ElementFinder> {
-    return Expectation.to<ElementFinder>('become clickable').soThatActual(and(isVisible(), isEnabled()));
-}

package/src/expectations/isEnabled.ts

@@ -1,18 +0,0 @@
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { ElementFinderExpectation } from './ElementFinderExpectation';
-
-/**
- * @desc
- *  Expectation that the element is enabled.
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isEnabled(): Expectation<boolean, ElementFinder> {
-    return ElementFinderExpectation.forElementTo('become enabled', actual => actual.isEnabled());
-}

package/src/expectations/isPresent.ts

@@ -1,19 +0,0 @@
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { ElementFinderExpectation } from './ElementFinderExpectation';
-
-/**
- * @desc
- *  Expectation that the element is present in the DOM of a page.
- *  Please note that this does not necessarily mean that the element is visible.
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isPresent(): Expectation<boolean, ElementFinder> {
-    return ElementFinderExpectation.forElementTo('become present', actual => actual.isPresent());
-}

package/src/expectations/isSelected.ts

@@ -1,23 +0,0 @@
-import { and } from '@serenity-js/assertions';
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { ElementFinderExpectation } from './ElementFinderExpectation';
-import { isPresent } from './isPresent';
-
-/**
- * @desc
- *  Expectation that the element is present and selected
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isSelected(): Expectation<any, ElementFinder> {
-    return Expectation.to<ElementFinder>('become selected').soThatActual(and(
-        isPresent(),
-        ElementFinderExpectation.forElementTo('become selected', actual => actual.isSelected()),
-    ));
-}

package/src/expectations/isVisible.ts

@@ -1,27 +0,0 @@
-import { and } from '@serenity-js/assertions';
-import { Expectation } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-
-import { ElementFinderExpectation } from './ElementFinderExpectation';
-import { isPresent } from './isPresent';
-
-/**
- * @desc
- *  Expectation that the element is present in the DOM of the page and visible.
- *
- * @returns {@serenity-js/core/lib/screenplay/questions~Expectation<boolean, ElementFinder>}
- *
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/core/lib/screenplay/questions~Check}
- * @see {@link Wait}
- */
-export function isVisible(): Expectation<any, ElementFinder> {
-    return Expectation.to<ElementFinder>('become visible').soThatActual(and(
-        isPresent(),
-        isDisplayed(),
-    ));
-}
-
-function isDisplayed(): Expectation<any, ElementFinder> {
-    return ElementFinderExpectation.forElementTo('become displayed', actual => actual.isDisplayed());
-}

package/src/screenplay/interactions/Accept.ts

@@ -1,95 +0,0 @@
-import { AnswersQuestions, Interaction, Question, UsesAbilities } from '@serenity-js/core';
-import { formatted } from '@serenity-js/core/lib/io';
-import { AlertPromise } from 'selenium-webdriver';
-
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to accept
- *  a {@link ModalDialog}.
- *
- * @example <caption>Example widget</caption>
- *  <button
- *      data-test="trigger"
- *      onclick="alert('hello!')">Trigger Alert</button>
- *
- * @example <caption>Lean Page Object</caption>
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class Widget {
- *      static trigger = Target.the('trigger button')
- *          .located(by.css('[data-test="trigger"]'));
- *  }
- *
- * @example <caption>Accepting a modal dialog window</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { Accept, BrowseTheWeb, Click, ModalDialog } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Nick')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Click.on(Widget.trigger),
- *          Accept.the(ModalDialog.window()),
- *      );
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- *
- * @see {@link BrowseTheWeb}
- * @see {@link Click}
- * @see {@link Dismiss}
- * @see {@link ModalDialog}
- */
-export class Accept extends Interaction {
-
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  with a {@link ModalDialog.window} the {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  will accept.
-     *
-     * @param {@serenity-js/core/lib/screenplay~Question<AlertPromise> | AlertPromise} modalDialogWindow
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay~Question}
-     */
-    static the(modalDialogWindow: Question<AlertPromise> | AlertPromise): Interaction {
-        return new Accept(modalDialogWindow);
-    }
-
-    /**
-     * @param {@serenity-js/core/lib/screenplay~Question<AlertPromise> | AlertPromise} modalDialogWindow
-     */
-    constructor(private readonly modalDialogWindow: Question<AlertPromise> | AlertPromise) {
-        super();
-    }
-
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     *  An {@link @serenity-js/core/lib/screenplay/actor~Actor} to perform this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @returns {PromiseLike<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void> {
-        return actor.answer(this.modalDialogWindow)
-            .then(alert => alert.accept());
-    }
-
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link @serenity-js/core/lib/screenplay~Activity}.
-     *
-     * @returns {string}
-     */
-    toString(): string {
-        return formatted `#actor accepts ${ this.modalDialogWindow }`;
-    }
-}

package/src/screenplay/interactions/Clear.ts

@@ -1,130 +0,0 @@
-import { AnswersQuestions, Interaction, LogicError, Question, UsesAbilities } from '@serenity-js/core';
-import { formatted } from '@serenity-js/core/lib/io';
-import { ElementFinder, protractor } from 'protractor';
-
-import { Value } from '../questions';
-import { withAnswerOf } from '../withAnswerOf';
-
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  clear the `value` of a [form `input`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input).
- *
- * @example <caption>Example widget</caption>
- *  <form>
- *    <input type="text" name="example" id="example" />
- *  </form>
- *
- * @example <caption>Lean Page Object describing the widget</caption>
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class Form {
- *      static exampleInput = Target.the('example input')
- *          .located(by.id('example'));
- *  }
- *
- * @example <caption>Clearing the value of an input field</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Clear, Enter, Value } from '@serenity-js/protractor';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Inés')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Enter.theValue('Hello world!').into(Form.exampleInput),
- *          Ensure.that(Value.of(Form.exampleInput), equals('Hello world!')),
- *
- *          Clear.theValueOf(Form.exampleInput),
- *          Ensure.that(Value.of(Form.exampleInput), equals('')),
- *      );
- *
- * @see {@link BrowseTheWeb}
- * @see {@link Enter}
- * @see {@link Value}
- * @see {@link Target}
- * @see {@link @serenity-js/assertions~Ensure}
- * @see {@link @serenity-js/assertions/lib/expectations~equals}
- *
- * @extends {@serenity-js/core/lib/screenplay~Interaction}
- */
-export class Clear extends Interaction {
-
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} field
-     *  The field to be cleared
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     */
-    static theValueOf(field: Question<ElementFinder> | ElementFinder): Interaction {
-        return new Clear(field);
-    }
-
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} field
-     *  The field to be cleared
-     */
-    constructor(private readonly field: Question<ElementFinder> | ElementFinder) {
-        super();
-    }
-
-    /**
-     * @desc
-     *  Makes the provided {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  perform this {@link @serenity-js/core/lib/screenplay~Interaction}.
-     *
-     * @param {UsesAbilities & AnswersQuestions} actor
-     *  An {@link @serenity-js/core/lib/screenplay/actor~Actor} to perform this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @returns {PromiseLike<void>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~UsesAbilities}
-     * @see {@link @serenity-js/core/lib/screenplay/actor~AnswersQuestions}
-     */
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void> {
-        return new Value(this.field).answeredBy(actor).then(value => {
-            if (value === null) {
-                throw new LogicError(
-                    `${ this.capitaliseFirstLetter(this.field.toString()) } doesn't seem to have a 'value' attribute that could be cleared.`,
-                );
-            }
-
-            if (value !== undefined) {
-                return withAnswerOf(actor, this.field, (elf: ElementFinder) => {
-                    return this.removeCharactersFrom(elf, value.length);
-                });
-            }
-        });
-    }
-
-    /**
-     * @desc
-     *  Generates a description to be used when reporting this {@link @serenity-js/core/lib/screenplay~Activity}.
-     *
-     * @returns {string}
-     */
-    toString(): string {
-        return formatted `#actor clears the value of ${ this.field }`;
-    }
-
-    private capitaliseFirstLetter(text: string) {
-        return text.charAt(0).toUpperCase() + text.slice(1);
-    }
-
-    private removeCharactersFrom(elf: ElementFinder, numberOfCharacters: number): PromiseLike<void> {
-        return numberOfCharacters === 0
-            ? Promise.resolve(void 0)
-            : elf.sendKeys(
-                protractor.Key.END,
-                ...this.times(numberOfCharacters, protractor.Key.BACK_SPACE),
-            );
-    }
-
-    private times(length: number, key: string) {
-        return Array.from({ length }).map(() => key);
-    }
-}