@serenity-js/web 3.0.0-rc.8 → 3.0.0

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

@@ -1,93 +1,138 @@
-import { Answerable, AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
+import { Answerable, AnswersQuestions, MetaQuestion, Question, QuestionAdapter, UsesAbilities } from '@serenity-js/core';
 import { PageElement } from '../models';
-import { ElementQuestion } from './ElementQuestion';
 /**
- * @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 Answerable<{@link @wdio/types~Element}>.
- *
- * @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, by, CssClasses, Target } from '@serenity-js/webdriverio';
- *
- *  const shoppingList = () =>
- *      Target.the('shopping list').located(by.id('shopping-list'))
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(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, contain } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, by, CssClasses, Target } from '@serenity-js/webdriverio';
- *
- *  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(browser))
- *      .attemptsTo(
- *          Ensure.that(
- *              Text.ofAll(ShoppingList.outstandingItems()),
- *              equals([ 'Honey', 'Chocolate' ])
- *          ),
- *      )
- *
- * @extends {ElementQuestion}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
+ * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+ * of a given {@apilink PageElement}.
+ *
+ * ## Example widget
+ *
+ * ```html
+ * <ul id="shopping-list" class="active favourite">
+ *   <li class="bought">Coffee<li>
+ *   <li class="buy">Honey<li>
+ *   <li class="buy">Chocolate<li>
+ * </ul>
+ * ```
+ *
+ * ## Retrieve CSS classes of a given {@apilink PageElement}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * const shoppingList = () =>
+ *   PageElement.located(By.css('#shopping-list'))
+ *     .describedAs('shopping list')
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList()),
+ *       equals([ 'active', 'favourite' ])
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Using CssClasses as {@apilink QuestionAdapter}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * const shoppingList = () =>
+ *   PageElement.located(By.css('#shopping-list'))
+ *     .describedAs('shopping list')
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList()).length,
+ *       equals(2)
+ *     ),
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList())[0],
+ *       equals('active')
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, contain } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * class ShoppingList {
+ *   static items = () =>
+ *     PageElements.located(By.css('#shopping-list li'))
+ *       .describedAs('items')
+ *
+ *   static outstandingItems = () =>
+ *     ShoppingList.items()
+ *       .where(CssClasses, contain('buy'))
+ * }
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       Text.ofAll(ShoppingList.outstandingItems()),
+ *       equals([ 'Honey', 'Chocolate' ])
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink MetaQuestion}
+ * - {@apilink QuestionAdapter}
+ * - {@apilink Question}
+ *
+ * @group Questions
  */
-export declare class CssClasses extends ElementQuestion<Promise<string[]>> implements MetaQuestion<Answerable<PageElement>, Promise<string[]>> {
-    private readonly target;
+export declare class CssClasses extends Question<Promise<string[]>> implements MetaQuestion<Answerable<PageElement>, Promise<string[]>> {
+    private readonly pageElement;
+    private subject;
     /**
-     * @param {Question<PageElement> | PageElement} target
-     * @returns {CssClasses}
-     */
-    static of(target: Answerable<PageElement>): CssClasses;
-    /**
-     * @param {Question<PageElement> | PageElement} target
+     * Instantiates a {@apilink Question} that uses
+     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+     * of a given {@apilink PageElement}.
+     *
+     * #### Learn more
+     * - {@apilink MetaQuestion}
+     *
+     * @param pageElement
      */
-    constructor(target: Answerable<PageElement>);
+    static of(pageElement: Answerable<PageElement>): QuestionAdapter<string[]> & MetaQuestion<Answerable<PageElement>, Promise<string[]>>;
+    protected constructor(pageElement: Answerable<PageElement>);
     /**
-     * @desc
-     *  Resolves to an array of CSS classes of the `target` element,
-     *  located in the context of a `parent` element.
+     * Instantiates a {@apilink Question} that uses
+     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+     * of a given {@apilink PageElement},
+     * located in a given `parent` element.
      *
-     * @param {@serenity-js/core/lib/screenplay~Answerable<Element>} parent
-     * @returns {Question<Promise<string[]>>}
+     * #### Learn more
+     * - {@apilink MetaQuestion}
      *
-     * @see {@link Target.all}
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     * @param parent
      */
     of(parent: Answerable<PageElement>): Question<Promise<string[]>>;
     /**
-     * @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}
+     * @inheritDoc
      */
     answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string[]>;
+    /**
+     * @inheritDoc
+     */
+    describedAs(subject: string): this;
+    /**
+     * @inheritDoc
+     */
+    toString(): string;
 }
+//# sourceMappingURL=CssClasses.d.ts.map

package/lib/screenplay/questions/CssClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CssClasses.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/CssClasses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAK,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5H,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,qBAAa,UACT,SAAQ,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAClC,YAAW,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAmB7C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAjBlD,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAIrI,SAAS,aAA8B,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;IAK3E;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAIhE;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAa5E;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGrB"}

package/lib/screenplay/questions/CssClasses.js

@@ -1,105 +1,141 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CssClasses = void 0;
-const io_1 = require("@serenity-js/core/lib/io");
+const core_1 = require("@serenity-js/core");
 const models_1 = require("../models");
-const ElementQuestion_1 = require("./ElementQuestion");
 /**
- * @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 Answerable<{@link @wdio/types~Element}>.
- *
- * @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, by, CssClasses, Target } from '@serenity-js/webdriverio';
- *
- *  const shoppingList = () =>
- *      Target.the('shopping list').located(by.id('shopping-list'))
- *
- *  actorCalled('Lisa')
- *      .whoCan(BrowseTheWeb.using(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, contain } from '@serenity-js/assertions';
- *  import { BrowseTheWeb, by, CssClasses, Target } from '@serenity-js/webdriverio';
- *
- *  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(browser))
- *      .attemptsTo(
- *          Ensure.that(
- *              Text.ofAll(ShoppingList.outstandingItems()),
- *              equals([ 'Honey', 'Chocolate' ])
- *          ),
- *      )
- *
- * @extends {ElementQuestion}
- * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
+ * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+ * of a given {@apilink PageElement}.
+ *
+ * ## Example widget
+ *
+ * ```html
+ * <ul id="shopping-list" class="active favourite">
+ *   <li class="bought">Coffee<li>
+ *   <li class="buy">Honey<li>
+ *   <li class="buy">Chocolate<li>
+ * </ul>
+ * ```
+ *
+ * ## Retrieve CSS classes of a given {@apilink PageElement}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * const shoppingList = () =>
+ *   PageElement.located(By.css('#shopping-list'))
+ *     .describedAs('shopping list')
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList()),
+ *       equals([ 'active', 'favourite' ])
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Using CssClasses as {@apilink QuestionAdapter}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * const shoppingList = () =>
+ *   PageElement.located(By.css('#shopping-list'))
+ *     .describedAs('shopping list')
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList()).length,
+ *       equals(2)
+ *     ),
+ *     Ensure.that(
+ *       CssClasses.of(shoppingList())[0],
+ *       equals('active')
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Ensure, contain } from '@serenity-js/assertions'
+ * import { By, CssClasses, PageElement } from '@serenity-js/web'
+ *
+ * class ShoppingList {
+ *   static items = () =>
+ *     PageElements.located(By.css('#shopping-list li'))
+ *       .describedAs('items')
+ *
+ *   static outstandingItems = () =>
+ *     ShoppingList.items()
+ *       .where(CssClasses, contain('buy'))
+ * }
+ *
+ * await actorCalled('Lisa')
+ *   .attemptsTo(
+ *     Ensure.that(
+ *       Text.ofAll(ShoppingList.outstandingItems()),
+ *       equals([ 'Honey', 'Chocolate' ])
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink MetaQuestion}
+ * - {@apilink QuestionAdapter}
+ * - {@apilink Question}
+ *
+ * @group Questions
  */
-class CssClasses extends ElementQuestion_1.ElementQuestion {
+class CssClasses extends core_1.Question {
     /**
-     * @param {Question<PageElement> | PageElement} target
+     * Instantiates a {@apilink Question} that uses
+     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+     * of a given {@apilink PageElement}.
+     *
+     * #### Learn more
+     * - {@apilink MetaQuestion}
+     *
+     * @param pageElement
      */
-    constructor(target) {
-        super((0, io_1.formatted) `CSS classes of ${target}`);
-        this.target = target;
+    static of(pageElement) {
+        return core_1.Question.createAdapter(new CssClasses(pageElement));
     }
-    /**
-     * @param {Question<PageElement> | PageElement} target
-     * @returns {CssClasses}
-     */
-    static of(target) {
-        return new CssClasses(target);
+    constructor(pageElement) {
+        super();
+        this.pageElement = pageElement;
+        this.subject = (0, core_1.d) `CSS classes of ${pageElement}`;
     }
     /**
-     * @desc
-     *  Resolves to an array of CSS classes of the `target` element,
-     *  located in the context of a `parent` element.
+     * Instantiates a {@apilink Question} that uses
+     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
+     * of a given {@apilink PageElement},
+     * located in a given `parent` element.
      *
-     * @param {@serenity-js/core/lib/screenplay~Answerable<Element>} parent
-     * @returns {Question<Promise<string[]>>}
+     * #### Learn more
+     * - {@apilink MetaQuestion}
      *
-     * @see {@link Target.all}
-     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     * @param parent
      */
     of(parent) {
-        return new CssClasses(models_1.PageElement.of(this.target, parent));
+        return new CssClasses(models_1.PageElement.of(this.pageElement, parent));
     }
     /**
-     * @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}
+     * @inheritDoc
      */
     async answeredBy(actor) {
-        const element = await this.resolve(actor, this.target);
+        const element = await actor.answer(this.pageElement);
         return element.attribute('class')
             .then(attribute => attribute !== null && attribute !== void 0 ? attribute : '')
             .then(attribute => attribute
@@ -108,6 +144,19 @@ class CssClasses extends ElementQuestion_1.ElementQuestion {
             .split(' ')
             .filter(cssClass => !!cssClass));
     }
+    /**
+     * @inheritDoc
+     */
+    describedAs(subject) {
+        this.subject = subject;
+        return this;
+    }
+    /**
+     * @inheritDoc
+     */
+    toString() {
+        return this.subject;
+    }
 }
 exports.CssClasses = CssClasses;
 //# sourceMappingURL=CssClasses.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CssClasses.js","sourceRoot":"","sources":["../../../src/screenplay/questions/CssClasses.ts"],"names":[],"mappings":";;;AACA,iDAAqD;AAErD,sCAAwC;AACxC,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAa,UACT,SAAQ,iCAAkC;IAW1C;;OAEG;IACH,YAA6B,MAA+B;QACxD,KAAK,CAAC,IAAA,cAAS,EAAC,kBAAmB,MAAM,EAAE,CAAC,CAAC;QADpB,WAAM,GAAN,MAAM,CAAyB;IAE5D,CAAC;IAbD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,MAA+B;QACrC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IASD;;;;;;;;;;OAUG;IACH,EAAE,CAAC,MAA+B;QAC9B,OAAO,IAAI,UAAU,CAAC,oBAAW,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvD,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;aAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;aAClC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS;aACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAE,QAAQ,CAAC,CACnC,CAAC;IACV,CAAC;CACJ;AA1DD,gCA0DC"}
+{"version":3,"file":"CssClasses.js","sourceRoot":"","sources":["../../../src/screenplay/questions/CssClasses.ts"],"names":[],"mappings":";;;AAAA,4CAA4H;AAE5H,sCAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,MAAa,UACT,SAAQ,eAA2B;IAKnC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,CAAC,WAAoC;QAC1C,OAAO,eAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAyF,CAAC;IACvJ,CAAC;IAED,YAAuC,WAAoC;QACvE,KAAK,EAAE,CAAC;QAD2B,gBAAW,GAAX,WAAW,CAAyB;QAEvE,IAAI,CAAC,OAAO,GAAG,IAAA,QAAC,EAAA,kBAAmB,WAAW,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,MAA+B;QAC9B,OAAO,IAAI,UAAU,CAAC,oBAAW,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAErD,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;aAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,EAAE,CAAC;aAClC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS;aACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAE,QAAQ,CAAC,CACnC,CAAC;IACV,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAxED,gCAwEC"}

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

@@ -1,14 +1,50 @@
 import { QuestionAdapter } from '@serenity-js/core';
 /**
- * @desc
- *  Returns the result of last script executed via {@link ExecuteScript}
+ * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * a returns the result of the last script executed via {@apilink ExecuteScript}.
+ *
+ * ## Executing a script and reading the result
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { ExecuteScript, LastScriptExecution } from '@serenity-js/web'
+ * import { Ensure, includes } from '@serenity-js/assertions'
+ *
+ * await actorCalled('Joseph')
+ *   .attemptsTo(
+ *     ExecuteScript.sync(() => navigator.userAgent),
+ *     Ensure.that(LastScriptExecution.result<string>(), includes('Chrome')),
+ *   )
+ * ```
+ *
+ * ## Using LastScriptExecution as {@apilink QuestionAdapter}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { ExecuteScript, LastScriptExecution } from '@serenity-js/web'
+ * import { Ensure, includes } from '@serenity-js/assertions'
+ *
+ * await actorCalled('Joseph')
+ *   .attemptsTo(
+ *     ExecuteScript.sync(() => navigator.userAgent),
+ *     Ensure.that(
+ *       LastScriptExecution.result<string>().toLocaleLowerCase(),
+ *       includes('chrome')
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink ExecuteScript}
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink QuestionAdapter}
+ *
+ * @group Questions
  */
 export declare class LastScriptExecution {
     /**
-     * @desc
-     *  Enables asserting on the result of a function executed via {@link ExecuteScript}.
-     *
-     * @returns {Question<R>}
+     * Enables asserting on the result of a function executed via {@apilink ExecuteScript}.
      */
     static result<R>(): QuestionAdapter<R>;
 }
+//# sourceMappingURL=LastScriptExecution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LastScriptExecution.d.ts","sourceRoot":"","sources":["../../../src/screenplay/questions/LastScriptExecution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,mBAAmB;IAE5B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC;CAMzC"}

package/lib/screenplay/questions/LastScriptExecution.js

@@ -4,18 +4,56 @@ 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}
+ * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * a returns the result of the last script executed via {@apilink ExecuteScript}.
+ *
+ * ## Executing a script and reading the result
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { ExecuteScript, LastScriptExecution } from '@serenity-js/web'
+ * import { Ensure, includes } from '@serenity-js/assertions'
+ *
+ * await actorCalled('Joseph')
+ *   .attemptsTo(
+ *     ExecuteScript.sync(() => navigator.userAgent),
+ *     Ensure.that(LastScriptExecution.result<string>(), includes('Chrome')),
+ *   )
+ * ```
+ *
+ * ## Using LastScriptExecution as {@apilink QuestionAdapter}
+ *
+ * ```ts
+ * import { actorCalled } from '@serenity-js/core'
+ * import { ExecuteScript, LastScriptExecution } from '@serenity-js/web'
+ * import { Ensure, includes } from '@serenity-js/assertions'
+ *
+ * await actorCalled('Joseph')
+ *   .attemptsTo(
+ *     ExecuteScript.sync(() => navigator.userAgent),
+ *     Ensure.that(
+ *       LastScriptExecution.result<string>().toLocaleLowerCase(),
+ *       includes('chrome')
+ *     ),
+ *   )
+ * ```
+ *
+ * ## Learn more
+ * - {@apilink ExecuteScript}
+ * - {@apilink BrowseTheWeb}
+ * - {@apilink QuestionAdapter}
+ *
+ * @group Questions
  */
 class LastScriptExecution {
     /**
-     * @desc
-     *  Enables asserting on the result of a function executed via {@link ExecuteScript}.
-     *
-     * @returns {Question<R>}
+     * Enables asserting on the result of a function executed via {@apilink ExecuteScript}.
      */
     static result() {
-        return core_1.Question.about(`last script execution result`, actor => abilities_1.BrowseTheWeb.as(actor).lastScriptExecutionResult());
+        return core_1.Question.about(`last script execution result`, async (actor) => {
+            const page = await abilities_1.BrowseTheWeb.as(actor).currentPage();
+            return page.lastScriptExecutionResult();
+        });
     }
 }
 exports.LastScriptExecution = LastScriptExecution;

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

@@ -1 +1 @@
-{"version":3,"file":"LastScriptExecution.js","sourceRoot":"","sources":["../../../src/screenplay/questions/LastScriptExecution.ts"],"names":[],"mappings":";;;AAAA,4CAA8D;AAE9D,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,yBAAyB,EAAE,CAAC,CAAC;IAC5D,CAAC;CACJ;AAZD,kDAYC"}
+{"version":3,"file":"LastScriptExecution.js","sourceRoot":"","sources":["../../../src/screenplay/questions/LastScriptExecution.ts"],"names":[],"mappings":";;;AAAA,4CAA8D;AAE9D,4CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAa,mBAAmB;IAE5B;;OAEG;IACH,MAAM,CAAC,MAAM;QACT,OAAO,eAAQ,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAChE,MAAM,IAAI,GAAG,MAAM,wBAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,yBAAyB,EAAK,CAAC;QAC/C,CAAC,CAAC,CAAA;IACN,CAAC;CACJ;AAXD,kDAWC"}