@serenity-js/web 3.41.2 → 3.42.0

package/esm/screenplay/models/Page.js

@@ -0,0 +1,252 @@
+import { ExpectationMet, LogicError, Question } from '@serenity-js/core';
+import { ensure, isDefined } from 'tiny-types';
+import { BrowseTheWeb } from '../abilities/index.js';
+/**
+ * Serenity/JS Screenplay Pattern-style model that enables interactions with a Web page
+ * rendered in a Web browser tab.
+ *
+ * ## Referring to the current page
+ *
+ * ```ts
+ * import { Ensure, endsWith } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Navigate, Page } from '@serenity-js/web'
+ *
+ * await actorCalled('Serena').attemptsTo(
+ *   Navigate.to('https://serenity-js.org'),
+ *   Ensure.that(Page.current().title(), endsWith('Serenity/JS')),
+ * )
+ * ```
+ *
+ * ## Switching to another open page
+ *
+ * ```ts
+ * import { Ensure, equals, includes, startsWith } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Navigate, Page, Switch, Text } from '@serenity-js/web'
+ *
+ * const Navigation = {
+ *   linkTo = (name: Answerable<string>) =>
+ *     PageElements.located(By.css('nav a'))
+ *       .where(Text, includes(name))
+ *       .first()
+ * }
+ *
+ * await actorCalled('Serena').attemptsTo(
+ *   Navigate.to('https://serenity-js.org'),
+ *   Click.on(Navigation.linkTo('GitHub')),
+ *
+ *   Switch.to(Page.whichUrl(startsWith('https://github.com')))
+ *
+ *   Ensure.that(
+ *     Page.current().url().href,
+ *     equals('https://github.com/serenity-js/serenity-js')
+ *   ),
+ * )
+ * ```
+ *
+ * ## Retrieving information about another open page
+ *
+ * You can retrieve information about another open page without having to explicitly switch to it:
+ *
+ * ```ts
+ * import { Ensure, equals, includes, startsWith } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Navigate, Page, Text } from '@serenity-js/web'
+ *
+ * const Navigation = {
+ *   linkTo = (name: Answerable<string>) =>
+ *     PageElements.located(By.css('nav a'))
+ *       .where(Text, includes(name))
+ *       .first()
+ * }
+ *
+ * await actorCalled('Serena').attemptsTo(
+ *   Navigate.to('https://serenity-js.org'),
+ *   Click.on(Navigation.linkTo('GitHub')),
+ *   Ensure.that(
+ *     Page.whichUrl(startsWith('https://github.com')).url().href,
+ *     equals('https://github.com/serenity-js/serenity-js')
+ *   ),
+ * )
+ * ```
+ *
+ * ## Performing activities in the context of another page
+ *
+ * ```ts
+ * import { Ensure, equals, includes, startsWith } from '@serenity-js/assertions'
+ * import { actorCalled } from '@serenity-js/core'
+ * import { Navigate, Page, Text } from '@serenity-js/web'
+ *
+ * const Navigation = {
+ *   linkTo = (name: Answerable<string>) =>
+ *     PageElements.located(By.css('nav a'))
+ *       .where(Text, includes(name))
+ *       .first()
+ * }
+ *
+ * await actorCalled('Serena').attemptsTo(
+ *
+ *   // Serenity/JS GitHub repository opens in a new browser tab
+ *   Navigate.to('https://serenity-js.org'),
+ *   Click.on(Navigation.linkTo('GitHub')),
+ *
+ *   // Switch to the newly opened page and perform an assertion
+ *   Switch.to(Page.whichUrl(startsWith('https://github.com')))
+ *     .and(
+ *       Ensure.that(
+ *         Page.current().url().href,
+ *         equals('https://github.com/serenity-js/serenity-js')
+ *       )
+ *     ),
+ *   // Automatically switch back to the original page
+ *
+ *   Ensure.that(Page.current().url().href, equals('https://serenity-js.org'),
+ * )
+ * ```
+ *
+ * ## Learn more
+ *
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+ *
+ * @group Models
+ */
+export class Page {
+    session;
+    rootLocator;
+    modalDialogHandler;
+    id;
+    /**
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) representing the currently active [`Page`](https://serenity-js.org/api/web/class/Page/).
+     */
+    static current() {
+        return Question.about('current page', actor => {
+            return BrowseTheWeb.as(actor).currentPage();
+        });
+    }
+    /**
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.name`](https://serenity-js.org/api/web/class/Page/#name)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
+     *
+     * #### Switching to a page with the desired name
+     *
+     * ```ts
+     * import { includes } from '@serenity-js/assertions'
+     * import { actorCalled } from '@serenity-js/core'
+     * import { Switch } from '@serenity-js/web'
+     *
+     * actorCalled('Bernie').attemptsTo(
+     *   Switch.to(Page.whichName(includes(`photo-gallery`))),
+     * )
+     * ```
+     *
+     * @param expectation
+     */
+    static whichName(expectation) {
+        return Question.about(`page which name does ${expectation}`, async (actor) => {
+            const pages = await BrowseTheWeb.as(actor).allPages();
+            return Page.findMatchingPage(`name does ${expectation}`, pages, page => actor.answer(expectation.isMetFor(page.name())));
+        });
+    }
+    /**
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.title`](https://serenity-js.org/api/web/class/Page/#title)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
+     *
+     * #### Switching to a page with the desired title
+     *
+     * ```ts
+     * import { includes } from '@serenity-js/assertions'
+     * import { actorCalled } from '@serenity-js/core'
+     * import { Switch } from '@serenity-js/web'
+     *
+     * actorCalled('Bernie').attemptsTo(
+     *   Switch.to(Page.whichTitle(includes(`Summer collection`))),
+     * )
+     * ```
+     *
+     * @param expectation
+     */
+    static whichTitle(expectation) {
+        return Question.about(`page which title does ${expectation}`, async (actor) => {
+            const pages = await BrowseTheWeb.as(actor).allPages();
+            return Page.findMatchingPage(`title does ${expectation}`, pages, page => actor.answer(expectation.isMetFor(page.title())));
+        });
+    }
+    /**
+     * Creates a [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter) that resolves to a [`Page`](https://serenity-js.org/api/web/class/Page/) which [`Page.url`](https://serenity-js.org/api/web/class/Page/#url)
+     * meets the [expectation](https://serenity-js.org/api/core/class/Expectation/).
+     *
+     * #### Switching to a page with the desired URL
+     *
+     * ```ts
+     * import { endsWith } from '@serenity-js/assertions'
+     * import { actorCalled } from '@serenity-js/core'
+     * import { Switch } from '@serenity-js/web'
+     *
+     * actorCalled('Bernie').attemptsTo(
+     *   Switch.to(Page.whichUrl(endsWith(`/gallery.html`))),
+     * )
+     * ```
+     *
+     * @param expectation
+     */
+    static whichUrl(expectation) {
+        return Question.about(`page which URL does ${expectation}`, async (actor) => {
+            const pages = await BrowseTheWeb.as(actor).allPages();
+            return Page.findMatchingPage(`url does ${expectation}`, pages, page => actor.answer(expectation.isMetFor(page.url().then(url => url.toString()))));
+        });
+    }
+    static async findMatchingPage(expectationDescription, pages, matcher) {
+        for (const page of pages) {
+            const outcome = await matcher(page);
+            if (outcome instanceof ExpectationMet) {
+                return page;
+            }
+        }
+        throw new LogicError(`Couldn't find a page which ${expectationDescription}`);
+    }
+    constructor(session, rootLocator, modalDialogHandler, id) {
+        this.session = session;
+        this.rootLocator = rootLocator;
+        this.modalDialogHandler = modalDialogHandler;
+        this.id = id;
+        ensure('session', session, isDefined());
+        ensure('rootLocator', rootLocator, isDefined());
+        ensure('modalDialogHandler', modalDialogHandler, isDefined());
+        ensure('id', id, isDefined());
+    }
+    /**
+     * Switches the current browsing context to the given page
+     * and returns an object that allows the caller to switch back
+     * to the previous context when needed.
+     *
+     * ## Learn more
+     * - [`Switch`](https://serenity-js.org/api/web/class/Switch/)
+     * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+     */
+    async switchTo() {
+        const originalPage = await this.session.currentPage();
+        await this.session.changeCurrentPageTo(this);
+        return {
+            switchBack: async () => {
+                await this.session.changeCurrentPageTo(originalPage);
+            }
+        };
+    }
+    /**
+     * Returns the [`ModalDialogHandler`](https://serenity-js.org/api/web/class/ModalDialogHandler/) for the current [`Page`](https://serenity-js.org/api/web/class/Page/).
+     */
+    modalDialog() {
+        return this.modalDialogHandler;
+    }
+    /**
+     * Returns a description of this Page and its ID.
+     */
+    toString() {
+        return `page (id=${this.id.value})`;
+    }
+}
+//# sourceMappingURL=Page.js.map

