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

package/lib/screenplay/questions/lists/ElementArrayFinderListAdapter.js

@@ -1,138 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ElementArrayFinderListAdapter = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-/**
- * @desc
- *  Adapts {@link ElementArrayFinder} so that it can be used with {@link @serenity-js/core/lib/screenplay/questions~List}.
- *
- *  You most likely won't need to use this class directly. Instead, check out {@link Target} and {@link Target.all}.
- *
- * @see {@link Target}
- *
- * @implements {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter}
- */
-class ElementArrayFinderListAdapter {
-    /**
-     * @param {Question<ElementArrayFinder> | ElementArrayFinder} collection
-     */
-    constructor(collection) {
-        this.collection = collection;
-    }
-    /**
-     * @desc
-     *  Returns the number of {@link ElementFinder}s that the underlying {@link ElementArrayFinder} contains,
-     *  left after applying any filters.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {Promise<number>}
-     */
-    count(actor) {
-        return Promise.resolve(this.elements(actor).count());
-    }
-    /**
-     * @desc
-     *  Returns the first of {@link ElementFinder}s that the underlying {@link ElementArrayFinder} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {ElementFinder}
-     */
-    first(actor) {
-        return this.elements(actor).first();
-    }
-    /**
-     * @desc
-     *  Returns the last of {@link ElementFinder}s that the underlying {@link ElementArrayFinder} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {ElementFinder}
-     */
-    last(actor) {
-        return this.elements(actor).last();
-    }
-    /**
-     * @desc
-     *  Returns the nth of {@link ElementFinder}s that the underlying {@link ElementArrayFinder} contains,
-     *  left after applying any filters
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     *
-     * @param {number} index
-     *  Zero-based index of the item to return
-     *
-     * @returns {ElementFinder}
-     */
-    get(actor, index) {
-        return this.elements(actor).get(index);
-    }
-    /**
-     * @desc
-     *  Returns the underlying {@link ElementArrayFinder},
-     *  with any filters applied.
-     *
-     * @param {AnswersQuestions & UsesAbilities} actor
-     * @returns {ElementFinder}
-     */
-    items(actor) {
-        return this.elements(actor);
-    }
-    /**
-     * @desc
-     *  Filters the underlying {@link ElementArrayFinder} so that the result contains only those {@link ElementFinder}s that meet the {@link Expectation}
-     *
-     * @param {@serenity-js/core/lib/screenplay/questions~MetaQuestion<ElementFinder, Promise<Answer_Type> | Answer_Type>} question
-     * @param {@serenity-js/core/lib/screenplay/questions~Expectation<any, Answer_Type>} expectation
-     *
-     * @returns {@serenity-js/core/lib/screenplay/questions/lists~ListAdapter<ElementFinder, ElementArrayFinder>}
-     *
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    withFilter(question, expectation) {
-        return new ElementArrayFinderListAdapter(new ElementArrayFinderArrayListFilter(this.collection, question, expectation));
-    }
-    /**
-     * @desc
-     *  Returns a human-readable description of the underlying {@link ElementArrayFinder}.
-     *
-     * @returns {string}
-     */
-    toString() {
-        return (0, io_1.formatted) `${this.collection}`;
-    }
-    elements(actor) {
-        return core_1.Question.isAQuestion(this.collection)
-            ? this.collection.answeredBy(actor)
-            : this.collection;
-    }
-}
-exports.ElementArrayFinderListAdapter = ElementArrayFinderListAdapter;
-/**
- * @private
- */
-class ElementArrayFinderArrayListFilter extends core_1.Question {
-    constructor(collection, question, expectation) {
-        super([
-            (0, io_1.formatted) `${collection}`,
-            collection instanceof ElementArrayFinderArrayListFilter ? 'and' : 'where',
-            (0, io_1.formatted) `${question} does ${expectation}`
-        ].join(' '));
-        this.collection = collection;
-        this.question = question;
-        this.expectation = expectation;
-    }
-    answeredBy(actor) {
-        return this.finderAs(actor)
-            .filter((elementFinder) => Promise.resolve(this.question.of(elementFinder).answeredBy(actor))
-            .then(answer => this.expectation.answeredBy(actor)(answer))
-            .then(outcome => outcome instanceof core_1.ExpectationMet));
-    }
-    finderAs(actor) {
-        return core_1.Question.isAQuestion(this.collection)
-            ? this.collection.answeredBy(actor)
-            : this.collection;
-    }
-}
-//# sourceMappingURL=ElementArrayFinderListAdapter.js.map

