@serenity-js/web 3.0.0-rc.0

package/lib/screenplay/questions/Selected.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Selected = void 0;
+const io_1 = require("@serenity-js/core/lib/io");
+const models_1 = require("../models");
+/**
+ * @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}
+ */
+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 {Answerable<PageElement>} pageElement
+     *  A {@link PageElement} identifying the `<select>` element of interest
+     *
+     * @returns {Question<Promise<string>>}
+     *
+     * @see {@link Select.value}
+     */
+    static valueOf(pageElement) {
+        return models_1.PageElement.locatedByCss('option:checked')
+            .of(pageElement)
+            .value()
+            .describedAs((0, io_1.formatted) `value selected in ${pageElement}`);
+    }
+    /**
+     * @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 {Answerable<PageElement>} pageElement
+     *  A {@link Target} identifying the `<select>` element of interest
+     *
+     * @returns {Question<Promise<string[]>>}
+     *
+     * @see {@link Select.values}
+     */
+    static valuesOf(pageElement) {
+        return models_1.PageElements.locatedByCss('option:checked')
+            .of(pageElement)
+            .map(item => item.value())
+            .describedAs((0, io_1.formatted) `values selected in ${pageElement}`);
+    }
+    /**
+     * @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 {Answerable<PageElement>} pageElement
+     *  A {@link Target} identifying the `<select>` element of interest
+     *
+     * @returns {Question<Promise<string>>}
+     *
+     * @see {@link Select.option}
+     */
+    static optionIn(pageElement) {
+        return models_1.PageElement.locatedByCss('option:checked')
+            .of(pageElement)
+            .text()
+            .describedAs((0, io_1.formatted) `option selected in ${pageElement}`);
+    }
+    /**
+     * @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 {Answerable<PageElement>} pageElement
+     *  A {@link Target} identifying the `<select>` element of interest
+     *
+     * @returns {Question<Promise<string[]>>}
+     *
+     * @see {@link Select.options}
+     */
+    static optionsIn(pageElement) {
+        return models_1.PageElements.locatedByCss('option:checked')
+            .of(pageElement)
+            .map(item => item.text())
+            .describedAs((0, io_1.formatted) `options selected in ${pageElement}`);
+    }
+}
+exports.Selected = Selected;
+//# sourceMappingURL=Selected.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Selected.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Selected.ts"],"names":[],"mappings":";;;AACA,iDAAqD;AAErD,sCAAsD;AAEtD;;;;;;GAMG;AACH,MAAa,QAAQ;IAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,MAAM,CAAC,OAAO,CAAC,WAAoC;QAC/C,OAAO,oBAAW,CAAC,YAAY,CAAC,gBAAgB,CAAC;aAC5C,EAAE,CAAC,WAAW,CAAC;aACf,KAAK,EAAE;aACP,WAAW,CAAC,IAAA,cAAS,EAAC,qBAAsB,WAAY,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAoC;QAChD,OAAO,qBAAY,CAAC,YAAY,CAAC,gBAAgB,CAAC;aAC7C,EAAE,CAAC,WAAW,CAAC;aACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;aACzB,WAAW,CAAC,IAAA,cAAS,EAAC,sBAAuB,WAAY,EAAE,CAAgC,CAAC;IACrG,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAoC;QAChD,OAAO,oBAAW,CAAC,YAAY,CAAC,gBAAgB,CAAC;aAC5C,EAAE,CAAC,WAAW,CAAC;aACf,IAAI,EAAE;aACN,WAAW,CAAC,IAAA,cAAS,EAAC,sBAAuB,WAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2CG;IACH,MAAM,CAAC,SAAS,CAAC,WAAoC;QACjD,OAAO,qBAAY,CAAC,YAAY,CAAC,gBAAgB,CAAC;aAC7C,EAAE,CAAC,WAAW,CAAC;aACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aACxB,WAAW,CAAC,IAAA,cAAS,EAAC,uBAAwB,WAAY,EAAE,CAAgC,CAAC;IACtG,CAAC;CACJ;AAvMD,4BAuMC"}

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