package/esm/screenplay/models/Page.js.map

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

package/esm/screenplay/models/PageElement.d.ts

@@ -0,0 +1,207 @@
+import type { Answerable, MetaQuestion, MetaQuestionAdapter, Optional, QuestionAdapter } from '@serenity-js/core';
+import type { Locator } from './Locator.js';
+import type { SelectOption } from './SelectOption.js';
+import type { Selector } from './selectors/index.js';
+import type { Switchable } from './Switchable.js';
+import type { SwitchableOrigin } from './SwitchableOrigin.js';
+/**
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to identify
+ * a single Web element located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
+ *
+ * ## Learn more
+ * - [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language)
+ * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+ *
+ * @group Models
+ */
+export declare abstract class PageElement<Native_Element_Type = any> implements Optional, Switchable {
+    readonly locator: Locator<Native_Element_Type>;
+    static from<NET>(nativeElement: NET): MetaQuestionAdapter<PageElement<NET>, PageElement<NET>>;
+    static located<NET>(selector: Answerable<Selector>): MetaQuestionAdapter<PageElement<NET>, PageElement<NET>>;
+    static of<NET>(childElement: MetaQuestionAdapter<PageElement<NET>, PageElement<NET>> | PageElement<NET>, parentElement: Answerable<PageElement<NET>>): MetaQuestionAdapter<PageElement<NET>, PageElement<NET>>;
+    /**
+     * A static method producing a [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/) that can be used with [`PageElements.eachMappedTo`](https://serenity-js.org/api/web/class/PageElements/#eachMappedTo) method
+     * to extract the HTML of each element in a collection.
+     *
+     * #### Example
+     *
+     * ```typescript
+     * import { actorCalled, Log } from '@serenity-js/core'
+     * import { Navigate, PageElement, By, Text } from '@serenity-js/web'
+     * import { includes } from '@serenity-js/assertions'
+     *
+     * await actorCalled('Debbie').attemptsTo(
+     *   Navigate.to('https://serenity-js.org'),
+     *
+     *   Log.the(
+     *     PageElements.located(By.css('a'))
+     *       .where(Text, includes('modular'))
+     *       .eachMappedTo(PageElement.html())
+     *   ),
+     * )
+     * ```
+     */
+    static html<NET>(): MetaQuestion<PageElement<NET>, QuestionAdapter<string>>;
+    constructor(locator: Locator<Native_Element_Type>);
+    /**
+     * Locates a child element that:
+     * - matches the given selector
+     * - is located within the `parentElement`
+     *
+     * @param parentElement
+     */
+    abstract of(parentElement: PageElement<Native_Element_Type>): PageElement<Native_Element_Type>;
+    /**
+     * Traverses the element and its parents, heading toward the document root,
+     * until it finds a parent [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) that matches its associated CSS selector.
+     *
+     * #### Example
+     *
+     * ```html
+     * <div class="form-entry">
+     *     <input id="username" />
+     *     <ul class="warnings">
+     *         <li>Username should be an email address</li>
+     *     </ul>
+     * </div>
+     * ```
+     *
+     * ```typescript
+     * class Username {
+     *   static field = () =>
+     *     PageElement.located(By.id('username'))
+     *       .describedAs('username field')
+     *
+     *   private static container = () =>
+     *     PageElement.located(By.css('.form-entry'))
+     *       .describedAs('form entry container')
+     *
+     *   static warnings = () =>
+     *     PageElements.located(By.css('ul.warnings li'))
+     *       .describedAs('warnings')
+     *       .of(
+     *         Username.container().closestTo(Username.field())
+     *       )
+     * }
+     * ```
+     *
+     * :::info
+     * This method relies on [Element: closest() API](https://developer.mozilla.org/en-US/docs/Web/API/Element/closest),
+     * and so is only compatible with locating parent elements specified using the following CSS selectors:
+     * - [`ByCss`](https://serenity-js.org/api/web/class/ByCss/)
+     * - [`ById`](https://serenity-js.org/api/web/class/ById/)
+     * - [`ByTagName`](https://serenity-js.org/api/web/class/ByTagName/)
+     * :::
+     *
+     * @param childElement
+     * @returns
+     *
+     * #### Learn more
+     * - [Element: closest() method](https://developer.mozilla.org/en-US/docs/Web/API/Element/closest)
+     */
+    abstract closestTo(childElement: PageElement<Native_Element_Type>): PageElement<Native_Element_Type>;
+    /**
+     * An "escape hatch" providing access to the integration tool-specific implementation of a Web element.
+     */
+    nativeElement(): Promise<Native_Element_Type>;
+    toString(): string;
+    abstract enterValue(value: string | number | Array<string | number>): Promise<void>;
+    abstract clearValue(): Promise<void>;
+    abstract click(): Promise<void>;
+    abstract doubleClick(): Promise<void>;
+    abstract scrollIntoView(): Promise<void>;
+    abstract hoverOver(): Promise<void>;
+    abstract rightClick(): Promise<void>;
+    abstract selectOptions(...options: Array<SelectOption>): Promise<void>;
+    abstract selectedOptions(): Promise<Array<SelectOption>>;
+    /**
+     * Drags this element and drops it on the `destination` element.
+     *
+     * @param destination
+     *  The element to drop this element on
+     */
+    abstract dragTo(destination: PageElement<Native_Element_Type>): Promise<void>;
+    abstract attribute(name: string): Promise<string>;
+    abstract text(): Promise<string>;
+    abstract value(): Promise<string>;
+    /**
+     * An instance method that resolves to the value of the [`outerHTML`](https://developer.mozilla.org/en-US/docs/Web/API/Element/outerHTML) property
+     * of the underlying element.
+     *
+     * #### Example
+     *
+     * ```typescript
+     * import { actorCalled, Log } from '@serenity-js/core'
+     * import { Navigate, PageElement, By } from '@serenity-js/web'
+     *
+     * await actorCalled('Debbie').attemptsTo(
+     *   Navigate.to('https://serenity-js.org'),
+     *
+     *   Log.the(
+     *     PageElement.located(By.css('h1')).html()
+     *   ),
+     * )
+     * ```
+     */
+    abstract html(): Promise<string>;
+    /**
+     * When the element represents an [`iframe`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe),
+     * calling this method switches the current browsing context to the given `iframe` context.
+     *
+     * When used with other types of [Web `Element`](https://developer.mozilla.org/en-US/docs/Web/API/Element),
+     * calling this method will have the same result as calling [`Element.focus()`](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event).
+     *
+     * @returns
+     *  Returns an object that allows the caller to switch back
+     *  to the previous context if needed.
+     *
+     * #### Learn more
+     * - [`Switch`](https://serenity-js.org/api/web/class/Switch/)
+     * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+     */
+    abstract switchTo(): Promise<SwitchableOrigin>;
+    /**
+     * Resolves to `true` when the underlying element [has focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus).
+     * Otherwise, resolves to `false`.
+     */
+    abstract isActive(): Promise<boolean>;
+    /**
+     * Resolves to `true` when the underlying element can be clicked on.
+     * Otherwise, resolves to `false`.
+     *
+     * Please refer to test integration tool-specific documentation for details.
+     */
+    abstract isClickable(): Promise<boolean>;
+    /**
+     * Resolves to `true` when the underlying
+     * element is not [explicitly disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)
+     *
+     * Please refer to test integration tool-specific documentation for details.
+     */
+    abstract isEnabled(): Promise<boolean>;
+    /**
+     * Returns a [`Promise`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that resolves to `true` when the element
+     * is present in the [Document Object Model (DOM)](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model),
+     * `false` otherwise.
+     */
+    isPresent(): Promise<boolean>;
+    /**
+     * Resolves to `true` when the underlying element:
+     * - has a [`selected` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option#attr-selected) for `<option />` elements
+     * - has a [`checked`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox) attribute for checkboxes
+     *
+     * Otherwise, resolves to `false`.
+     */
+    abstract isSelected(): Promise<boolean>;
+    /**
+     * Resolves to `true` when the underlying element:
+     * - is not hidden, so doesn't have CSS style like `display: none`, `visibility: hidden` or `opacity: 0`
+     * - is within the browser viewport
+     * - doesn't have its centre covered by other elements
+     *
+     * Otherwise, resolves to `false`.
+     */
+    abstract isVisible(): Promise<boolean>;
+}
+//# sourceMappingURL=PageElement.d.ts.map

