@serenity-js/protractor 2.32.7 → 3.0.0-rc.10

package/lib/screenplay/interactions/Select.js

@@ -1,342 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Select = void 0;
-const io_1 = require("@serenity-js/core/lib/io");
-const inspected_1 = require("@serenity-js/core/lib/io/inspected");
-const protractor_1 = require("protractor");
-const promiseOf_1 = require("../../promiseOf");
-const questions_1 = require("../questions");
-const withAnswerOf_1 = require("../withAnswerOf");
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor} to
- *  select an option from a [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select),
- *  either by its display name, or by value.
- *
- * @see {@link Selected}
- */
-class Select {
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  with a [`value`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option#attr-value)
-     *  of a single [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to 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 describing the widget</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 { 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 {string | Answerable<string>} value
-     *  A value of the [`option` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select
-     *
-     * @returns {SelectBuilder}
-     *
-     * @see {@link Selected.valueOf}
-     * @see {@link BrowseTheWeb}
-     * @see {@link Target}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~equals}
-     */
-    static value(value) {
-        return {
-            from: (target) => new SelectValue(value, target)
-        };
-    }
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  with [`value`s](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option#attr-value)
-     *  of multiple [`<option>` elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select.
-     *
-     * @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 describing the widget</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 { 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 {Array<Answerable<string[] | string>>} values
-     *  Values of the [`option` elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select
-     *
-     * @returns {SelectBuilder}
-     *
-     * @see {@link Selected.valuesOf}
-     * @see {@link BrowseTheWeb}
-     * @see {@link Target}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~equals}
-     */
-    static values(...values) {
-        return {
-            from: (target) => new SelectValues(values, target)
-        };
-    }
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  with a single [`option`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to 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 describing the widget</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 { 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 {string | Answerable<string>} value
-     *  Text of the [`option` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select
-     *
-     * @returns {SelectBuilder}
-     *
-     * @see {@link Selected.optionIn}
-     * @see {@link BrowseTheWeb}
-     * @see {@link Target}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~equals}
-     */
-    static option(value) {
-        return {
-            from: (target) => new SelectOption(value, target)
-        };
-    }
-    /**
-     * @desc
-     *  Instantiates this {@link @serenity-js/core/lib/screenplay~Interaction}
-     *  with [`option`s](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select.
-     *
-     * @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 describing the widget</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 { 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 {Array<Answerable<string[] | string>>} values
-     *  Text of the [`option` elements  ](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor} to select
-     *
-     * @returns {SelectBuilder}
-     *
-     * @see {@link Selected.optionsIn}
-     * @see {@link BrowseTheWeb}
-     * @see {@link Target}
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link @serenity-js/assertions/lib/expectations~equals}
-     */
-    static options(...values) {
-        return {
-            from: (target) => new SelectOptions(values, target)
-        };
-    }
-}
-exports.Select = Select;
-/**
- * @package
- */
-class SelectValue {
-    constructor(value, target) {
-        this.value = value;
-        this.target = target;
-    }
-    performAs(actor) {
-        return actor.answer(this.value)
-            .then(value => (0, withAnswerOf_1.withAnswerOf)(actor, this.target, (element) => element
-            .element(protractor_1.by.css(`option[value=${value}]`)))
-            .click());
-    }
-    toString() {
-        return (0, io_1.formatted) `#actor selects value ${this.value} from ${this.target}`;
-    }
-}
-/**
- * @package
- */
-class SelectValues {
-    constructor(values, target) {
-        this.values = values;
-        this.target = target;
-    }
-    performAs(actor) {
-        return Promise.all(this.values.map(value => actor.answer(value)))
-            .then(flatten)
-            .then(values => {
-            const hasRequiredValue = (option) => questions_1.Value.of(option).answeredBy(actor).then(value => !!~values.indexOf(value));
-            return (0, promiseOf_1.promiseOf)((0, withAnswerOf_1.withAnswerOf)(actor, this.target, (element) => element.all(protractor_1.by.css('option'))
-                .filter(optionsToSelect(hasRequiredValue))
-                .each(select)));
-        });
-    }
-    toString() {
-        return `#actor selects values ${(0, io_1.commaSeparated)(flatten(this.values), inspected_1.inspected)} from ${this.target}`;
-    }
-}
-/**
- * @package
- */
-class SelectOption {
-    constructor(value, target) {
-        this.value = value;
-        this.target = target;
-    }
-    performAs(actor) {
-        return actor.answer(this.value)
-            .then(value => {
-            return (0, promiseOf_1.promiseOf)((0, withAnswerOf_1.withAnswerOf)(actor, this.target, (element) => element
-                .element(protractor_1.by.cssContainingText('option', value)))
-                .click());
-        });
-    }
-    toString() {
-        return (0, io_1.formatted) `#actor selects ${this.value} from ${this.target}`;
-    }
-}
-/**
- * @package
- */
-class SelectOptions {
-    constructor(values, target) {
-        this.values = values;
-        this.target = target;
-    }
-    performAs(actor) {
-        return Promise.all(this.values.map(value => actor.answer(value)))
-            .then(flatten)
-            .then(values => {
-            const hasRequiredText = (option) => option.getText().then(value => !!~values.indexOf(value));
-            return (0, promiseOf_1.promiseOf)((0, withAnswerOf_1.withAnswerOf)(actor, this.target, (element) => element.all(protractor_1.by.css('option'))
-                .filter(optionsToSelect(hasRequiredText))
-                .each(select)));
-        });
-    }
-    toString() {
-        return `#actor selects ${(0, io_1.commaSeparated)(flatten(this.values), inspected_1.inspected)} from ${this.target}`;
-    }
-}
-/** @package */
-function flatten(listOfLists) {
-    return listOfLists
-        .map(item => [].concat(item))
-        .reduce((acc, list) => acc.concat(list), []);
-}
-/** @package */
-function optionsToSelect(criterion) {
-    return (option) => isAlreadySelected(option)
-        .then(alreadySelected => criterion(option).then(criterionMet => xor(alreadySelected, criterionMet)));
-}
-/** @package */
-function select(option) {
-    return option.click();
-}
-/** @package */
-function isAlreadySelected(option) {
-    return option.isSelected();
-}
-/** @package */
-function xor(first, second) {
-    return first !== second;
-}
-//# sourceMappingURL=Select.js.map

package/lib/screenplay/interactions/Select.js.map

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

package/lib/screenplay/interactions/SelectBuilder.d.ts

@@ -1,33 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { Interaction } from '@serenity-js/core/lib/screenplay';
-import { ElementFinder } from 'protractor';
-/**
- * @desc
- *  Configures the {@link Target} representing
- *  a [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select)
- *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor}
- *  to interact with.
- *
- * @interface
- */
-export interface SelectBuilder {
-    /**
-     * @desc
-     *  Configures the {@link Target} representing
-     *  a [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select)
-     *  for the {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  to interact with
-     *
-     * @param {Question<ElementFinder> | ElementFinder} target
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Select}
-     * @see {@link Select.option}
-     * @see {@link Select.options}
-     * @see {@link Select.value}
-     * @see {@link Select.values}
-     * @see {@link Target}
-     */
-    from: (target: Question<ElementFinder> | ElementFinder) => Interaction;
-}

package/lib/screenplay/interactions/SelectBuilder.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=SelectBuilder.js.map

package/lib/screenplay/interactions/SelectBuilder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SelectBuilder.js","sourceRoot":"","sources":["../../../src/screenplay/interactions/SelectBuilder.ts"],"names":[],"mappings":""}

package/lib/screenplay/interactions/Switch.d.ts

@@ -1,210 +0,0 @@
-import { Activity, Answerable, AnswersQuestions, Interaction, Task, UsesAbilities } from '@serenity-js/core';
-import { ElementFinder } from 'protractor';
-/**
- * @desc
- *  Instructs the {@link @serenity-js/core/lib/screenplay/actor~Actor}
- *  to switch to a different [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame),
- *  [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
- *  or browser window/tab.
- *
- * @example <caption>Lean Page Object describing a login form, embedded in an iframe</caption>
- *
- *  import { Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class LoginForm {
- *      static iframe           = Target.the('login form').located(by.tagName('iframe'));
- *      static usernameField    = Target.the('username field').located(by.css('[data-test="username"]'));
- *      static passwordField    = Target.the('password field').located(by.css('[data-test="password"]'));
- *      static submitButton     = Target.the('submit button').located(by.css(`button[type='submit']`));
- *  }
- *
- * @example <caption>Switch to an iframe and back</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe),
- *
- *          Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *          Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *          Click.on(LoginForm.submitButton),
- *
- *          Switch.toParentFrame(),
- *      );
- *
- * @example <caption>Perform activities in the context of an iframe</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Enter, Click } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toFrame(LoginForm.iframe).and(
- *              Enter.theValue('francesca@example.org').into(LoginForm.usernameField),
- *              Enter.theValue('correct-horse-battery-staple').into(LoginForm.passwordField),
- *              Click.on(LoginForm.submitButton),
- *          ),
- *          // Note that Switch.toParentFrame() is invoked automatically
- *      );
- *
- * @example <caption>Switch to a new window/tab and back</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow(), // or: Switch.toWindow(...)
- *
- *          // perform some activities in the context of the new window
- *
- *          Close.currentWindow(),
- *
- *          Switch.toOriginalWindow(),
- *      );
- *
- * @example <caption>Perform activities in the context of a different window/tab</caption>
- *
- *  import { actorCalled } from '@serenity-js/core';
- *  import { BrowseTheWeb, Switch, Close } from '@serenity-js/protractor';
- *  import { protractor } from 'protractor';
- *
- *  actorCalled('Francesca')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Switch.toNewWindow().and(
- *              // perform some activities in the context of the new window
- *
- *              Close.currentWindow()
- *          ),
- *
- *          // Note that Switch.toOriginalWindow() is invoked automatically
- *      );
- *
- * @see {@link Close}
- * @see {@link BrowseTheWeb}
- */
-export declare class Switch {
-    /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to a [frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/frame)
-     *  or an [inline frame](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)
-     *  identified by its name, index or `Question<ElementFinder>`.
-     *
-     * @param {Answerable<ElementFinder | number | string>} targetOrIndex
-     *
-     * @returns {SwitchToFrame}
-     *
-     * @see {@link Switch.toParentFrame}
-     * @see {@link Switch.toDefaultContent}
-     * @see {@link Target}
-     */
-    static toFrame(targetOrIndex: Answerable<ElementFinder | number | string>): SwitchToFrame;
-    /**
-     * @desc
-     *  Sets the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the parent of the current browsing context,
-     *  i.e. an `iframe` in which the current `iframe` is nested.
-     *
-     *  If the current context is the top-level browsing context, the context remains unchanged.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Switch.toFrame}
-     * @see https://w3c.github.io/webdriver/#switch-to-parent-frame
-     * @see https://w3c.github.io/webdriver/#dfn-current-browsing-context
-     */
-    static toParentFrame(): Interaction;
-    /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the first frame on the page, or the main document
-     *  when a page contains [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)s.
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Interaction}
-     *
-     * @see {@link Switch.toFrame}
-     */
-    static toDefaultContent(): Interaction;
-    /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to a browser tab/window identified by its
-     *  name, index or [window handle](https://developer.mozilla.org/en-US/docs/Web/WebDriver/Commands/GetWindowHandles).
-     *
-     * @param {Answerable<string | number>} nameOrHandleOrIndex
-     * @returns {SwitchToWindow}
-     */
-    static toWindow(nameOrHandleOrIndex: Answerable<string | number>): SwitchToWindow;
-    /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the most recently opened browser tab/window.
-     *
-     *  **Please note** that this behaviour might vary in some browsers if there are more than two windows opened
-     *  at the same time.
-     *
-     * @returns {SwitchToNewWindow}
-     */
-    static toNewWindow(): SwitchToNewWindow;
-    /**
-     * @desc
-     *  Switches the current [browsing context](https://w3c.github.io/webdriver/#dfn-current-browsing-context)
-     *  for future commands to the original window used when the {@link @serenity-js/core/lib/screenplay/actor~Actor}
-     *  performed an interaction to {@link Navigate}.
-     *
-     *  **Please note** that this behaviour might vary in some browsers if there are more than two windows opened
-     *  at the same time, as window handles might be ordered alphabetically instead of the order in which they were created.
-     *
-     * @returns {SwitchToOriginalWindow}
-     */
-    static toOriginalWindow(): SwitchToOriginalWindow;
-}
-/**
- * @package
- */
-declare class SwitchToFrame extends Interaction {
-    private readonly targetOrIndex;
-    constructor(targetOrIndex: Answerable<ElementFinder | number | string>);
-    and(...activities: Activity[]): Task;
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    toString(): string;
-}
-/**
- * @package
- */
-declare class SwitchToWindow extends Interaction {
-    private readonly nameOrHandleOrIndex;
-    constructor(nameOrHandleOrIndex: Answerable<string | number>);
-    and(...activities: Activity[]): Task;
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    toString(): string;
-}
-/**
- * @package
- */
-declare class SwitchToNewWindow extends Interaction {
-    constructor();
-    and(...activities: Activity[]): Task;
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    toString(): string;
-}
-/**
- * @package
- */
-declare class SwitchToOriginalWindow extends Interaction {
-    constructor();
-    performAs(actor: UsesAbilities & AnswersQuestions): PromiseLike<void>;
-    toString(): string;
-}
-export {};