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

package/lib/screenplay/questions/CSSClasses.js

@@ -1,118 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CSSClasses = void 0;
-const core_1 = require("@serenity-js/core");
-const io_1 = require("@serenity-js/core/lib/io");
-const Attribute_1 = require("./Attribute");
-const targets_1 = require("./targets");
-/**
- * @desc
- *  Resolves to an array of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
- *  of a given {@link WebElement}, represented by {@link ElementFinder} or `Question<ElementFinder>`.
- *
- * @example <caption>Example widget</caption>
- *  <ul id="shopping-list" class="active favourite">
- *    <li class="bought">Coffee<li>
- *    <li class="buy">Honey<li>
- *    <li class="buy">Chocolate<li>
- *  </ul>
- *
- * @example <caption>Retrieve CSS classes of a given WebElement</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, CSSClasses, Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  const shoppingList = () =>
- *      Target.the('shopping list').located(by.id('shopping-list'))
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(CSSClasses.of(shoppingList()), equals([ 'active', 'favourite' ])),
- *      )
- *
- * @example <caption>Find WebElements with a given class</caption>
- *  import { actorCalled } from '@serenity-js/core';
- *  import { Ensure, equals } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, CSSClasses, Target } from '@serenity-js/protractor';
- *  import { by } from 'protractor';
- *
- *  class ShoppingList {
- *      static items = () =>
- *          Target.all('items')
- *              .located(by.css('#shopping-list li'))
- *
- *      static outstandingItems = () =>
- *          ShoppingList.items
- *              .where(CSSClasses, contain('buy'))
- *  }
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(protractor.browser))
- *      .attemptsTo(
- *          Ensure.that(
- *              Text.ofAll(ShoppingList.outstandingItems()),
- *              equals([ 'Honey', 'Chocolate' ])
- *          ),
- *      )
- *
- * @extends {@serenity-js/core/lib/screenplay~Question}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
- */
-class CSSClasses extends core_1.Question {
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     */
-    constructor(target) {
-        super((0, io_1.formatted) `CSS classes of ${target}`);
-        this.target = target;
-    }
-    /**
-     * @param {Question<ElementFinder> | ElementFinder} target
-     * @returns {CSSClasses}
-     */
-    static of(target) {
-        return new CSSClasses(target);
-    }
-    /**
-     * @desc
-     *  Resolves to an array of CSS classes of the `target` element,
-     *  located in the context of a `parent` element.
-     *
-     * @param {Question<ElementFinder> | ElementFinder} parent
-     * @returns {Question<Promise<string[]>>}
-     *
-     * @see {@link Target.all}
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
-     */
-    of(parent) {
-        return new CSSClasses(new targets_1.TargetNestedElement(parent, this.target));
-    }
-    /**
-     * @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 Attribute_1.Attribute.of(this.target).called('class').answeredBy(actor)
-            .then(value => {
-            return typeof value !== 'string'
-                ? []
-                : value
-                    .replace(/\s+/, ' ')
-                    .trim()
-                    .split(' ')
-                    .filter(cssClass => !!cssClass);
-        });
-    }
-}
-exports.CSSClasses = CSSClasses;
-//# sourceMappingURL=CSSClasses.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"CSSClasses.js","sourceRoot":"","sources":["../../../src/screenplay/questions/CSSClasses.ts"],"names":[],"mappings":";;;AAAA,4CAA4F;AAC5F,iDAAqD;AAGrD,2CAAwC;AACxC,uCAAgD;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAa,UACT,SAAQ,eAA2B;IAWnC;;OAEG;IACH,YAA6B,MAA+C;QACxE,KAAK,CAAC,IAAA,cAAS,EAAC,kBAAmB,MAAM,EAAE,CAAC,CAAC;QADpB,WAAM,GAAN,MAAM,CAAyC;IAE5E,CAAC;IAbD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAA+C;QACrD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IASD;;;;;;;;;;OAUG;IACH,EAAE,CAAC,MAA+C;QAC9C,OAAO,IAAI,UAAU,CAAC,IAAI,6BAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,qBAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;aAC7D,IAAI,CAAC,KAAK,CAAC,EAAE;YACV,OAAO,OAAO,KAAK,KAAK,QAAQ;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,KAAK;qBACF,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;qBACnB,IAAI,EAAE;qBACN,KAAK,CAAC,GAAG,CAAC;qBACV,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACX,CAAC;CACJ;AA1DD,gCA0DC"}

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

@@ -1,9 +0,0 @@
-import { Answerable, Question } from '@serenity-js/core';
-export declare class Cookie {
-    static valueOf(cookieName: Answerable<string>): Question<Promise<string>>;
-    static pathOf(cookieName: Answerable<string>): Question<Promise<string>>;
-    static domainOf(cookieName: string): Question<Promise<string>>;
-    static isHTTPOnly(cookieName: string): Question<Promise<boolean>>;
-    static isSecure(cookieName: string): Question<Promise<boolean>>;
-    static expiryDateOf(cookieName: string): Question<Promise<Date>>;
-}

package/lib/screenplay/questions/Cookie.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Cookie = void 0;
-/* eslint-disable unicorn/consistent-function-scoping */
-const core_1 = require("@serenity-js/core");
-const abilities_1 = require("../abilities");
-class Cookie {
-    static valueOf(cookieName) {
-        return core_1.Transform.the(new CookieDetails(cookieName), details => details && details.value)
-            .as(`the value of the "${cookieName}" cookie`);
-    }
-    static pathOf(cookieName) {
-        return core_1.Transform.the(new CookieDetails(cookieName), details => details && details.path)
-            .as(`the path of the "${cookieName}" cookie`);
-    }
-    static domainOf(cookieName) {
-        return new CookieDetails(cookieName)
-            .map(actor => details => details === null || details === void 0 ? void 0 : details.domain)
-            .describedAs(`the domain of the "${cookieName}" cookie`);
-    }
-    static isHTTPOnly(cookieName) {
-        return new CookieDetails(cookieName)
-            .map(actor => details => details && !!details.httpOnly)
-            .describedAs(`the HTTP-only status of the "${cookieName}" cookie`);
-    }
-    static isSecure(cookieName) {
-        return new CookieDetails(cookieName)
-            .map(actor => details => details && !!details.secure)
-            .describedAs(`the "secure" status of the "${cookieName}" cookie`);
-    }
-    static expiryDateOf(cookieName) {
-        return new CookieDetails(cookieName)
-            .map(actor => details => (details === null || details === void 0 ? void 0 : details.expiry) && new Date(Number(details.expiry) * 1000) // expiry date coming from webdriver is expressed in seconds
-        )
-            .describedAs(`the expiry date of the "${cookieName}" cookie`);
-    }
-}
-exports.Cookie = Cookie;
-/**
- * @package
- */
-class CookieDetails extends core_1.Question {
-    constructor(name) {
-        super(`the details of the "${name} cookie`);
-        this.name = name;
-    }
-    /**
-     * @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 actor.answer(this.name)
-            .then(name => abilities_1.BrowseTheWeb.as(actor).manage().getCookie(name))
-            .then(details => details ? details : undefined);
-    }
-}
-//# sourceMappingURL=Cookie.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Cookie.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Cookie.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,4CAAqG;AAGrG,4CAA4C;AAE5C,MAAa,MAAM;IACf,MAAM,CAAC,OAAO,CAAC,UAA8B;QACzC,OAAO,gBAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;aACnF,EAAE,CAAC,qBAAsB,UAAW,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,UAA8B;QACxC,OAAO,gBAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;aAClF,EAAE,CAAC,oBAAqB,UAAW,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,UAAkB;QAC9B,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC;aAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;aACxC,WAAW,CAAC,sBAAuB,UAAW,UAAU,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,UAAkB;QAChC,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC;aAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,CAAE,OAAO,CAAC,QAAQ,CAAC;aACvD,WAAW,CAAC,gCAAiC,UAAW,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,UAAkB;QAC9B,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC;aAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,CAAE,OAAO,CAAC,MAAM,CAAC;aACrD,WAAW,CAAC,+BAAgC,UAAW,UAAU,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,UAAkB;QAClC,OAAO,IAAI,aAAa,CAAC,UAAU,CAAC;aAC/B,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CACpB,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,KAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,4DAA4D;SAC1H;aACA,WAAW,CAAC,2BAA4B,UAAW,UAAU,CAAC,CAAC;IACxE,CAAC;CACJ;AApCD,wBAoCC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,eAA0C;IAClE,YAA6B,IAAwB;QACjD,KAAK,CAAC,uBAAwB,IAAK,SAAS,CAAC,CAAC;QADrB,SAAI,GAAJ,IAAI,CAAoB;IAErD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAuC;QAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACzB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC7D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACJ"}

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

@@ -1,14 +0,0 @@
-import { Question } from '@serenity-js/core';
-/**
- * @desc
- *  Returns the result of last script executed via {@link ExecuteScript}
- */
-export declare class LastScriptExecution {
-    /**
-     * @desc
-     *  Enables asserting on the result of a function executed via {@link ExecuteScript}.
-     *
-     * @returns {Question<R>}
-     */
-    static result<R>(): Question<R>;
-}

package/lib/screenplay/questions/LastScriptExecution.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LastScriptExecution = void 0;
-const core_1 = require("@serenity-js/core");
-const abilities_1 = require("../abilities");
-/**
- * @desc
- *  Returns the result of last script executed via {@link ExecuteScript}
- */
-class LastScriptExecution {
-    /**
-     * @desc
-     *  Enables asserting on the result of a function executed via {@link ExecuteScript}.
-     *
-     * @returns {Question<R>}
-     */
-    static result() {
-        return core_1.Question.about(`last script execution result`, actor => abilities_1.BrowseTheWeb.as(actor).getLastScriptExecutionResult());
-    }
-}
-exports.LastScriptExecution = LastScriptExecution;
-//# sourceMappingURL=LastScriptExecution.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"LastScriptExecution.js","sourceRoot":"","sources":["../../../src/screenplay/questions/LastScriptExecution.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAE7C,4CAA4C;AAE5C;;;GAGG;AACH,MAAa,mBAAmB;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,MAAM;QACT,OAAO,eAAQ,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,EAAE,CAC1D,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAC/D,CAAC;CACJ;AAZD,kDAYC"}

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

@@ -1,120 +0,0 @@
-import { Question } from '@serenity-js/core';
-import { AlertPromise } from 'selenium-webdriver';
-/**
- * @desc
- *  Represents a modal dialog window created using
- *  [`Window.alert()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/alert),
- *  [`Window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt) or
- *  [`Window.confirm()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm).
- *
- *  Check out the examples below, as well as the unit tests demonstrating the usage.
- *
- * @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 { browser, by } from 'protractor';
- *
- *  class Widget {
- *      static trigger = Target.the('trigger button')
- *          .located(by.css('[data-test="trigger"]'));
- *  }
- *
- * @see {@link Accept}
- * @see {@link Dismiss}
- * @see {@link Enter}
- * @see {@link Wait}
- * @see {@link @serenity-js/assertions~Ensure}
- */
-export declare class ModalDialog {
-    /**
-     * @desc
-     *  A modal dialog window that could be {@link Accept}ed or {@link Dismiss}ed.
-     *
-     *  If the window was created using [`Window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt)
-     *  you can use the {@link @serenity-js/core/lib/screenplay~Interaction} to {@link Enter} with it too.
-     *
-     * @example <caption>Accepting an alert</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()),
-     *      );
-     *
-     * @see {@link Accept}
-     * @see {@link Dismiss}
-     * @see {@link Enter}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<AlertPromise>}
-     */
-    static window(): Question<AlertPromise>;
-    /**
-     * @desc
-     *  Resolves to `true` if the modal dialog window is present, or `false` if it's not.
-     *
-     * @example <caption>Verifying if a modal dialog window is present</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, ModalDialog } from '@serenity-js/protractor';
-     *  import { Ensure, isFalse, isTrue } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Ensure.that(ModalDialog.hasPoppedUp(), isFalse()),
-     *          Click.on(Widget.trigger),
-     *          Ensure.that(ModalDialog.hasPoppedUp(), isTrue()),
-     *      );
-     *
-     * @example <caption>Waiting for a modal dialog window</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, Dismiss, ModalDialog, Wait } from '@serenity-js/protractor';
-     *  import { isTrue } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Click.on(Widget.trigger),
-     *          Wait.until(ModalDialog.hasPoppedUp(), isTrue()),
-     *          Dismiss.the(ModalDialog.window()),
-     *      );
-     *
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link Wait}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<boolean>>}
-     */
-    static hasPoppedUp(): Question<Promise<boolean>>;
-    /**
-     * @desc
-     *  Resolves to the message displayed in the modal dialog window.
-     *
-     * @example <caption>Verifying the message</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, ModalDialog } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Click.on(Widget.trigger),
-     *          Ensure.that(ModalDialog.message(), equals('Hello!')),
-     *      );
-     *
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link Wait}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     */
-    static message(): Question<Promise<string>>;
-}

package/lib/screenplay/questions/ModalDialog.js

@@ -1,142 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModalDialog = void 0;
-const core_1 = require("@serenity-js/core");
-const selenium_webdriver_1 = require("selenium-webdriver");
-const promiseOf_1 = require("../../promiseOf");
-const abilities_1 = require("../abilities");
-/**
- * @desc
- *  Represents a modal dialog window created using
- *  [`Window.alert()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/alert),
- *  [`Window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt) or
- *  [`Window.confirm()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/confirm).
- *
- *  Check out the examples below, as well as the unit tests demonstrating the usage.
- *
- * @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 { browser, by } from 'protractor';
- *
- *  class Widget {
- *      static trigger = Target.the('trigger button')
- *          .located(by.css('[data-test="trigger"]'));
- *  }
- *
- * @see {@link Accept}
- * @see {@link Dismiss}
- * @see {@link Enter}
- * @see {@link Wait}
- * @see {@link @serenity-js/assertions~Ensure}
- */
-class ModalDialog {
-    /**
-     * @desc
-     *  A modal dialog window that could be {@link Accept}ed or {@link Dismiss}ed.
-     *
-     *  If the window was created using [`Window.prompt()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/prompt)
-     *  you can use the {@link @serenity-js/core/lib/screenplay~Interaction} to {@link Enter} with it too.
-     *
-     * @example <caption>Accepting an alert</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()),
-     *      );
-     *
-     * @see {@link Accept}
-     * @see {@link Dismiss}
-     * @see {@link Enter}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<AlertPromise>}
-     */
-    static window() {
-        return core_1.Question.about(`the modal dialog window`, actor => abilities_1.BrowseTheWeb.as(actor).alert());
-    }
-    /**
-     * @desc
-     *  Resolves to `true` if the modal dialog window is present, or `false` if it's not.
-     *
-     * @example <caption>Verifying if a modal dialog window is present</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, ModalDialog } from '@serenity-js/protractor';
-     *  import { Ensure, isFalse, isTrue } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Ensure.that(ModalDialog.hasPoppedUp(), isFalse()),
-     *          Click.on(Widget.trigger),
-     *          Ensure.that(ModalDialog.hasPoppedUp(), isTrue()),
-     *      );
-     *
-     * @example <caption>Waiting for a modal dialog window</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, Dismiss, ModalDialog, Wait } from '@serenity-js/protractor';
-     *  import { isTrue } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Click.on(Widget.trigger),
-     *          Wait.until(ModalDialog.hasPoppedUp(), isTrue()),
-     *          Dismiss.the(ModalDialog.window()),
-     *      );
-     *
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link Wait}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<boolean>>}
-     */
-    static hasPoppedUp() {
-        return core_1.Question.about(`the modal dialog has popped up`, actor => (0, promiseOf_1.promiseOf)(abilities_1.BrowseTheWeb.as(actor).alert()).then(() => true, error => {
-            // Based on:
-            // https://github.com/SeleniumHQ/selenium/blob/941dc9c6b2e2aa4f701c1b72be8de03d4b7e996a/javascript/node/selenium-webdriver/lib/until.js#L107
-            return !(error instanceof selenium_webdriver_1.error.NoSuchAlertError
-                // XXX: Workaround for GeckoDriver error `TypeError: can't convert null
-                // to object`. For more details, see
-                // https://github.com/SeleniumHQ/selenium/pull/2137
-                || (error instanceof selenium_webdriver_1.error.WebDriverError
-                    && error.message === `can't convert null to object`));
-        }));
-    }
-    /**
-     * @desc
-     *  Resolves to the message displayed in the modal dialog window.
-     *
-     * @example <caption>Verifying the message</caption>
-     *  import { actorCalled } from '@serenity-js/core';
-     *  import { BrowseTheWeb, Click, ModalDialog } from '@serenity-js/protractor';
-     *  import { Ensure, equals } from '@serenity-js/assertions';
-     *  import { protractor } from 'protractor';
-     *
-     *  actorCalled('Nick')
-     *      .whoCan(BrowseTheWeb.using(protractor.browser))
-     *      .attemptsTo(
-     *          Click.on(Widget.trigger),
-     *          Ensure.that(ModalDialog.message(), equals('Hello!')),
-     *      );
-     *
-     * @see {@link @serenity-js/assertions~Ensure}
-     * @see {@link Wait}
-     *
-     * @returns {@serenity-js/core/lib/screenplay~Question<Promise<string>>}
-     */
-    static message() {
-        return core_1.Question.about(`the modal dialog message`, actor => (0, promiseOf_1.promiseOf)(abilities_1.BrowseTheWeb.as(actor).alert().getText()));
-    }
-}
-exports.ModalDialog = ModalDialog;
-//# sourceMappingURL=ModalDialog.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ModalDialog.js","sourceRoot":"","sources":["../../../src/screenplay/questions/ModalDialog.ts"],"names":[],"mappings":";;;AAAA,4CAA6C;AAC7C,2DAAmE;AAEnE,+CAA4C;AAC5C,4CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAa,WAAW;IAEpB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,MAAM;QACT,OAAO,eAAQ,CAAC,KAAK,CAAe,yBAAyB,EAAE,KAAK,CAAC,EAAE,CACnE,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CACjC,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,WAAW;QACd,OAAO,eAAQ,CAAC,KAAK,CAAmB,gCAAgC,EAAE,KAAK,CAAC,EAAE,CAC9E,IAAA,qBAAS,EAAC,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YAC/D,YAAY;YACZ,4IAA4I;YAC5I,OAAO,CAAE,CAAC,KAAK,YAAY,0BAAM,CAAC,gBAAgB;gBAC9C,uEAAuE;gBACvE,oCAAoC;gBACpC,mDAAmD;mBAChD,CAAC,KAAK,YAAY,0BAAM,CAAC,cAAc;uBACnC,KAAK,CAAC,OAAO,KAAK,8BAA8B,CAAC,CAC3D,CAAC;QACN,CAAC,CAAC,CACL,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,OAAO;QACV,OAAO,eAAQ,CAAC,KAAK,CAAkB,0BAA0B,EAAE,KAAK,CAAC,EAAE,CACvE,IAAA,qBAAS,EAAC,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CACtD,CAAC;IACN,CAAC;CACJ;AAjHD,kCAiHC"}

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

@@ -1,72 +0,0 @@
-import { AnswersQuestions, Expectation, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
-export interface Collection<T> {
-    filter(fn: (item: T, index?: number) => boolean | Promise<boolean>): Collection<T>;
-    map<O>(fn: (item: T, index?: number) => O): PromiseLike<O[]>;
-    first(): T;
-    last(): T;
-    get(index: number): T;
-    count(): PromiseLike<number> | number;
-}
-/**
- * @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}
- */
-export declare class Pick<Item_Type, Collection_Type extends Collection<Item_Type> = Collection<Item_Type>> {
-    private readonly collection;
-    private readonly filters;
-    static from<IT, CT extends Collection<IT> = Collection<IT>>(collection: Question<CT> | CT): Pick<IT, CT>;
-    constructor(collection: Question<Collection_Type> | Collection_Type, filters?: Filters<Item_Type, Collection_Type>);
-    count(): Question<Promise<number>>;
-    all(): Question<Collection_Type>;
-    first(): Question<Item_Type>;
-    last(): Question<Item_Type>;
-    get(index: number): Question<Item_Type>;
-    where<Property_Type>(question: MetaQuestion<Item_Type, Promise<Property_Type> | Property_Type>, expectation: Expectation<any, Promise<Property_Type> | Property_Type>): Pick<Item_Type, Collection_Type>;
-}
-/**
- * @package
- */
-declare class Filters<Item_Type, Collection_Type extends Collection<Item_Type>> extends Question<(ct: Collection_Type) => Collection_Type> {
-    private readonly filters;
-    constructor(filters?: Array<Filter<Item_Type, Collection_Type, any>>);
-    append(filter: Filter<Item_Type, Collection_Type, any>): Filters<Item_Type, Collection_Type>;
-    /**
-     * @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): (ct: Collection_Type) => Collection_Type;
-}
-/**
- * @package
- */
-declare class Filter<Item_Type, Collection_Type extends Collection<Item_Type>, Property_Type> extends Question<(ct: Collection_Type) => Collection_Type> {
-    private readonly question;
-    private readonly expectation;
-    constructor(question: MetaQuestion<Item_Type, Promise<Property_Type> | Property_Type>, expectation: Expectation<any, Promise<Property_Type> | Property_Type>);
-    /**
-     * @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): (ct: Collection_Type) => Collection_Type;
-}
-export {};