package/esm/screenplay/models/PageElement.d.ts.map

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

package/esm/screenplay/models/PageElement.js

@@ -0,0 +1,89 @@
+import { Question, the } from '@serenity-js/core';
+import { ensure, isDefined } from 'tiny-types';
+import { BrowseTheWeb } from '../abilities/index.js';
+/**
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to identify
+ * a single Web element located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
+ *
+ * ## Learn more
+ * - [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language)
+ * - [`Optional`](https://serenity-js.org/api/core/interface/Optional/)
+ * - [`Switchable`](https://serenity-js.org/api/web/interface/Switchable/)
+ *
+ * @group Models
+ */
+export class PageElement {
+    locator;
+    static from(nativeElement) {
+        return Question.about(`native page element`, async (actor) => {
+            const currentPage = await BrowseTheWeb.as(actor).currentPage();
+            return currentPage.createPageElement(nativeElement);
+        });
+    }
+    static located(selector) {
+        return Question.about(the `page element located ${selector}`, async (actor) => {
+            const bySelector = await actor.answer(selector);
+            const currentPage = await BrowseTheWeb.as(actor).currentPage();
+            return currentPage.locate(bySelector);
+        });
+    }
+    static of(childElement, parentElement) {
+        return Question.about(the `${childElement} of ${parentElement}`, async (actor) => {
+            const parent = await actor.answer(parentElement);
+            const child = childElement.of(parent);
+            return actor.answer(child);
+        });
+    }
+    /**
+     * A static method producing a [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/) that can be used with [`PageElements.eachMappedTo`](https://serenity-js.org/api/web/class/PageElements/#eachMappedTo) method
+     * to extract the HTML of each element in a collection.
+     *
+     * #### Example
+     *
+     * ```typescript
+     * import { actorCalled, Log } from '@serenity-js/core'
+     * import { Navigate, PageElement, By, Text } from '@serenity-js/web'
+     * import { includes } from '@serenity-js/assertions'
+     *
+     * await actorCalled('Debbie').attemptsTo(
+     *   Navigate.to('https://serenity-js.org'),
+     *
+     *   Log.the(
+     *     PageElements.located(By.css('a'))
+     *       .where(Text, includes('modular'))
+     *       .eachMappedTo(PageElement.html())
+     *   ),
+     * )
+     * ```
+     */
+    static html() {
+        return {
+            of: (pageElement) => Question.about(`outer HTML of ${pageElement}`, async (actor) => {
+                const element = await actor.answer(pageElement);
+                return element.html();
+            })
+        };
+    }
+    constructor(locator) {
+        this.locator = locator;
+        ensure('native element locator', locator, isDefined());
+    }
+    /**
+     * An "escape hatch" providing access to the integration tool-specific implementation of a Web element.
+     */
+    async nativeElement() {
+        return this.locator.nativeElement();
+    }
+    toString() {
+        return `PageElement located ${this.locator.toString()}`;
+    }
+    /**
+     * Returns a [`Promise`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that resolves to `true` when the element
+     * is present in the [Document Object Model (DOM)](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model),
+     * `false` otherwise.
+     */
+    async isPresent() {
+        return this.locator.isPresent();
+    }
+}
+//# sourceMappingURL=PageElement.js.map