package/lib/screenplay/questions/lists/ElementArrayFinderListAdapter.js.map

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

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

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

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

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

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

package/lib/screenplay/questions/targets/Target.d.ts

@@ -1,168 +0,0 @@
-import { NestedTargetBuilder, TargetBuilder } from './builders';
-import { TargetElement } from './TargetElement';
-import { TargetElements } from './TargetElements';
-import { TargetNestedElement } from './TargetNestedElement';
-import { TargetNestedElements } from './TargetNestedElements';
-/**
- * @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 { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const proceedToCheckoutButton =
- *       Target.the('Proceed to Checkout button').located(by.css(`button[type='submit']`));
- *
- *  @example <caption>Locating multiple elements</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const basketItems =
- *       Target.all('items in the basket').located(by.css('ul#basket li'));
- *
- *  @example <caption>Locating element relative to another element</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const summary =
- *       Target.the('summary').located(by.id('message'));
- *
- *   const outOfStockItem =
- *       Target.the('out of stock item').of(summary).located(by.css('.out-of-stock'))
- *
- *  @example <caption>Filtering elements matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by } from 'protractor';
- *
- *   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 { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { Question } from '@serenity-js/core';
- *   import { by } from 'protractor';
- *
- *   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 { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const apple: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .first()
- *
- *  @example <caption>Getting last item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const date: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .last()
- *
- *  @example <caption>Getting nth item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const banana: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .get(1)
- *
- *  @example <caption>Using multiple filters and nested targets</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { contain, endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   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<ElementFinder>  =
- *       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/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.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, Click, Text } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   const basketItemNames = Text.ofAll(basketItems);
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Ensure.that(basketItemNames, contain('Apple'))
- *       );
- *
- *  @example <caption>Waiting on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click, Text, Wait, isClickable } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Wait.until(proceedToCheckoutButton, isClickable()),
- *       );
- */
-export declare class Target {
-    /**
-     * @desc
-     *  Locates a single web element
-     *
-     * @param {string} name - A human-readable name of the element to be used in the report
-     * @returns {TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement>}
-     */
-    static the(name: string): TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement>;
-    /**
-     * @desc
-     *  Locates a group of web elements
-     *
-     * @param {string} name - A human-readable name of the elements to be used in the report
-     * @returns {TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements>}
-     */
-    static all(name: string): TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements>;
-}

