@serenity-js/web/lib/screenplay/interactions/DoubleClick.js

Serenity/JS Screenplay Pattern library offering a flexible, web driver-agnostic approach for interacting with web-based user interfaces and components, suitable for various testing contexts

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.DoubleClick = void 0;
const core_1 = require("@serenity-js/core");
const PageElementInteraction_1 = require("./PageElementInteraction");
/**
 * Instructs an [actor](https://serenity-js.org/api/core/class/Actor/) who has the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
 * to perform a double click on a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
 *
 * ## Example widget
 * ```html
 * <!--
 *     The editor shows up when the user double-clicks
 *     on one of the properties of their profile
 *     and lets them change the value of that property.
 * -->
 * <div id="user-profile">
 *     <ul>
 *         <li id="display-name" ondblclick="edit(this)">User12345</li>
 *         <li id="email-address" ondblclick="edit(this)">tester@example.org</li>
 *     </ul>
 *     <form id="editor" class="hidden">
 *         <input type="text" value="" />
 *     </form>
 * </div>
 * ```
 *
 * ## Lean Page Object describing the widget
 *
 * ```ts
 * import { By, PageElement } from '@serenity-js/web'
 *
 * class UserProfile {
 *   static displayName = () =>
 *     PageElement.located(By.id('display-name'))
 *       .describedAs('display name')
 *
 *   static emailAddress = () =>
 *     PageElement.located(By.id('email-address'))
 *       .describedAs('email address')
 *
 *   static editor = () =>
 *     PageElement.located(By.id('editor'))
 *       .describedAs('editor')
 * }
 * ```
 *
 * ## Double-clicking on an element
 * ```ts
 * import { actorCalled, Wait } from '@serenity-js/core'
 * import { DoubleClick, isVisible, Enter, Text } from '@serenity-js/web'
 * import { Ensure, equals, not } from '@serenity-js/assertions'
 *
 * await actorCalled('Dorothy')
 *   .whoCan(BrowseTheWeb.using(browser))
 *   .attemptsTo(
 *     DoubleClick.on(UserProfile.displayName),
 *     Wait.until(UserProfile.editor(), isVisible()),
 *
 *     Enter.theValue('New username').into(UserProfile.editor),
 *
 *     Ensure.that(Text.of(UserProfile.displayName()), equals('New username')),
 *     Ensure.that(UserProfile.editor, not(isVisible()))
 *   )
 * ```
 *
 * ## Learn more
 *
 * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
 * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
 *
 * @group Activities
 */
class DoubleClick extends PageElementInteraction_1.PageElementInteraction {
    pageElement;
    /**
     * Instantiates this [`Interaction`](https://serenity-js.org/api/core/class/Interaction/).
     *
     * @param pageElement
     *  The element to be double-clicked on
     */
    static on(pageElement) {
        return new DoubleClick(pageElement);
    }
    constructor(pageElement) {
        super((0, core_1.the) `#actor double-clicks on ${pageElement}`);
        this.pageElement = pageElement;
    }
    /**
     * @inheritDoc
     */
    async performAs(actor) {
        const element = await this.resolve(actor, this.pageElement);
        await element.scrollIntoView();
        await element.doubleClick();
    }
}
exports.DoubleClick = DoubleClick;
//# sourceMappingURL=DoubleClick.js.map