package/esm/screenplay/models/PageElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageElement.js","sourceRoot":"","sources":["../../../src/screenplay/models/PageElement.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAOrD;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,WAAW;IA+DD;IA7D5B,MAAM,CAAC,IAAI,CAAM,aAAkB;QAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACvD,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,EAAE,CAAoB,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAElF,OAAO,WAAW,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,OAAO,CAAM,QAA8B;QAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAA,wBAAyB,QAAS,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACzE,MAAM,UAAU,GAAI,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,EAAE,CAAoB,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAElF,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,EAAE,CACL,YAAwF,EACxF,aAA2C;QAE3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAA,GAAI,YAAa,OAAQ,aAAc,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YAC9E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;YAErC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,IAAI;QACP,OAAO;YACH,EAAE,EAAE,CAAC,WAAyC,EAAE,EAAE,CAC9C,QAAQ,CAAC,KAAK,CAAC,iBAAiB,WAAW,EAAE,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;gBACzD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAChD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;YAC1B,CAAC,CAAC;SACT,CAAA;IACL,CAAC;IAED,YAA4B,OAAqC;QAArC,YAAO,GAAP,OAAO,CAA8B;QAC7D,MAAM,CAAC,wBAAwB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;IA6DD;;OAEG;IACH,KAAK,CAAC,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,QAAQ;QACJ,OAAO,uBAAwB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAG,EAAE,CAAC;IAC9D,CAAC;IAoFD;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IACpC,CAAC;CAoBJ"}