package/lib/screenplay/questions/targets/Target.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Target = void 0;
-const TargetElement_1 = require("./TargetElement");
-const TargetElements_1 = require("./TargetElements");
-const TargetNestedElement_1 = require("./TargetNestedElement");
-const TargetNestedElements_1 = require("./TargetNestedElements");
-/**
- * @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 { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const proceedToCheckoutButton =
- *       Target.the('Proceed to Checkout button').located(by.css(`button[type='submit']`));
- *
- *  @example <caption>Locating multiple elements</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const basketItems =
- *       Target.all('items in the basket').located(by.css('ul#basket li'));
- *
- *  @example <caption>Locating element relative to another element</caption>
- *   import { Target } from '@serenity-js/protractor';
- *   import { by } from 'protractor';
- *
- *   const summary =
- *       Target.the('summary').located(by.id('message'));
- *
- *   const outOfStockItem =
- *       Target.the('out of stock item').of(summary).located(by.css('.out-of-stock'))
- *
- *  @example <caption>Filtering elements matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by } from 'protractor';
- *
- *   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 { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { Question } from '@serenity-js/core';
- *   import { by } from 'protractor';
- *
- *   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 { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const apple: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .first()
- *
- *  @example <caption>Getting last item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const date: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .last()
- *
- *  @example <caption>Getting nth item matched by a locator</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   const banana: Question<ElementFinder>  =
- *       Target.all('items in the basket').located(by.css('ul#basket li'))
- *          .get(1)
- *
- *  @example <caption>Using multiple filters and nested targets</caption>
- *   import { Target, Text } from '@serenity-js/protractor';
- *   import { contain, endsWith } from '@serenity-js/assertions';
- *   import { by, ElementFinder } from 'protractor';
- *
- *   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<ElementFinder>  =
- *       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/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.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, Click, Text } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   const basketItemNames = Text.ofAll(basketItems);
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Ensure.that(basketItemNames, contain('Apple'))
- *       );
- *
- *  @example <caption>Waiting on an element</caption>
- *   import { actorCalled } from '@serenity-js/core';
- *   import { BrowseTheWeb, Click, Text, Wait, isClickable } from '@serenity-js/protractor';
- *   import { protractor } from 'protractor';
- *
- *   actorCalled('Jane')
- *       .whoCan(BrowseTheWeb.using(protractor.browser))
- *       .attemptsTo(
- *           Wait.until(proceedToCheckoutButton, isClickable()),
- *       );
- */
-class Target {
-    /**
-     * @desc
-     *  Locates a single web element
-     *
-     * @param {string} name - A human-readable name of the element to be used in the report
-     * @returns {TargetBuilder<TargetElement> & NestedTargetBuilder<TargetNestedElement>}
-     */
-    static the(name) {
-        return {
-            located: (byLocator) => new TargetElement_1.TargetElement(name, byLocator),
-            of: (parent) => {
-                return {
-                    located: (byLocator) => new TargetNestedElement_1.TargetNestedElement(parent, new TargetElement_1.TargetElement(name, byLocator)),
-                };
-            },
-        };
-    }
-    /**
-     * @desc
-     *  Locates a group of web elements
-     *
-     * @param {string} name - A human-readable name of the elements to be used in the report
-     * @returns {TargetBuilder<TargetElements> & NestedTargetBuilder<TargetNestedElements>}
-     */
-    static all(name) {
-        return {
-            located: (byLocator) => new TargetElements_1.TargetElements(name, byLocator),
-            of: (parent) => {
-                return {
-                    located: (byLocator) => new TargetNestedElements_1.TargetNestedElements(parent, new TargetElements_1.TargetElements(name, byLocator)),
-                };
-            },
-        };
-    }
-}
-exports.Target = Target;
-//# sourceMappingURL=Target.js.map

package/lib/screenplay/questions/targets/Target.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Target.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/targets/Target.ts"],"names":[],"mappings":";;;AAIA,mDAAgD;AAChD,qDAAkD;AAClD,+DAA4D;AAC5D,iEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgJG;AACH,MAAa,MAAM;IAEf;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACnB,OAAO;YACH,OAAO,EAAE,CAAC,SAAkB,EAAiB,EAAE,CAC3C,IAAI,6BAAa,CAAC,IAAI,EAAE,SAAS,CAAC;YAEtC,EAAE,EAAE,CAAC,MAA+C,EAAE,EAAE;gBACpD,OAAO;oBACH,OAAO,EAAE,CAAC,SAAkB,EAAuB,EAAE,CACjD,IAAI,yCAAmB,CAAC,MAAM,EAAE,IAAI,6BAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;iBAC1E,CAAC;YACN,CAAC;SACJ,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,IAAY;QACnB,OAAO;YACH,OAAO,EAAE,CAAC,SAAkB,EAAkB,EAAE,CAC5C,IAAI,+BAAc,CAAC,IAAI,EAAE,SAAS,CAAC;YAEvC,EAAE,EAAE,CAAC,MAA+C,EAAE,EAAE;gBACpD,OAAO;oBACH,OAAO,EAAE,CAAC,SAAkB,EAAwB,EAAE,CAClD,IAAI,2CAAoB,CAAC,MAAM,EAAE,IAAI,+BAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;iBAC5E,CAAC;YACN,CAAC;SACJ,CAAC;IACN,CAAC;CACJ;AA3CD,wBA2CC"}