@@ -0,0 +1,99 @@
+import { Adapter, Answerable, MetaQuestion, Question } from '@serenity-js/core';
+import { PageElement, PageElements } from '../models';
+/**
+ * @desc
+ *  Resolves to the visible (i.e. not hidden by CSS) `innerText` of:
+ *  - a given {@link WebElement}, represented by Answerable<{@link @wdio/types~Element}>
+ *  - a group of {@link WebElement}s, represented by Answerable<{@link @wdio/types~ElementList}>
+ *
+ *  The result includes the visible text of any sub-elements, without any leading or trailing whitespace.
+ *
+ * @example <caption>Example widget</caption>
+ *  <h1>Shopping list</h1>
+ *  <ul id="shopping-list">
+ *    <li>Coffee<li>
+ *    <li class="bought">Honey<li>
+ *    <li>Chocolate<li>
+ *  </ul>
+ *
+ * @example <caption>Retrieve text of a single element</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { Ensure, equals } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const header = () =>
+ *      Target.the('header').located(by.tagName('h1'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(Text.of(header()), equals('Shopping list')),
+ *      )
+ *
+ * @example <caption>Retrieve text of a multiple elements</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { Ensure, equals } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const shoppingListItems = () =>
+ *      Target.the('shopping list items').located(by.css('#shopping-list li'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(
+ *              Text.ofAll(shoppingListItems()),
+ *              equals([ 'Coffee', 'Honey', 'Chocolate' ])
+ *          ),
+ *      )
+ *
+ * @example <caption>Find element with matching text</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { contain, Ensure } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, CssClasses, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const shoppingListItemCalled = (name: string) =>
+ *      Target.the('shopping list items').located(by.css('#shopping-list li'))
+ *          .where(Text, equals(name))
+ *          .first()
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(
+ *              CssClasses.of(shoppingListItemCalled('Honey)),
+ *              contain('bought')
+ *          ),
+ *      )
+ *
+ * @public
+ * @see {@link Target}
+ */
+export declare class Text {
+    /**
+     * @desc
+     *  Retrieves text of a single {@link WebElement},
+     *  represented by Answerable<{@link @wdio/types~Element}>.
+     *
+     * @param {Answerable<PageElement>} element
+     * @returns {Question<Promise<string>> & MetaQuestion<Answerable<PageElement>, Promise<string>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    static of(element: Answerable<PageElement>): Question<Promise<string>> & // eslint-disable-line @typescript-eslint/indent
+    MetaQuestion<Answerable<PageElement>, Promise<string>> & // eslint-disable-line @typescript-eslint/indent
+    Adapter<string>;
+    /**
+     * @desc
+     *  Retrieves text of a group of {@link WebElement}s,
+     *  represented by Answerable<{@link @wdio/types~ElementList}>
+     *
+     * @param {Answerable<PageElements>} elements
+     * @returns {Question<Promise<string[]>> & MetaQuestion<Answerable<PageElement>, Promise<string[]>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    static ofAll(elements: Answerable<PageElements>): Question<Promise<string[]>> & // eslint-disable-line @typescript-eslint/indent
+    MetaQuestion<Answerable<PageElement>, Promise<string[]>> & // eslint-disable-line @typescript-eslint/indent
+    Adapter<string[]>;
+}

package/lib/screenplay/questions/Text.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Text = void 0;
+const core_1 = require("@serenity-js/core");
+const models_1 = require("../models");
+const ElementQuestion_1 = require("./ElementQuestion");
+/**
+ * @desc
+ *  Resolves to the visible (i.e. not hidden by CSS) `innerText` of:
+ *  - a given {@link WebElement}, represented by Answerable<{@link @wdio/types~Element}>
+ *  - a group of {@link WebElement}s, represented by Answerable<{@link @wdio/types~ElementList}>
+ *
+ *  The result includes the visible text of any sub-elements, without any leading or trailing whitespace.
+ *
+ * @example <caption>Example widget</caption>
+ *  <h1>Shopping list</h1>
+ *  <ul id="shopping-list">
+ *    <li>Coffee<li>
+ *    <li class="bought">Honey<li>
+ *    <li>Chocolate<li>
+ *  </ul>
+ *
+ * @example <caption>Retrieve text of a single element</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { Ensure, equals } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const header = () =>
+ *      Target.the('header').located(by.tagName('h1'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(Text.of(header()), equals('Shopping list')),
+ *      )
+ *
+ * @example <caption>Retrieve text of a multiple elements</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { Ensure, equals } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const shoppingListItems = () =>
+ *      Target.the('shopping list items').located(by.css('#shopping-list li'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(
+ *              Text.ofAll(shoppingListItems()),
+ *              equals([ 'Coffee', 'Honey', 'Chocolate' ])
+ *          ),
+ *      )
+ *
+ * @example <caption>Find element with matching text</caption>
+ *  import { actorCalled } from '@serenity-js/core';
+ *  import { contain, Ensure } from '@serenity-js/assertions';
+ *  import { BrowseTheWeb, by, CssClasses, Target, Text } from '@serenity-js/webdriverio';
+ *
+ *  const shoppingListItemCalled = (name: string) =>
+ *      Target.the('shopping list items').located(by.css('#shopping-list li'))
+ *          .where(Text, equals(name))
+ *          .first()
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(
+ *              CssClasses.of(shoppingListItemCalled('Honey)),
+ *              contain('bought')
+ *          ),
+ *      )
+ *
+ * @public
+ * @see {@link Target}
+ */
+class Text {
+    /**
+     * @desc
+     *  Retrieves text of a single {@link WebElement},
+     *  represented by Answerable<{@link @wdio/types~Element}>.
+     *
+     * @param {Answerable<PageElement>} element
+     * @returns {Question<Promise<string>> & MetaQuestion<Answerable<PageElement>, Promise<string>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    static of(element) {
+        return (0, core_1.createAdapter)(new TextOfSingleElement(element));
+    }
+    /**
+     * @desc
+     *  Retrieves text of a group of {@link WebElement}s,
+     *  represented by Answerable<{@link @wdio/types~ElementList}>
+     *
+     * @param {Answerable<PageElements>} elements
+     * @returns {Question<Promise<string[]>> & MetaQuestion<Answerable<PageElement>, Promise<string[]>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    static ofAll(elements) {
+        return (0, core_1.createAdapter)(new TextOfMultipleElements(elements));
+    }
+}
+exports.Text = Text;
+class TextOfSingleElement extends ElementQuestion_1.ElementQuestion {
+    constructor(element) {
+        super(`the text of ${element}`);
+        this.element = element;
+    }
+    of(parent) {
+        return new TextOfSingleElement(models_1.PageElement.of(this.element, parent));
+    }
+    async answeredBy(actor) {
+        const element = await this.resolve(actor, this.element);
+        return element.text();
+    }
+}
+class TextOfMultipleElements extends ElementQuestion_1.ElementQuestion {
+    constructor(elements) {
+        super(`the text of ${elements}`);
+        this.elements = elements;
+    }
+    of(parent) {
+        return new TextOfMultipleElements(models_1.PageElements.of(this.elements, parent));
+    }
+    async answeredBy(actor) {
+        const elements = await this.resolve(actor, this.elements);
+        return elements.map(element => element.text());
+    }
+}
+//# sourceMappingURL=Text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Text.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Text.ts"],"names":[],"mappings":";;;AAAA,4CAAgI;AAEhI,sCAAsD;AACtD,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAa,IAAI;IAEb;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,CAAC,OAAgC;QAKtC,OAAO,IAAA,oBAAa,EAChB,IAAI,mBAAmB,CAAC,OAAO,CAAC,CACnC,CAAC;IACN,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,QAAkC;QAK3C,OAAO,IAAA,oBAAa,EAChB,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CACvC,CAAC;IACN,CAAC;CACJ;AAzCD,oBAyCC;AAED,MAAM,mBACF,SAAQ,iCAAgC;IAGxC,YAA6B,OAAgC;QACzD,KAAK,CAAC,eAAgB,OAAQ,EAAE,CAAC,CAAC;QADT,YAAO,GAAP,OAAO,CAAyB;IAE7D,CAAC;IAED,EAAE,CAAC,MAA+B;QAC9B,OAAO,IAAI,mBAAmB,CAAC,oBAAW,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED,MAAM,sBACF,SAAQ,iCAAkC;IAG1C,YAA6B,QAAkC;QAC3D,KAAK,CAAC,eAAgB,QAAS,EAAE,CAAC,CAAC;QADV,aAAQ,GAAR,QAAQ,CAA0B;IAE/D,CAAC;IAED,EAAE,CAAC,MAA+B;QAC9B,OAAO,IAAI,sBAAsB,CAAC,qBAAY,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;CACJ"}

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

@@ -0,0 +1,64 @@
+import { Answerable, AnswersQuestions, MetaQuestion, Question, UsesAbilities } from '@serenity-js/core';
+import { PageElement } from '../models';
+import { ElementQuestion } from './ElementQuestion';
+/**
+ * @desc
+ *  Returns the `value` attribute of a given {@link WebElement},
+ *  represented by Answerable<{@link @wdio/types~Element}>
+ *
+ * @example <caption>Example widget</caption>
+ *  <input type="text" id="username" value="Alice" />
+ *
+ * @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, Value, Target } from '@serenity-js/webdriverio';
+ *
+ *  const usernameField = () =>
+ *      Target.the('username field').located(by.id('username'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(Value.of(usernameField), equals('Alice')),
+ *      )
+ *
+ * @extends {@serenity-js/core/lib/screenplay~Question}
+ * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
+ */
+export declare class Value extends ElementQuestion<Promise<string>> implements MetaQuestion<Answerable<PageElement>, Promise<string>> {
+    private readonly element;
+    /**
+     * @param {Answerable<PageElement>} element
+     * @returns {Value}
+     */
+    static of(element: Answerable<PageElement>): Question<Promise<string>> & MetaQuestion<Answerable<PageElement>, Promise<string>>;
+    /**
+     * @param {Answerable<PageElement>} element
+     */
+    constructor(element: Answerable<PageElement>);
+    /**
+     * @desc
+     *  Resolves to the value of a given [`input`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input)
+     *  {@link WebElement}, located in the context of a `parent` element.
+     *
+     * @param {Answerable<PageElement>} parent
+     * @returns {Question<Promise<string>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    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}
+     */
+    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<string>;
+}

package/lib/screenplay/questions/Value.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Value = void 0;
+const io_1 = require("@serenity-js/core/lib/io");
+const models_1 = require("../models");
+const ElementQuestion_1 = require("./ElementQuestion");
+/**
+ * @desc
+ *  Returns the `value` attribute of a given {@link WebElement},
+ *  represented by Answerable<{@link @wdio/types~Element}>
+ *
+ * @example <caption>Example widget</caption>
+ *  <input type="text" id="username" value="Alice" />
+ *
+ * @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, Value, Target } from '@serenity-js/webdriverio';
+ *
+ *  const usernameField = () =>
+ *      Target.the('username field').located(by.id('username'))
+ *
+ *  actorCalled('Lisa')
+ *      .whoCan(BrowseTheWeb.using(browser))
+ *      .attemptsTo(
+ *          Ensure.that(Value.of(usernameField), equals('Alice')),
+ *      )
+ *
+ * @extends {@serenity-js/core/lib/screenplay~Question}
+ * @implements {@serenity-js/core/lib/screenplay/questions~MetaQuestion}
+ */
+class Value extends ElementQuestion_1.ElementQuestion {
+    /**
+     * @param {Answerable<PageElement>} element
+     */
+    constructor(element) {
+        super((0, io_1.formatted) `the value of ${element}`);
+        this.element = element;
+    }
+    /**
+     * @param {Answerable<PageElement>} element
+     * @returns {Value}
+     */
+    static of(element) {
+        return new Value(element);
+    }
+    /**
+     * @desc
+     *  Resolves to the value of a given [`input`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input)
+     *  {@link WebElement}, located in the context of a `parent` element.
+     *
+     * @param {Answerable<PageElement>} parent
+     * @returns {Question<Promise<string>>}
+     *
+     * @see {@link @serenity-js/core/lib/screenplay/questions~MetaQuestion}
+     */
+    of(parent) {
+        return new Value(models_1.PageElement.of(this.element, 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}
+     */
+    async answeredBy(actor) {
+        const element = await this.resolve(actor, this.element);
+        return element.value();
+    }
+}
+exports.Value = Value;
+//# sourceMappingURL=Value.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Value.js","sourceRoot":"","sources":["../../../src/screenplay/questions/Value.ts"],"names":[],"mappings":";;;AACA,iDAAqD;AAErD,sCAAwC;AACxC,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,KACT,SAAQ,iCAAgC;IAWxC;;OAEG;IACH,YAA6B,OAAgC;QACzD,KAAK,CAAC,IAAA,cAAS,EAAA,gBAAiB,OAAQ,EAAE,CAAC,CAAC;QADnB,YAAO,GAAP,OAAO,CAAyB;IAE7D,CAAC;IAbD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAgC;QACtC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IASD;;;;;;;;;OASG;IACH,EAAE,CAAC,MAA+B;QAC9B,OAAO,IAAI,KAAK,CAAC,oBAAW,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,UAAU,CAAC,KAAuC;QACpD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACJ;AAlDD,sBAkDC"}

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

@@ -0,0 +1,6 @@
+export * from './Attribute';
+export * from './CssClasses';
+export * from './LastScriptExecution';
+export * from './Selected';
+export * from './Text';
+export * from './Value';

package/lib/screenplay/questions/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Attribute"), exports);
+__exportStar(require("./CssClasses"), exports);
+__exportStar(require("./LastScriptExecution"), exports);
+__exportStar(require("./Selected"), exports);
+__exportStar(require("./Text"), exports);
+__exportStar(require("./Value"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/questions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,wDAAsC;AACtC,6CAA2B;AAC3B,yCAAuB;AACvB,0CAAwB"}

package/lib/stage/crew/index.d.ts

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

package/lib/stage/crew/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./photographer"), exports);
+//# sourceMappingURL=index.js.map

package/lib/stage/crew/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stage/crew/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAA+B"}