package/esm/screenplay/models/PageElements.d.ts

@@ -0,0 +1,21 @@
+import type { Answerable } from '@serenity-js/core';
+import { MetaList } from '@serenity-js/core';
+import type { PageElement } from './PageElement.js';
+import type { Selector } from './selectors/index.js';
+/**
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to identify
+ * a group of Web elements located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
+ *
+ * ## Learn more
+ *
+ * - [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)}
+ * - [`List`](https://serenity-js.org/api/core/class/List/)
+ * - [`ChainableMetaQuestion`](https://serenity-js.org/api/core/interface/ChainableMetaQuestion/)
+ *
+ * @group Models
+ */
+export declare class PageElements<Native_Element_Type = any> extends MetaList<PageElement<Native_Element_Type>, PageElement<Native_Element_Type>> {
+    static located<NET>(selector: Answerable<Selector>): PageElements;
+}
+//# sourceMappingURL=PageElements.d.ts.map

package/esm/screenplay/models/PageElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageElements.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PageElements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY,CAAC,mBAAmB,GAAG,GAAG,CAC/C,SAAQ,QAAQ,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAEpF,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,YAAY;CAGpE"}

package/esm/screenplay/models/PageElements.js

@@ -0,0 +1,21 @@
+import { MetaList } from '@serenity-js/core';
+import { PageElementsLocator } from './PageElementsLocator.js';
+/**
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to identify
+ * a group of Web elements located by [`Selector`](https://serenity-js.org/api/web/class/Selector/).
+ *
+ * ## Learn more
+ *
+ * - [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language)
+ * - [`Actor`](https://serenity-js.org/api/core/class/Actor/)}
+ * - [`List`](https://serenity-js.org/api/core/class/List/)
+ * - [`ChainableMetaQuestion`](https://serenity-js.org/api/core/interface/ChainableMetaQuestion/)
+ *
+ * @group Models
+ */
+export class PageElements extends MetaList {
+    static located(selector) {
+        return new PageElements(PageElementsLocator.fromDocumentRoot(selector));
+    }
+}
+//# sourceMappingURL=PageElements.js.map