package/lib/screenplay/questions/targets/TargetElement.d.ts

@@ -1,50 +0,0 @@
-import { AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder, Locator } from 'protractor';
-import { TargetNestedElement } from './TargetNestedElement';
-/**
- * @desc
- *  Locates a single {@link WebElement}.
- *
- *  Instead of using this class directly, please use {@link Target.the} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-export declare class TargetElement extends Question<ElementFinder> implements MetaQuestion<Question<ElementFinder> | ElementFinder, ElementFinder> {
-    protected readonly description: string;
-    protected readonly locator: Locator;
-    /**
-     * @desc
-     *
-     * @param {string} description - A human-readable description to be used in the report
-     * @param {protractor~Locator} locator - A locator to be used when locating the element
-     */
-    constructor(description: string, locator: Locator);
-    /**
-     * @desc
-     *  Retrieves a {@link WebElement} located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElement}
-     *
-     * @see {@link Target}
-     */
-    of(parent: Question<ElementFinder> | ElementFinder): TargetNestedElement;
-    /**
-     * @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): ElementFinder;
-}

package/lib/screenplay/questions/targets/TargetElement.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TargetElement = void 0;
-const core_1 = require("@serenity-js/core");
-const abilities_1 = require("../../abilities");
-const override_1 = require("./override");
-const TargetNestedElement_1 = require("./TargetNestedElement");
-/**
- * @desc
- *  Locates a single {@link WebElement}.
- *
- *  Instead of using this class directly, please use {@link Target.the} instead.
- *
- * @public
- * @see {@link Target}
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-class TargetElement extends core_1.Question {
-    /**
-     * @desc
-     *
-     * @param {string} description - A human-readable description to be used in the report
-     * @param {protractor~Locator} locator - A locator to be used when locating the element
-     */
-    constructor(description, locator) {
-        super(`the ${description}`);
-        this.description = description;
-        this.locator = locator;
-    }
-    /**
-     * @desc
-     *  Retrieves a {@link WebElement} located by `locator`,
-     *  resolved in the context of a `parent` {@link WebElement}.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {TargetNestedElement}
-     *
-     * @see {@link Target}
-     */
-    of(parent) {
-        return new TargetNestedElement_1.TargetNestedElement(parent, this);
-    }
-    /**
-     * @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, override_1.override)(abilities_1.BrowseTheWeb.as(actor).locate(this.locator), 'toString', TargetElement.prototype.toString.bind(this));
-    }
-}
-exports.TargetElement = TargetElement;
-//# sourceMappingURL=TargetElement.js.map

package/lib/screenplay/questions/targets/TargetElement.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TargetElement.js","sourceRoot":"","sources":["../../../../src/screenplay/questions/targets/TargetElement.ts"],"names":[],"mappings":";;;AAAA,4CAA4F;AAG5F,+CAA+C;AAC/C,yCAAsC;AACtC,+DAA4D;AAE5D;;;;;;;;;;;GAWG;AACH,MAAa,aACT,SAAQ,eAAuB;IAG/B;;;;;OAKG;IACH,YACuB,WAAmB,EACnB,OAAgB;QAEnC,KAAK,CAAC,OAAQ,WAAY,EAAE,CAAC,CAAC;QAHX,gBAAW,GAAX,WAAW,CAAQ;QACnB,YAAO,GAAP,OAAO,CAAS;IAGvC,CAAC;IAED;;;;;;;;;OASG;IACH,EAAE,CAAC,MAA+C;QAC9C,OAAO,IAAI,yCAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,IAAA,mBAAQ,EACX,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAC3C,UAAU,EACV,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9C,CAAC;IACN,CAAC;CACJ;AAlDD,sCAkDC"}