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

package/lib/screenplay/questions/Pick.js

@@ -1,254 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Pick = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-/**
- * @deprecated
- *  Please use [Target.all](/modules/protractor/class/src/screenplay/questions/targets/Target.ts~Target.html) instead.
- *
- * @experimental
- *
- * @see {@link @serenity-js/core/lib/screenplay/questions~List}
- */
-class Pick {
-    constructor(collection, filters = new Filters()) {
-        this.collection = collection;
-        this.filters = filters;
-    }
-    static from(collection) {
-        return new Pick(collection);
-    }
-    count() {
-        return new NumberOfMatchingItems(this.collection, this.filters);
-    }
-    all() {
-        return new AllMatchingItems(this.collection, this.filters);
-    }
-    first() {
-        return new FirstMatchingItem(this.collection, this.filters);
-    }
-    last() {
-        return new LastMatchingItem(this.collection, this.filters);
-    }
-    get(index) {
-        return new NthMatchingItem(this.collection, this.filters, index);
-    }
-    where(question, expectation) {
-        return new Pick(this.collection, this.filters.append(new Filter(question, expectation)));
-    }
-}
-exports.Pick = Pick;
-/**
- * @package
- */
-class Filters extends core_1.Question {
-    constructor(filters = []) {
-        super('');
-        this.filters = filters;
-        const fullDescription = this.filters
-            .reduce((description, filter) => description.concat(filter.toString()), [])
-            .join(' and ');
-        this.subject = fullDescription.length > 0
-            ? `where ${fullDescription}`
-            : '';
-    }
-    append(filter) {
-        return new Filters(this.filters.concat(filter));
-    }
-    /**
-     * @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 (collection) => this.filters.reduce((filteredCollection, filter) => filter.answeredBy(actor)(filteredCollection), collection);
-    }
-}
-/**
- * @package
- */
-class Filter extends core_1.Question {
-    constructor(question, expectation) {
-        super((0, io_1.formatted) `${question} does ${expectation}`);
-        this.question = question;
-        this.expectation = expectation;
-    }
-    /**
-     * @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 (collection) => collection.filter((item) => {
-            const expectation = this.expectation.answeredBy(actor);
-            return Promise.resolve(this.question.of(item).answeredBy(actor))
-                .then(answer => expectation(answer))
-                .then(outcome => outcome instanceof core_1.ExpectationMet);
-        });
-    }
-}
-/**
- * @package
- */
-class QuestionAboutCollectionItems extends core_1.Question {
-    constructor(collection, filters, description) {
-        super(`${description} ${(0, io_1.formatted) `${collection}`} ${filters.toString()}`.trim());
-        this.collection = collection;
-        this.filters = filters;
-        this.description = description;
-    }
-    collectionFilteredBy(actor) {
-        const collection = this.isAQuestion(this.collection)
-            ? this.collection.answeredBy(actor)
-            : this.collection;
-        return this.filters.answeredBy(actor)(collection);
-    }
-    isAQuestion(h) {
-        return !!h.answeredBy;
-    }
-}
-/**
- * @package
- */
-class NumberOfMatchingItems extends QuestionAboutCollectionItems {
-    constructor(collection, filters) {
-        super(collection, filters, 'the number of');
-    }
-    /**
-     * @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 Promise.resolve(this.collectionFilteredBy(actor).count());
-    }
-}
-/**
- * @package
- */
-class AllMatchingItems extends QuestionAboutCollectionItems {
-    constructor(collection, filters) {
-        super(collection, filters, '');
-    }
-    /**
-     * @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 this.collectionFilteredBy(actor);
-    }
-}
-/**
- * @package
- */
-class FirstMatchingItem extends QuestionAboutCollectionItems {
-    constructor(collection, filters) {
-        super(collection, filters, 'the first of');
-    }
-    /**
-     * @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 this.collectionFilteredBy(actor).first();
-    }
-}
-/**
- * @package
- */
-class LastMatchingItem extends QuestionAboutCollectionItems {
-    constructor(collection, filters) {
-        super(collection, filters, 'the last of');
-    }
-    /**
-     * @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 this.collectionFilteredBy(actor).last();
-    }
-}
-/**
- * @package
- */
-class NthMatchingItem extends QuestionAboutCollectionItems {
-    constructor(collection, filters, index) {
-        super(collection, filters, `the ${NthMatchingItem.ordinalSuffixOf(index + 1)} of`);
-        this.index = index;
-    }
-    static ordinalSuffixOf(index) {
-        const lastDigit = index % 10, lastTwoDigits = index % 100;
-        switch (true) {
-            case (lastDigit === 1 && lastTwoDigits !== 11):
-                return index + 'st';
-            case (lastDigit === 2 && lastTwoDigits !== 12):
-                return index + 'nd';
-            case (lastDigit === 3 && lastTwoDigits !== 13):
-                return index + 'rd';
-            default:
-                return index + 'th';
-        }
-    }
-    /**
-     * @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 this.collectionFilteredBy(actor).get(this.index);
-    }
-}
-//# sourceMappingURL=Pick.js.map

package/lib/screenplay/questions/Pick.js.map

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

package/lib/screenplay/questions/Selected.d.ts

@@ -1,185 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-/**
- * @desc
- *  Represents options and values selected in a
- *  [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
- *
- * @see {@link Select}
- */
-export declare class Selected {
-    /**
-     * @desc
-     *  Represents the value of a single option selected in a
-     *  [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
-     *
-     * @example <caption>Example widget</caption>
-     *  <select data-test='countries'>
-     *      <option value='UK'>United Kingdom</option>
-     *      <option value='PL'>Poland</option>
-     *      <option value='US'>United States</option>
-     *  </select>
-     *
-     * @example <caption>Lean Page Object</caption>
-     *  import { Target } from '@serenity-js/protractor';
-     *  import { browser, by } from 'protractor';
-     *
-     *  class Countries {
-     *      static dropdown = Target.the('countries dropdown')
-     *          .located(by.css('[data-test="countries"]'));
-     *  }
-     *
-     * @example <caption>Retrieving the selected value</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Accept, BrowseTheWeb, Select, Selected } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Select.value('UK').from(Countries.dropdown),
-     *          Ensure.that(Selected.valueOf(Countries.dropdown), equals('UK')),
-     *      );
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  A {@link Target} identifying the `<select>` element of interest
-     *
-     * @returns {Question<Promise<string>>}
-     *
-     * @see {@link Select.value}
-     */
-    static valueOf(target: Question<ElementFinder> | ElementFinder): Question<Promise<string>>;
-    /**
-     * @desc
-     *  Represents values of options selected in a
-     *  [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
-     *
-     * @example <caption>Example widget</caption>
-     *  <select multiple data-test='countries'>
-     *      <option value='UK'>United Kingdom</option>
-     *      <option value='PL'>Poland</option>
-     *      <option value='US'>United States</option>
-     *  </select>
-     *
-     * @example <caption>Lean Page Object</caption>
-     *  import { Target } from '@serenity-js/protractor';
-     *  import { browser, by } from 'protractor';
-     *
-     *  class Countries {
-     *      static dropdown = Target.the('countries dropdown')
-     *          .located(by.css('[data-test="countries"]'));
-     *  }
-     *
-     * @example <caption>Retrieving the selected value</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Accept, BrowseTheWeb, Select, Selected } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Select.values('UK').from(Countries.dropdown),
-     *          Ensure.that(Selected.valuesOf(Countries.dropdown), equals([ 'UK' ])),
-     *      );
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  A {@link Target} identifying the `<select>` element of interest
-     *
-     * @returns {Question<Promise<string[]>>}
-     *
-     * @see {@link Select.values}
-     */
-    static valuesOf(target: Question<ElementFinder> | ElementFinder): Question<Promise<string[]>>;
-    /**
-     * @desc
-     *  Represents a single option selected in a
-     *  [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
-     *
-     * @example <caption>Example widget</caption>
-     *  <select data-test='countries'>
-     *      <option value='UK'>United Kingdom</option>
-     *      <option value='PL'>Poland</option>
-     *      <option value='US'>United States</option>
-     *  </select>
-     *
-     * @example <caption>Lean Page Object</caption>
-     *  import { Target } from '@serenity-js/protractor';
-     *  import { browser, by } from 'protractor';
-     *
-     *  class Countries {
-     *      static dropdown = Target.the('countries dropdown')
-     *          .located(by.css('[data-test="countries"]'));
-     *  }
-     *
-     * @example <caption>Retrieving the selected value</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Accept, BrowseTheWeb, Select, Selected } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Select.option('Poland').from(Countries.dropdown),
-     *          Ensure.that(
-     *              Selected.optionIn(Countries.dropdown),
-     *              equals('Poland')
-     *          ),
-     *      );
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  A {@link Target} identifying the `<select>` element of interest
-     *
-     * @returns {Question<Promise<string>>}
-     *
-     * @see {@link Select.option}
-     */
-    static optionIn(target: Question<ElementFinder> | ElementFinder): Question<Promise<string>>;
-    /**
-     * @desc
-     *  Represents options selected in a
-     *  [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
-     *
-     * @example <caption>Example widget</caption>
-     *  <select multiple data-test='countries'>
-     *      <option value='UK'>United Kingdom</option>
-     *      <option value='PL'>Poland</option>
-     *      <option value='US'>United States</option>
-     *  </select>
-     *
-     * @example <caption>Lean Page Object</caption>
-     *  import { Target } from '@serenity-js/protractor';
-     *  import { browser, by } from 'protractor';
-     *
-     *  class Countries {
-     *      static dropdown = Target.the('countries dropdown')
-     *          .located(by.css('[data-test="countries"]'));
-     *  }
-     *
-     * @example <caption>Retrieving the selected value</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { Accept, BrowseTheWeb, Select, Selected } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Select.options('Poland', 'United States').from(Countries.dropdown),
-     *          Ensure.that(
-     *              Selected.optionsIn(Countries.dropdown),
-     *              equals([ 'Poland', 'United States' ])
-     *          ),
-     *      );
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *  A {@link Target} identifying the `<select>` element of interest
-     *
-     * @returns {Question<Promise<string[]>>}
-     *
-     * @see {@link Select.options}
-     */
-    static optionsIn(target: Question<ElementFinder> | ElementFinder): Question<Promise<string[]>>;
-}