package/esm/screenplay/models/PageElements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageElements.js","sourceRoot":"","sources":["../../../src/screenplay/models/PageElements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YACT,SAAQ,QAA4E;IAEpF,MAAM,CAAC,OAAO,CAAM,QAA8B;QAC9C,OAAO,IAAI,YAAY,CAAC,mBAAmB,CAAC,gBAAgB,CAAM,QAAQ,CAAC,CAAC,CAAC;IACjF,CAAC;CACJ"}

package/esm/screenplay/models/PageElementsLocator.d.ts

@@ -0,0 +1,16 @@
+import type { Answerable, AnswersQuestions, ChainableMetaQuestion, UsesAbilities } from '@serenity-js/core';
+import { Question } from '@serenity-js/core';
+import type { Locator } from './Locator.js';
+import type { PageElement } from './PageElement.js';
+import type { Selector } from './selectors/index.js';
+/**
+ * @group Models
+ */
+export declare class PageElementsLocator<Native_Element_Type = any> extends Question<Promise<Array<PageElement<Native_Element_Type>>>> implements ChainableMetaQuestion<PageElement<Native_Element_Type>, Question<Promise<Array<PageElement<Native_Element_Type>>>>> {
+    private readonly locator;
+    static fromDocumentRoot<NET>(selector: Answerable<Selector>): PageElementsLocator<NET>;
+    constructor(locator: Answerable<Locator<Native_Element_Type>>);
+    of(parent: Answerable<PageElement<Native_Element_Type>>): Question<Promise<Array<PageElement<Native_Element_Type>>>> & ChainableMetaQuestion<PageElement<Native_Element_Type>, Question<Promise<Array<PageElement<Native_Element_Type>>>>>;
+    answeredBy(actor: AnswersQuestions & UsesAbilities): Promise<Array<PageElement<Native_Element_Type>>>;
+}
+//# sourceMappingURL=PageElementsLocator.d.ts.map

package/esm/screenplay/models/PageElementsLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageElementsLocator.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PageElementsLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5G,OAAO,EAAE,QAAQ,EAAO,MAAM,mBAAmB,CAAC;AAGlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,qBAAa,mBAAmB,CAAC,mBAAmB,GAAG,GAAG,CACtD,SAAQ,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CACjE,YAAW,qBAAqB,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAalH,OAAO,CAAC,QAAQ,CAAC,OAAO;IAXpC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC;gBAWzD,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAI9E,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,WAAW,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAWpO,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC;CAI9G"}