@serenity-js/playwright 3.41.2 → 3.42.1

package/esm/screenplay/models/PlaywrightPageElement.js

@@ -0,0 +1,198 @@
+import { LogicError } from '@serenity-js/core';
+import { PageElement, SelectOption } from '@serenity-js/web';
+import * as scripts from '@serenity-js/web/scripts';
+import { ensure, isDefined } from 'tiny-types';
+/**
+ * Playwright-specific implementation of [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
+ *
+ * @group Models
+ */
+export class PlaywrightPageElement extends PageElement {
+    of(parent) {
+        return new PlaywrightPageElement(this.locator.of(parent.locator));
+    }
+    closestTo(child) {
+        return new PlaywrightPageElement(this.locator.closestTo(child.locator));
+    }
+    async enterValue(value) {
+        const text = [].concat(value).join('');
+        const element = await this.nativeElement();
+        return element.fill(text);
+    }
+    async clearValue() {
+        try {
+            const element = await this.nativeElement();
+            await element.fill('');
+        }
+        catch (error) {
+            throw new LogicError(`The input field doesn't seem to have a 'value' attribute that could be cleared`, error);
+        }
+    }
+    async click() {
+        const element = await this.nativeElement();
+        return element.click();
+    }
+    async doubleClick() {
+        const element = await this.nativeElement();
+        return element.dblclick();
+    }
+    async scrollIntoView() {
+        const element = await this.nativeElement();
+        return element.scrollIntoViewIfNeeded();
+    }
+    async hoverOver() {
+        const element = await this.nativeElement();
+        return element.hover();
+    }
+    async rightClick() {
+        const element = await this.nativeElement();
+        return element.click({ button: 'right' });
+    }
+    async selectOptions(...options) {
+        const element = await this.nativeElement();
+        const optionsToSelect = options.map(option => ({
+            value: option.value,
+            label: option.label,
+        }));
+        await element.selectOption(optionsToSelect);
+    }
+    async selectedOptions() {
+        const element = await this.nativeElement();
+        /* c8 ignore start */
+        const options = await element.locator('option').evaluateAll((optionNodes) => optionNodes.map((optionNode) => {
+            return {
+                selected: optionNode.selected,
+                disabled: optionNode.disabled,
+                label: optionNode.label,
+                value: optionNode.value,
+            };
+        }));
+        /* c8 ignore stop */
+        return options.map(option => new SelectOption(option.label, option.value, option.selected, option.disabled));
+    }
+    async dragTo(destination) {
+        const elementBeingDragged = await this.nativeElement();
+        const destinationElement = await destination.nativeElement();
+        // Use force: true to bypass actionability checks on the target element.
+        // This is necessary for drop zones that dynamically enable pointer-events
+        // only when a drag operation is in progress.
+        await elementBeingDragged.dragTo(destinationElement, { force: true });
+    }
+    async attribute(name) {
+        const element = await this.nativeElement();
+        return element.getAttribute(name);
+    }
+    async text() {
+        const element = await this.nativeElement();
+        return element.innerText();
+    }
+    async value() {
+        const element = await this.nativeElement();
+        return element.inputValue();
+    }
+    async html() {
+        const element = await this.nativeElement();
+        return element.evaluate(nativeElement => nativeElement.outerHTML);
+    }
+    async switchTo() {
+        try {
+            const nativeLocator = await this.nativeElement();
+            const element = await nativeLocator.elementHandle();
+            const frame = await element.contentFrame();
+            if (frame) {
+                const locator = this.locator;
+                await locator.switchToFrame(nativeLocator);
+                return {
+                    switchBack: async () => {
+                        await locator.switchToParentFrame();
+                    }
+                };
+            }
+            /* c8 ignore start */
+            const previouslyFocusedElement = await nativeLocator.evaluateHandle((domNode) => {
+                const currentlyFocusedElement = document.activeElement;
+                domNode.focus();
+                return currentlyFocusedElement;
+            });
+            /* c8 ignore stop */
+            return new PreviouslyFocusedElementSwitcher(previouslyFocusedElement);
+        }
+        catch (error) {
+            throw new LogicError(`Couldn't switch to page element located ${this.locator}`, error);
+        }
+    }
+    async isActive() {
+        try {
+            const element = await this.nativeElement();
+            return element.evaluate(domNode => domNode === document.activeElement);
+        }
+        catch {
+            return false;
+        }
+    }
+    async isClickable() {
+        try {
+            const element = await this.nativeElement();
+            await element.click({ trial: true });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isEnabled() {
+        try {
+            const element = await this.nativeElement();
+            return element.isEnabled();
+        }
+        catch {
+            return false;
+        }
+    }
+    async isSelected() {
+        try {
+            const element = await this.nativeElement();
+            // works for <option />
+            const selected = await element.getAttribute('selected');
+            if (selected !== null) {
+                return true;
+            }
+            // works only for checkboxes and radio buttons, throws for other elements
+            return await element.isChecked();
+        }
+        catch {
+            return false;
+        }
+    }
+    async isVisible() {
+        try {
+            const element = await this.nativeElement();
+            const isVisible = await element.isVisible();
+            if (!isVisible) {
+                return false;
+            }
+            return await element.evaluate(scripts.isVisible);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * @private
+ */
+class PreviouslyFocusedElementSwitcher {
+    node;
+    constructor(node) {
+        this.node = node;
+        ensure('DOM element', node, isDefined());
+    }
+    async switchBack() {
+        /* c8 ignore start */
+        await this.node.evaluate((domNode) => {
+            domNode.focus();
+        }, this.node);
+        /* c8 ignore stop */
+    }
+}
+//# sourceMappingURL=PlaywrightPageElement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightPageElement.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightPageElement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAA+B;IACtE,EAAE,CAAC,MAAuC;QACtC,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,SAAS,CAAC,KAAsC;QAC5C,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAA+C;QAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAM,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,UAAU,CAAC,gFAAgF,EAAE,KAAK,CAAC,CAAC;QAClH,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW;QACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,cAAc;QAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,SAAS;QACX,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAG,OAA4B;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3C,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CACzC,CAAC;YACG,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;SACtB,CAAC,CACL,CAAC;QAEF,MAAM,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,eAAe;QACjB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3C,qBAAqB;QACrB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CACvD,CAAC,WAAqC,EAAE,EAAE,CACtC,WAAW,CAAC,GAAG,CAAC,CAAC,UAA6B,EAAE,EAAE;YAC9C,OAAO;gBACH,QAAQ,EAAI,UAAU,CAAC,QAAQ;gBAC/B,QAAQ,EAAI,UAAU,CAAC,QAAQ;gBAC/B,KAAK,EAAO,UAAU,CAAC,KAAK;gBAC5B,KAAK,EAAO,UAAU,CAAC,KAAK;aAC/B,CAAA;QACL,CAAC,CAAC,CACT,CAAC;QACF,oBAAoB;QAEpB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CACxB,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CACjF,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,WAA4C;QACrD,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM,kBAAkB,GAAG,MAAM,WAAW,CAAC,aAAa,EAAE,CAAC;QAE7D,wEAAwE;QACxE,0EAA0E;QAC1E,6CAA6C;QAC7C,MAAM,mBAAmB,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,IAAI,CAAC;YACD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC;YAEpD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAE3C,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,OAAO,GAAI,IAAI,CAAC,OAA6B,CAAC;gBAEpD,MAAM,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;gBAE3C,OAAO;oBACH,UAAU,EAAE,KAAK,IAAmB,EAAE;wBAClC,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC;oBACxC,CAAC;iBACJ,CAAA;YACL,CAAC;YAED,qBAAqB;YACrB,MAAM,wBAAwB,GAAG,MAAM,aAAa,CAAC,cAAc,CAC/D,CAAC,OAAoB,EAAE,EAAE;gBACrB,MAAM,uBAAuB,GAAG,QAAQ,CAAC,aAAa,CAAC;gBACvD,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,OAAO,uBAAuB,CAAC;YACnC,CAAC,CACJ,CAAC;YACF,oBAAoB;YAEpB,OAAO,IAAI,gCAAgC,CAAC,wBAAwB,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAM,KAAK,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAAC,2CAA4C,IAAI,CAAC,OAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC,QAAQ,CACnB,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC,aAAa,CAChD,CAAC;QACN,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW;QACb,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAErC,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS;QACX,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,OAAO,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU;QAEZ,IAAI,CAAC;YACD,MAAM,OAAO,GAAuB,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAE/D,uBAAuB;YACvB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,yEAAyE;YACzE,OAAO,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS;QACX,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAE3C,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,CAAE,SAAS,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,gCAAgC;IACL;IAA7B,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QAClD,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,qBAAqB;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CACpB,CAAC,OAAoB,EAAE,EAAE;YACrB,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EACD,IAAI,CAAC,IAAI,CACZ,CAAC;QACF,oBAAoB;IACxB,CAAC;CACJ"}

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

@@ -0,0 +1,8 @@
+export * from './locators/index.js';
+export * from './PlaywrightBrowsingSession.js';
+export * from './PlaywrightBrowsingSessionWithBrowser.js';
+export * from './PlaywrightBrowsingSessionWithPage.js';
+export * from './PlaywrightCookie.js';
+export * from './PlaywrightPage.js';
+export * from './PlaywrightPageElement.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/esm/screenplay/models/index.js

@@ -0,0 +1,8 @@
+export * from './locators/index.js';
+export * from './PlaywrightBrowsingSession.js';
+export * from './PlaywrightBrowsingSessionWithBrowser.js';
+export * from './PlaywrightBrowsingSessionWithPage.js';
+export * from './PlaywrightCookie.js';
+export * from './PlaywrightPage.js';
+export * from './PlaywrightPageElement.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/esm/screenplay/models/locators/PlaywrightLocator.d.ts

@@ -0,0 +1,31 @@
+import type { PageElement, RootLocator, Selector } from '@serenity-js/web';
+import { Locator } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+import type { PlaywrightRootLocator } from './PlaywrightRootLocator.js';
+/**
+ * Playwright-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
+ *
+ * @group Models
+ */
+export declare class PlaywrightLocator extends Locator<playwright.Locator, string> {
+    constructor(parent: RootLocator<playwright.Locator>, selector: Selector);
+    protected nativeSelector(): string;
+    isPresent(): Promise<boolean>;
+    nativeElement(): Promise<playwright.Locator>;
+    allNativeElements(): Promise<Array<playwright.Locator>>;
+    of(parent: PlaywrightRootLocator): Locator<playwright.Locator, string>;
+    closestTo(child: PlaywrightLocator): Locator<playwright.Locator, string>;
+    locate(child: PlaywrightLocator): Locator<playwright.Locator, string>;
+    element(): PageElement<playwright.Locator>;
+    allElements(): Promise<Array<PageElement<playwright.Locator>>>;
+}
+/**
+ * @internal
+ */
+export declare class PlaywrightExistingElementLocator extends PlaywrightLocator {
+    private readonly existingNativeElement;
+    constructor(parent: RootLocator<playwright.Locator>, selector: Selector, existingNativeElement: playwright.Locator);
+    nativeElement(): Promise<playwright.Locator>;
+    allNativeElements(): Promise<Array<playwright.Locator>>;
+}
+//# sourceMappingURL=PlaywrightLocator.d.ts.map

package/esm/screenplay/models/locators/PlaywrightLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightLocator.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/PlaywrightLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAA2E,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAKnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;gBAGlE,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EACvC,QAAQ,EAAE,QAAQ;IAMtB,SAAS,CAAC,cAAc,IAAI,MAAM;IAgC5B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAsB7B,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAM5C,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAU7D,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;IAItE,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;IAIxE,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;IAIrE,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC;IAIpC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;CAavE;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,iBAAiB;IAI/D,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAFtC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EACvC,QAAQ,EAAE,QAAQ,EACD,qBAAqB,EAAE,UAAU,CAAC,OAAO;IAKxD,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAI5C,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;CAGhE"}

package/esm/screenplay/models/locators/PlaywrightLocator.js

@@ -0,0 +1,166 @@
+import { f, LogicError } from '@serenity-js/core';
+import { ByCss, ByCssContainingText, ByDeepCss, ById, ByRole, ByTagName, ByXPath, Locator } from '@serenity-js/web';
+import { SerenitySelectorEngines } from '../../../selector-engines/index.js';
+import { promised } from '../../promised.js';
+import { PlaywrightPageElement } from '../PlaywrightPageElement.js';
+/**
+ * Playwright-specific implementation of [`Locator`](https://serenity-js.org/api/web/class/Locator/).
+ *
+ * @group Models
+ */
+export class PlaywrightLocator extends Locator {
+    constructor(parent, selector) {
+        super(parent, selector);
+    }
+    // todo: refactor; replace with a map and some more generic lookup mechanism
+    nativeSelector() {
+        if (this.selector instanceof ByCss) {
+            return `css=${this.selector.value}`;
+        }
+        if (this.selector instanceof ByDeepCss) {
+            return `css=${this.selector.value}`;
+        }
+        if (this.selector instanceof ByCssContainingText) {
+            return `css=${this.selector.value}:has-text("${this.selector.text}")`;
+        }
+        if (this.selector instanceof ById) {
+            return `id=${this.selector.value}`;
+        }
+        if (this.selector instanceof ByRole) {
+            return getByRoleSelector(this.selector.value, this.selector.options);
+        }
+        if (this.selector instanceof ByTagName) {
+            return `css=${this.selector.value}`;
+        }
+        if (this.selector instanceof ByXPath) {
+            return `xpath=${this.selector.value}`;
+        }
+        throw new LogicError(f `${this.selector} is not supported by ${this.constructor.name}`);
+    }
+    async isPresent() {
+        try {
+            const parentPresent = await this.parent.isPresent();
+            if (!parentPresent) {
+                return false;
+            }
+            const parent = await this.parent.nativeElement();
+            await parent.locator(this.nativeSelector()).first().waitFor({ state: 'attached', timeout: 250 });
+            return true;
+        }
+        catch (error) {
+            if (error.name === 'TimeoutError') {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async nativeElement() {
+        const parent = await this.parent.nativeElement();
+        return promised(parent.locator(this.nativeSelector()));
+    }
+    async allNativeElements() {
+        const parent = await this.parent.nativeElement();
+        if (!parent) {
+            return [];
+        }
+        return promised(parent.locator(this.nativeSelector()).all());
+    }
+    of(parent) {
+        return new PlaywrightLocator(parent, this.selector);
+    }
+    closestTo(child) {
+        return new PlaywrightParentElementLocator(this.parent, this.selector, child);
+    }
+    locate(child) {
+        return new PlaywrightLocator(this, child.selector);
+    }
+    element() {
+        return new PlaywrightPageElement(this);
+    }
+    async allElements() {
+        const elements = await this.allNativeElements();
+        return elements.map(childElement => new PlaywrightPageElement(new PlaywrightExistingElementLocator(this.parent, this.selector, childElement)));
+    }
+}
+/**
+ * @internal
+ */
+export class PlaywrightExistingElementLocator extends PlaywrightLocator {
+    existingNativeElement;
+    constructor(parent, selector, existingNativeElement) {
+        super(parent, selector);
+        this.existingNativeElement = existingNativeElement;
+    }
+    async nativeElement() {
+        return this.existingNativeElement;
+    }
+    async allNativeElements() {
+        return [this.existingNativeElement];
+    }
+}
+class PlaywrightParentElementLocator extends PlaywrightLocator {
+    child;
+    constructor(parent, selector, child) {
+        super(parent, selector);
+        this.child = child;
+    }
+    async nativeElement() {
+        const cssSelector = this.asCssSelector(this.selector);
+        const child = await this.child.nativeElement();
+        return child.locator(`${SerenitySelectorEngines.engineIdOf('closest')}=${cssSelector.value}`);
+    }
+    async allNativeElements() {
+        return [await this.nativeElement()];
+    }
+}
+// Playwright doesn't expose the internal locator utilities, so unfortunately we need to re-implement them here.
+// https://github.com/microsoft/playwright/blob/release-1.55/packages/playwright-core/src/utils/isomorphic/locatorUtils.ts#L59
+function getByRoleSelector(role, options = {}) {
+    const props = [];
+    if (options.checked !== undefined) {
+        props.push(['checked', String(options.checked)]);
+    }
+    if (options.disabled !== undefined) {
+        props.push(['disabled', String(options.disabled)]);
+    }
+    if (options.selected !== undefined) {
+        props.push(['selected', String(options.selected)]);
+    }
+    if (options.expanded !== undefined) {
+        props.push(['expanded', String(options.expanded)]);
+    }
+    if (options.includeHidden !== undefined) {
+        props.push(['include-hidden', String(options.includeHidden)]);
+    }
+    if (options.level !== undefined) {
+        props.push(['level', String(options.level)]);
+    }
+    if (options.name !== undefined) {
+        props.push(['name', escapeForAttributeSelector(options.name, !!options.exact)]);
+    }
+    if (options.pressed !== undefined) {
+        props.push(['pressed', String(options.pressed)]);
+    }
+    return `role=${role}${props.map(([n, v]) => `[${n}=${v}]`).join('')}`;
+}
+// https://github.com/microsoft/playwright/blob/release-1.55/packages/playwright-core/src/utils/isomorphic/stringUtils.ts#L92
+function escapeForAttributeSelector(value, exact) {
+    if (typeof value !== 'string') {
+        return escapeRegexForSelector(value);
+    }
+    // However, Playwright attribute selectors do not conform to CSS parsing spec,
+    // so we escape them differently.
+    return `"${value.replaceAll('\\', '\\\\').replaceAll('"', '\\"')}"${exact ? 's' : 'i'}`;
+}
+// https://github.com/microsoft/playwright/blob/release-1.55/packages/playwright-core/src/utils/isomorphic/stringUtils.ts#L75
+function escapeRegexForSelector(re) {
+    // Unicode mode does not allow "identity character escapes", so Playwright does not escape and
+    // hopes that it does not contain quotes and/or >> signs.
+    // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Regular_expressions/Character_escape
+    if (re['unicode'] || re['unicodeSets']) {
+        return String(re);
+    }
+    // Even number of backslashes followed by the quote -> insert a backslash.
+    return String(re).replaceAll(/(^|[^\\])(\\\\)*(["'`])/g, '$1$2\\$3').replaceAll('>>', '\\>\\>');
+}
+//# sourceMappingURL=PlaywrightLocator.js.map

package/esm/screenplay/models/locators/PlaywrightLocator.js.map

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

package/esm/screenplay/models/locators/PlaywrightRootLocator.d.ts

@@ -0,0 +1,39 @@
+import { RootLocator } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+type PageFunction<Argument, R> = string | ((arg: Argument) => R | Promise<R>);
+/**
+ * Playwright-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
+ *
+ * @group Models
+ */
+export declare class PlaywrightRootLocator extends RootLocator<playwright.Locator> {
+    private readonly page;
+    private currentFrame;
+    constructor(page: playwright.Page);
+    isPresent(): Promise<boolean>;
+    nativeElement(): Promise<Pick<playwright.Locator, 'locator'>>;
+    /**
+     * Evaluates the given `pageFunction` in the context of the current frame.
+     * See [`playwright.Frame.evaluate`](https://playwright.dev/docs/api/class-frame#frame-evaluate).
+     *
+     * @param pageFunction
+     * @param arg
+     */
+    evaluate<R, Arguments>(pageFunction: PageFunction<Arguments, R>, arg: Arguments): Promise<R>;
+    /**
+     * Switches the current context to the frame identified by the given locator.
+     *
+     * @param frame
+     */
+    switchToFrame(frame: playwright.Locator): Promise<void>;
+    /**
+     * Switches the current context to the parent frame of the current frame.
+     */
+    switchToParentFrame(): Promise<void>;
+    /**
+     * Switches the context to the top-level frame.
+     */
+    switchToMainFrame(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=PlaywrightRootLocator.d.ts.map

package/esm/screenplay/models/locators/PlaywrightRootLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightRootLocator.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/PlaywrightRootLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAOnD,KAAK,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC;IAI1D,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,YAAY,CAAmB;gBAEV,IAAI,EAAE,UAAU,CAAC,IAAI;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAI7D;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAK5F;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/esm/screenplay/models/locators/PlaywrightRootLocator.js

@@ -0,0 +1,48 @@
+import { RootLocator } from '@serenity-js/web';
+import { ensure, isDefined } from 'tiny-types';
+import { promised } from '../../promised.js';
+/**
+ * Playwright-specific implementation of [`RootLocator`](https://serenity-js.org/api/web/class/RootLocator/).
+ *
+ * @group Models
+ */
+export class PlaywrightRootLocator extends RootLocator {
+    page;
+    currentFrame;
+    constructor(page) {
+        super();
+        this.page = page;
+        this.currentFrame = this.page.mainFrame();
+    }
+    async isPresent() {
+        return true;
+    }
+    nativeElement() {
+        return promised(this.currentFrame);
+    }
+    evaluate(pageFunction, arg) {
+        return this.currentFrame.evaluate(pageFunction, arg);
+    }
+    /**
+     * Switches the current context to the frame identified by the given locator.
+     *
+     * @param frame
+     */
+    async switchToFrame(frame) {
+        const element = await frame.elementHandle();
+        this.currentFrame = ensure('frame', await element.contentFrame(), isDefined());
+    }
+    /**
+     * Switches the current context to the parent frame of the current frame.
+     */
+    async switchToParentFrame() {
+        this.currentFrame = ensure('parent frame', this.currentFrame.parentFrame(), isDefined());
+    }
+    /**
+     * Switches the context to the top-level frame.
+     */
+    async switchToMainFrame() {
+        this.currentFrame = this.page.mainFrame();
+    }
+}
+//# sourceMappingURL=PlaywrightRootLocator.js.map

package/esm/screenplay/models/locators/PlaywrightRootLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightRootLocator.js","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/PlaywrightRootLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAM7C;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAA+B;IAIzC;IAFrB,YAAY,CAAmB;IAEvC,YAA6B,IAAqB;QAC9C,KAAK,EAAE,CAAC;QADiB,SAAI,GAAJ,IAAI,CAAiB;QAE9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS;QACX,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,aAAa;QACT,OAAO,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAUD,QAAQ,CAAI,YAAmC,EAAE,GAAS;QACtD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,KAAyB;QACzC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACrB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB;QACnB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;CACJ"}

package/esm/screenplay/models/locators/index.d.ts

@@ -0,0 +1,3 @@
+export * from './PlaywrightLocator.js';
+export * from './PlaywrightRootLocator.js';
+//# sourceMappingURL=index.d.ts.map

package/esm/screenplay/models/locators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/esm/screenplay/models/locators/index.js

@@ -0,0 +1,3 @@
+export * from './PlaywrightLocator.js';
+export * from './PlaywrightRootLocator.js';
+//# sourceMappingURL=index.js.map

package/esm/screenplay/models/locators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/esm/screenplay/promised.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Playwright 1.33.0 and newer rely on "zones" recorded in the stack trace
+ * to establish child-parent relationship between Playwright tasks.
+ *
+ * This helper function ensures that the stack trace is correctly recorded.
+ *
+ * @param value
+ */
+export declare function promised<T>(value: Promise<T> | T): Promise<T>;
+//# sourceMappingURL=promised.d.ts.map

package/esm/screenplay/promised.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promised.d.ts","sourceRoot":"","sources":["../../src/screenplay/promised.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7D"}

package/esm/screenplay/promised.js

@@ -0,0 +1,12 @@
+/**
+ * Playwright 1.33.0 and newer rely on "zones" recorded in the stack trace
+ * to establish child-parent relationship between Playwright tasks.
+ *
+ * This helper function ensures that the stack trace is correctly recorded.
+ *
+ * @param value
+ */
+export function promised(value) {
+    return Promise.resolve().then(() => value);
+}
+//# sourceMappingURL=promised.js.map

package/esm/screenplay/promised.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promised.js","sourceRoot":"","sources":["../../src/screenplay/promised.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAqB;IAC7C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/esm/selector-engines/PlaywrightSelectorEngine.d.ts

@@ -0,0 +1,5 @@
+export interface PlaywrightSelectorEngine {
+    query(root: Element, selector: string): HTMLElement;
+    queryAll(root: Element, selector: string): Array<HTMLElement>;
+}
+//# sourceMappingURL=PlaywrightSelectorEngine.d.ts.map

package/esm/selector-engines/PlaywrightSelectorEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightSelectorEngine.d.ts","sourceRoot":"","sources":["../../src/selector-engines/PlaywrightSelectorEngine.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;CACjE"}

package/esm/selector-engines/PlaywrightSelectorEngine.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PlaywrightSelectorEngine.js.map

package/esm/selector-engines/PlaywrightSelectorEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightSelectorEngine.js","sourceRoot":"","sources":["../../src/selector-engines/PlaywrightSelectorEngine.ts"],"names":[],"mappings":""}

package/esm/selector-engines/SerenitySelectorEngines.d.ts

@@ -0,0 +1,14 @@
+import type { Selectors } from 'playwright-core';
+/**
+ * Utility class responsible for registering custom [Playwright selector engines](https://playwright.dev/docs/extensibility)
+ * used internally by Serenity/JS.
+ *
+ * @internal
+ */
+export declare class SerenitySelectorEngines {
+    private static isRegistered;
+    private static readonly engines;
+    ensureRegisteredWith(selectors: Selectors): Promise<void>;
+    static engineIdOf(engineName: string): string;
+}
+//# sourceMappingURL=SerenitySelectorEngines.d.ts.map

package/esm/selector-engines/SerenitySelectorEngines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerenitySelectorEngines.d.ts","sourceRoot":"","sources":["../../src/selector-engines/SerenitySelectorEngines.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;;;GAKG;AACH,qBAAa,uBAAuB;IAChC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAS5B;IAEG,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/D,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAOhD"}