@serenity-js/playwright 3.5.0 → 3.6.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.6.0](https://github.com/serenity-js/serenity-js/compare/v3.5.0...v3.6.0) (2023-07-11)
+
+
+### Bug Fixes
+
+* **deps:** update dependency tiny-types to ^1.20.0 ([6d7bf43](https://github.com/serenity-js/serenity-js/commit/6d7bf43c6135968bc90869cb8f9782ed70ca8dd9))
+
+
+### Features
+
+* **playwright-test:** enable BrowseTheWebWithPlaywright to reuse an existing page instance ([5c2deb1](https://github.com/serenity-js/serenity-js/commit/5c2deb1853f27884fcdaccccc0b1b108c0a8489b)), closes [#1784](https://github.com/serenity-js/serenity-js/issues/1784)
+* **web:** you can now use Serenity/JS Screenplay Pattern APIs for UI component testing ([3c9aa4b](https://github.com/serenity-js/serenity-js/commit/3c9aa4b16d223844116ffcb21d23f9cc8b96a793)), closes [#1784](https://github.com/serenity-js/serenity-js/issues/1784)
+
+
+
+
+
 # [3.5.0](https://github.com/serenity-js/serenity-js/compare/v3.4.2...v3.5.0) (2023-07-02)
 
 

package/lib/screenplay/abilities/BrowseTheWebWithPlaywright.d.ts

@@ -1,5 +1,4 @@
 import type { Discardable } from '@serenity-js/core';
-import type { BrowserCapabilities } from '@serenity-js/web';
 import { BrowseTheWeb } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
 import type { PlaywrightOptions } from '../../PlaywrightOptions';
@@ -9,6 +8,14 @@ import type { PlaywrightOptions } from '../../PlaywrightOptions';
  *
  * ## Using Playwright to `BrowseTheWeb`
  *
+ * In the example below, we configure the ability to {@apilink BrowseTheWebWithPlaywright} with a Playwright
+ * [`Browser`](https://playwright.dev/docs/api/class-browser) so that Serenity/JS {@apilink Actor|actors}
+ * can create a new [`BrowserContext`](https://playwright.dev/docs/api/class-browsercontext) and
+ * instantiate Playwright [`page`s](https://playwright.dev/docs/api/class-page) as and when needed.
+ *
+ * This configuration allows Serenity/JS to control the process of launching and shutting down browser instances
+ * and is useful when your test runner, e.g. [Cucumber.js](/api/cucumber), doesn't offer this functionality.
+ *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
  * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
@@ -31,6 +38,55 @@ import type { PlaywrightOptions } from '../../PlaywrightOptions';
  *   )
  * ```
  *
+ * ## Using `BrowseTheWeb` with an existing Playwright `page`
+ *
+ * Test runners like [Playwright Test](/api/playwright-test/) manage Playwright browsers for you
+ * and offer a [`page`](https://playwright.dev/docs/api/class-page) instance you can
+ * inject into the ability to {@apilink BrowseTheWebWithPlaywright}.
+ *
+ * Note that [Serenity/JS Playwright Test module](/api/playwright-test/)
+ * automatically configures all your {@apilink Actor|actors}
+ * with an ability to {@apilink BrowseTheWebWithPlaywright},
+ * so you don't need to do it by hand unless you want to override the {@apilink SerenityOptions|default configuration}.
+ *
+ * The example below demonstrates how to use the {@apilink BrowseTheWebWithPlaywright.usingPage} API and
+ * override the default {@apilink Cast} of actors.
+ *
+ * ```ts title="specs/example.spec.ts"
+ * import { describe, it, test } from '@playwright/playwright-test'
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
+ * import { By, Navigate, PageElement, Text } from '@serenity-js/web'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ *
+ * const HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
+ *
+ * describe('Serenity/JS with Playwright', () => {
+ *
+ *   test.use({
+ *     actors: async ({ page, contextOptions }, use) => {
+ *       await use(
+ *         Cast.where((actorName: string) => {
+ *           return actor.whoCan(
+ *             BrowseTheWebWithPlaywright.usingPage(page),
+ *             // ... add any other abilities
+ *           )
+ *         })
+ *       )
+ *     }
+ *   })
+ *
+ *   it('lets you reuse an existing page', async ({ actor }) => {
+ *     await actor.attemptsTo(
+ *       Navigate.to(`https://serenity-js.org`),
+ *       Ensure.that(Text.of(HomePage.title()), equals('Serenity/JS')),
+ *     )
+ *   })
+ * })
+ * ```
+ *
  * ## Learn more
  * - [Playwright website](https://playwright.dev/)
  * - {@apilink BrowseTheWeb}
@@ -40,9 +96,8 @@ import type { PlaywrightOptions } from '../../PlaywrightOptions';
  * @group Abilities
  */
 export declare class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.Locator> implements Discardable {
-    protected readonly browser: playwright.Browser;
     static using(browser: playwright.Browser, options?: PlaywrightOptions): BrowseTheWebWithPlaywright;
-    constructor(browser: playwright.Browser, browserContextOptions?: PlaywrightOptions);
+    static usingPage(page: playwright.Page, options?: PlaywrightOptions): BrowseTheWebWithPlaywright;
     /**
      * Automatically closes any open {@apilink Page|Pages} when the {@apilink SceneFinishes}
      *
@@ -51,13 +106,5 @@ export declare class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.
      * - {@apilink Discardable}
      */
     discard(): Promise<void>;
-    /**
-     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this ability.
-     *
-     * **Please note** that since Playwright does not expose information about the operating system
-     * the tests are running on, **Serenity/JS assumes that the tests are running locally**
-     * and therefore returns the value of Node.js `process.platform` for `platformName`.
-     */
-    browserCapabilities(): Promise<BrowserCapabilities>;
 }
 //# sourceMappingURL=BrowseTheWebWithPlaywright.d.ts.map

package/lib/screenplay/abilities/BrowseTheWebWithPlaywright.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BrowseTheWebWithPlaywright.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,0BAA2B,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,CAAE,YAAW,WAAW;IAMvF,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO;IAJ1D,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,0BAA0B;gBAInE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAE,iBAAsB;IAIzG;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAO5D"}
+{"version":3,"file":"BrowseTheWebWithPlaywright.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,qBAAa,0BAA2B,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,CAAE,YAAW,WAAW;IAEnG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,0BAA0B;IAIlG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,0BAA0B;IAIhG;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}

package/lib/screenplay/abilities/BrowseTheWebWithPlaywright.js

@@ -9,6 +9,14 @@ const models_1 = require("../models");
  *
  * ## Using Playwright to `BrowseTheWeb`
  *
+ * In the example below, we configure the ability to {@apilink BrowseTheWebWithPlaywright} with a Playwright
+ * [`Browser`](https://playwright.dev/docs/api/class-browser) so that Serenity/JS {@apilink Actor|actors}
+ * can create a new [`BrowserContext`](https://playwright.dev/docs/api/class-browsercontext) and
+ * instantiate Playwright [`page`s](https://playwright.dev/docs/api/class-page) as and when needed.
+ *
+ * This configuration allows Serenity/JS to control the process of launching and shutting down browser instances
+ * and is useful when your test runner, e.g. [Cucumber.js](/api/cucumber), doesn't offer this functionality.
+ *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
  * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
@@ -31,6 +39,55 @@ const models_1 = require("../models");
  *   )
  * ```
  *
+ * ## Using `BrowseTheWeb` with an existing Playwright `page`
+ *
+ * Test runners like [Playwright Test](/api/playwright-test/) manage Playwright browsers for you
+ * and offer a [`page`](https://playwright.dev/docs/api/class-page) instance you can
+ * inject into the ability to {@apilink BrowseTheWebWithPlaywright}.
+ *
+ * Note that [Serenity/JS Playwright Test module](/api/playwright-test/)
+ * automatically configures all your {@apilink Actor|actors}
+ * with an ability to {@apilink BrowseTheWebWithPlaywright},
+ * so you don't need to do it by hand unless you want to override the {@apilink SerenityOptions|default configuration}.
+ *
+ * The example below demonstrates how to use the {@apilink BrowseTheWebWithPlaywright.usingPage} API and
+ * override the default {@apilink Cast} of actors.
+ *
+ * ```ts title="specs/example.spec.ts"
+ * import { describe, it, test } from '@playwright/playwright-test'
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
+ * import { By, Navigate, PageElement, Text } from '@serenity-js/web'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ *
+ * const HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
+ *
+ * describe('Serenity/JS with Playwright', () => {
+ *
+ *   test.use({
+ *     actors: async ({ page, contextOptions }, use) => {
+ *       await use(
+ *         Cast.where((actorName: string) => {
+ *           return actor.whoCan(
+ *             BrowseTheWebWithPlaywright.usingPage(page),
+ *             // ... add any other abilities
+ *           )
+ *         })
+ *       )
+ *     }
+ *   })
+ *
+ *   it('lets you reuse an existing page', async ({ actor }) => {
+ *     await actor.attemptsTo(
+ *       Navigate.to(`https://serenity-js.org`),
+ *       Ensure.that(Text.of(HomePage.title()), equals('Serenity/JS')),
+ *     )
+ *   })
+ * })
+ * ```
+ *
  * ## Learn more
  * - [Playwright website](https://playwright.dev/)
  * - {@apilink BrowseTheWeb}
@@ -41,11 +98,10 @@ const models_1 = require("../models");
  */
 class BrowseTheWebWithPlaywright extends web_1.BrowseTheWeb {
     static using(browser, options) {
-        return new BrowseTheWebWithPlaywright(browser, options);
+        return new BrowseTheWebWithPlaywright(new models_1.PlaywrightBrowsingSessionWithBrowser(browser, options));
     }
-    constructor(browser, browserContextOptions = {}) {
-        super(new models_1.PlaywrightBrowsingSession(browser, browserContextOptions));
-        this.browser = browser;
+    static usingPage(page, options) {
+        return new BrowseTheWebWithPlaywright(new models_1.PlaywrightBrowsingSessionWithPage(page, options));
     }
     /**
      * Automatically closes any open {@apilink Page|Pages} when the {@apilink SceneFinishes}
@@ -57,20 +113,6 @@ class BrowseTheWebWithPlaywright extends web_1.BrowseTheWeb {
     async discard() {
         await this.session.closeAllPages();
     }
-    /**
-     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this ability.
-     *
-     * **Please note** that since Playwright does not expose information about the operating system
-     * the tests are running on, **Serenity/JS assumes that the tests are running locally**
-     * and therefore returns the value of Node.js `process.platform` for `platformName`.
-     */
-    async browserCapabilities() {
-        return {
-            browserName: this.browser._initializer.name,
-            platformName: process.platform,
-            browserVersion: this.browser.version()
-        };
-    }
 }
 exports.BrowseTheWebWithPlaywright = BrowseTheWebWithPlaywright;
 //# sourceMappingURL=BrowseTheWebWithPlaywright.js.map

package/lib/screenplay/abilities/BrowseTheWebWithPlaywright.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrowseTheWebWithPlaywright.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":";;;AAEA,0CAAgD;AAIhD,sCAAsD;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAa,0BAA2B,SAAQ,kBAAgC;IAE5E,MAAM,CAAC,KAAK,CAAC,OAA2B,EAAE,OAA2B;QACjE,OAAO,IAAI,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,YAA+B,OAA2B,EAAE,wBAA2C,EAAE;QACrG,KAAK,CAAC,IAAI,kCAAyB,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAD1C,YAAO,GAAP,OAAO,CAAoB;IAE1D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACrB,OAAO;YACH,WAAW,EAAG,IAAI,CAAC,OAAe,CAAC,YAAY,CAAC,IAAI;YACpD,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;SACzC,CAAA;IACL,CAAC;CACJ;AAnCD,gEAmCC"}
+{"version":3,"file":"BrowseTheWebWithPlaywright.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":";;;AACA,0CAAgD;AAIhD,sCAGmB;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,MAAa,0BAA2B,SAAQ,kBAAgC;IAE5E,MAAM,CAAC,KAAK,CAAC,OAA2B,EAAE,OAA2B;QACjE,OAAO,IAAI,0BAA0B,CAAC,IAAI,6CAAoC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,IAAqB,EAAE,OAA2B;QAC/D,OAAO,IAAI,0BAA0B,CAAC,IAAI,0CAAiC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;CACJ;AApBD,gEAoBC"}

package/lib/screenplay/models/PlaywrightBrowsingSession.d.ts

@@ -1,26 +1,30 @@
-import type { Cookie, CookieData } from '@serenity-js/web';
-import { BrowsingSession } from '@serenity-js/web';
+import type { BrowserCapabilities } from '@serenity-js/web';
+import { BrowsingSession, type Cookie, type CookieData } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
-import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { type PlaywrightOptions } from '../../PlaywrightOptions';
 import { PlaywrightPage } from '../models';
 /**
  * Playwright-specific implementation of {@apilink BrowsingSession}.
  *
  * @group Models
  */
-export declare class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
-    protected readonly browser: playwright.Browser;
+export declare abstract class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
     protected readonly browserContextOptions: PlaywrightOptions;
     private currentPlaywrightBrowserContext;
-    constructor(browser: playwright.Browser, browserContextOptions: PlaywrightOptions);
-    protected registerCurrentPage(): Promise<PlaywrightPage>;
+    protected constructor(browserContextOptions: PlaywrightOptions);
     /**
-     * @override
+     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this ability.
+     *
+     * **Please note** that since Playwright does not expose information about the operating system
+     * the tests are running on, **Serenity/JS assumes that the tests are running locally**
+     * and therefore returns the value of Node.js `process.platform` for `platformName`.
      */
-    closeAllPages(): Promise<void>;
+    abstract browserCapabilities(): Promise<BrowserCapabilities>;
     cookie(name: string): Promise<Cookie>;
     setCookie(cookie: CookieData): Promise<void>;
     deleteAllCookies(): Promise<void>;
-    private browserContext;
+    protected registerCurrentPage(): Promise<PlaywrightPage>;
+    protected browserContext(): Promise<playwright.BrowserContext>;
+    protected abstract createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext>;
 }
 //# sourceMappingURL=PlaywrightBrowsingSession.d.ts.map

package/lib/screenplay/models/PlaywrightBrowsingSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaywrightBrowsingSession.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAoB,cAAc,EAAE,MAAM,WAAW,CAAC;AAE7D;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,eAAe,CAAC,cAAc,CAAC;IAKtE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO;IAC9C,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,iBAAiB;IAJ/D,OAAO,CAAC,+BAA+B,CAA4B;gBAG5C,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,qBAAqB,EAAE,iBAAiB;cAK/C,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;IAc9D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;YAKzB,cAAc;CAqB/B"}
+{"version":3,"file":"PlaywrightBrowsingSession.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAoB,cAAc,EAAE,MAAM,WAAW,CAAC;AAE7D;;;;GAIG;AACH,8BAAsB,yBAA0B,SAAQ,eAAe,CAAC,cAAc,CAAC;IAI7D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,iBAAiB;IAFjF,OAAO,CAAC,+BAA+B,CAA4B;IAEnE,SAAS,aAAgC,qBAAqB,EAAE,iBAAiB;IAIjF;;;;;;OAMG;aACa,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAE7D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;cAKd,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;cAcvD,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;IAsBpE,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;CAC1G"}

package/lib/screenplay/models/PlaywrightBrowsingSession.js

@@ -10,28 +10,10 @@ const models_1 = require("../models");
  * @group Models
  */
 class PlaywrightBrowsingSession extends web_1.BrowsingSession {
-    constructor(browser, browserContextOptions) {
+    constructor(browserContextOptions) {
         super();
-        this.browser = browser;
         this.browserContextOptions = browserContextOptions;
     }
-    async registerCurrentPage() {
-        const context = await this.browserContext();
-        await context.newPage();
-        // calling context.newPage() triggers a callback registered via browserContext(),
-        // which wraps playwright.Page in PlaywrightPage and adds it to the list of pages
-        // returned by this.allPages()
-        const allPages = await this.allPages();
-        return allPages.at(-1);
-    }
-    /**
-     * @override
-     */
-    async closeAllPages() {
-        await super.closeAllPages();
-        const context = await this.browserContext();
-        await context.close();
-    }
     async cookie(name) {
         const context = await this.browserContext();
         return new models_1.PlaywrightCookie(context, name);
@@ -44,9 +26,18 @@ class PlaywrightBrowsingSession extends web_1.BrowsingSession {
         const context = await this.browserContext();
         await context.clearCookies();
     }
+    async registerCurrentPage() {
+        const context = await this.browserContext();
+        await context.newPage();
+        // calling context.newPage() triggers a callback registered via browserContext(),
+        // which wraps playwright.Page in PlaywrightPage and adds it to the list of pages
+        // returned by this.allPages()
+        const allPages = await this.allPages();
+        return allPages.at(-1);
+    }
     async browserContext() {
         if (!this.currentPlaywrightBrowserContext) {
-            this.currentPlaywrightBrowserContext = await this.browser.newContext(this.browserContextOptions);
+            this.currentPlaywrightBrowserContext = await this.createBrowserContext(this.browserContextOptions);
             this.currentPlaywrightBrowserContext.on('page', async (page) => {
                 this.register(new models_1.PlaywrightPage(this, page, this.browserContextOptions, model_1.CorrelationId.create()));
             });

package/lib/screenplay/models/PlaywrightBrowsingSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaywrightBrowsingSession.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSession.ts"],"names":[],"mappings":";;;AAAA,uDAA4D;AAE5D,0CAAmD;AAInD,sCAA6D;AAE7D;;;;GAIG;AACH,MAAa,yBAA0B,SAAQ,qBAA+B;IAI1E,YACuB,OAA2B,EAC3B,qBAAwC;QAE3D,KAAK,EAAE,CAAC;QAHW,YAAO,GAAP,OAAO,CAAoB;QAC3B,0BAAqB,GAArB,qBAAqB,CAAmB;IAG/D,CAAC;IAES,KAAK,CAAC,mBAAmB;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,iFAAiF;QACjF,iFAAiF;QACjF,8BAA8B;QAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QAEtC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACf,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC;QAE5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,IAAI,yBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAkB;QAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5C,MAAM,OAAO,CAAC,UAAU,CAAC,CAAE,MAAM,CAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,cAAc;QACxB,IAAI,CAAE,IAAI,CAAC,+BAA+B,EAAE;YACxC,IAAI,CAAC,+BAA+B,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAEjG,IAAI,CAAC,+BAA+B,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;gBACzD,IAAI,CAAC,QAAQ,CACT,IAAI,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,qBAAa,CAAC,MAAM,EAAE,CAAC,CACrF,CAAC;YACN,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,qBAAqB,EAAE,wBAAwB,EAAE;gBACtD,IAAI,CAAC,+BAA+B,CAAC,2BAA2B,CAAC,IAAI,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC;aAC1H;YAED,IAAI,IAAI,CAAC,qBAAqB,EAAE,cAAc,EAAE;gBAC5C,IAAI,CAAC,+BAA+B,CAAC,iBAAiB,CAAC,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;aACtG;SACJ;QAED,OAAO,IAAI,CAAC,+BAA+B,CAAC;IAChD,CAAC;CACJ;AAxED,8DAwEC"}
+{"version":3,"file":"PlaywrightBrowsingSession.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSession.ts"],"names":[],"mappings":";;;AAAA,uDAA4D;AAE5D,0CAAiF;AAIjF,sCAA6D;AAE7D;;;;GAIG;AACH,MAAsB,yBAA0B,SAAQ,qBAA+B;IAInF,YAAyC,qBAAwC;QAC7E,KAAK,EAAE,CAAC;QAD6B,0BAAqB,GAArB,qBAAqB,CAAmB;IAEjF,CAAC;IAWD,KAAK,CAAC,MAAM,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,IAAI,yBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAkB;QAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5C,MAAM,OAAO,CAAC,UAAU,CAAC,CAAE,MAAM,CAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;QAC3C,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC;IAEkB,KAAK,CAAC,mBAAmB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,iFAAiF;QACjF,iFAAiF;QACjF,8BAA8B;QAE9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;QAEtC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAES,KAAK,CAAC,cAAc;QAC1B,IAAI,CAAE,IAAI,CAAC,+BAA+B,EAAE;YACxC,IAAI,CAAC,+BAA+B,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAEnG,IAAI,CAAC,+BAA+B,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;gBACzD,IAAI,CAAC,QAAQ,CACT,IAAI,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,qBAAa,CAAC,MAAM,EAAE,CAAC,CACrF,CAAC;YACN,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,qBAAqB,EAAE,wBAAwB,EAAE;gBACtD,IAAI,CAAC,+BAA+B,CAAC,2BAA2B,CAAC,IAAI,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC;aAC1H;YAED,IAAI,IAAI,CAAC,qBAAqB,EAAE,cAAc,EAAE;gBAC5C,IAAI,CAAC,+BAA+B,CAAC,iBAAiB,CAAC,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;aACtG;SACJ;QAED,OAAO,IAAI,CAAC,+BAA+B,CAAC;IAChD,CAAC;CAGJ;AAtED,8DAsEC"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithBrowser.d.ts

@@ -0,0 +1,12 @@
+import type { BrowserCapabilities } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession';
+export declare class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession {
+    protected readonly browser: playwright.Browser;
+    constructor(browser: playwright.Browser, browserContextOptions: PlaywrightOptions);
+    protected createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext>;
+    closeAllPages(): Promise<void>;
+    browserCapabilities(): Promise<BrowserCapabilities>;
+}
+//# sourceMappingURL=PlaywrightBrowsingSessionWithBrowser.d.ts.map

package/lib/screenplay/models/PlaywrightBrowsingSessionWithBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithBrowser.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,qBAAa,oCAAqC,SAAQ,yBAAyB;IAE3E,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAA3B,OAAO,EAAE,UAAU,CAAC,OAAO,EAC9C,qBAAqB,EAAE,iBAAiB;cAKzB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;IAIxF,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAOrE"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithBrowser.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightBrowsingSessionWithBrowser = void 0;
+const PlaywrightBrowsingSession_1 = require("./PlaywrightBrowsingSession");
+class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession_1.PlaywrightBrowsingSession {
+    constructor(browser, browserContextOptions) {
+        super(browserContextOptions);
+        this.browser = browser;
+    }
+    createBrowserContext(options) {
+        return this.browser.newContext(this.browserContextOptions);
+    }
+    async closeAllPages() {
+        await super.closeAllPages();
+        const context = await this.browserContext();
+        await context.close();
+    }
+    async browserCapabilities() {
+        return {
+            browserName: this.browser._initializer.name,
+            platformName: process.platform,
+            browserVersion: this.browser.version()
+        };
+    }
+}
+exports.PlaywrightBrowsingSessionWithBrowser = PlaywrightBrowsingSessionWithBrowser;
+//# sourceMappingURL=PlaywrightBrowsingSessionWithBrowser.js.map

package/lib/screenplay/models/PlaywrightBrowsingSessionWithBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithBrowser.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts"],"names":[],"mappings":";;;AAIA,2EAAwE;AAExE,MAAa,oCAAqC,SAAQ,qDAAyB;IAC/E,YACuB,OAA2B,EAC9C,qBAAwC;QAExC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAHV,YAAO,GAAP,OAAO,CAAoB;IAIlD,CAAC;IAEkB,oBAAoB,CAAC,OAA0B;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/D,CAAC;IAEQ,KAAK,CAAC,aAAa;QACxB,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC;QAE5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEQ,KAAK,CAAC,mBAAmB;QAC9B,OAAO;YACH,WAAW,EAAG,IAAI,CAAC,OAAe,CAAC,YAAY,CAAC,IAAI;YACpD,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;SACzC,CAAA;IACL,CAAC;CACJ;AA1BD,oFA0BC"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithPage.d.ts

@@ -0,0 +1,11 @@
+import type { BrowserCapabilities } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession';
+export declare class PlaywrightBrowsingSessionWithPage extends PlaywrightBrowsingSession {
+    protected readonly page: playwright.Page;
+    constructor(page: playwright.Page, browserContextOptions: PlaywrightOptions);
+    protected createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext>;
+    browserCapabilities(): Promise<BrowserCapabilities>;
+}
+//# sourceMappingURL=PlaywrightBrowsingSessionWithPage.d.ts.map

package/lib/screenplay/models/PlaywrightBrowsingSessionWithPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithPage.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithPage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,qBAAa,iCAAkC,SAAQ,yBAAyB;IAExE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI;gBAArB,IAAI,EAAE,UAAU,CAAC,IAAI,EACxC,qBAAqB,EAAE,iBAAiB;cAMnB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;IAI9F,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAQrE"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithPage.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightBrowsingSessionWithPage = void 0;
+const model_1 = require("@serenity-js/core/lib/model");
+const PlaywrightBrowsingSession_1 = require("./PlaywrightBrowsingSession");
+const PlaywrightPage_1 = require("./PlaywrightPage");
+class PlaywrightBrowsingSessionWithPage extends PlaywrightBrowsingSession_1.PlaywrightBrowsingSession {
+    constructor(page, browserContextOptions) {
+        super(browserContextOptions);
+        this.page = page;
+        this.currentBrowserPage = new PlaywrightPage_1.PlaywrightPage(this, this.page, this.browserContextOptions, model_1.CorrelationId.create());
+    }
+    async createBrowserContext(options) {
+        return this.page.context();
+    }
+    async browserCapabilities() {
+        const browser = await this.page.context().browser();
+        return {
+            browserName: browser._initializer.name,
+            platformName: process.platform,
+            browserVersion: browser.version()
+        };
+    }
+}
+exports.PlaywrightBrowsingSessionWithPage = PlaywrightBrowsingSessionWithPage;
+//# sourceMappingURL=PlaywrightBrowsingSessionWithPage.js.map

package/lib/screenplay/models/PlaywrightBrowsingSessionWithPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithPage.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithPage.ts"],"names":[],"mappings":";;;AAAA,uDAA4D;AAK5D,2EAAwE;AACxE,qDAAkD;AAElD,MAAa,iCAAkC,SAAQ,qDAAyB;IAC5E,YACuB,IAAqB,EACxC,qBAAwC;QAExC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAHV,SAAI,GAAJ,IAAI,CAAiB;QAIxC,IAAI,CAAC,kBAAkB,GAAG,IAAI,+BAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,qBAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACtH,CAAC;IAEkB,KAAK,CAAC,oBAAoB,CAAC,OAA0B;QACpE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAEQ,KAAK,CAAC,mBAAmB;QAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO;YACH,WAAW,EAAG,OAAe,CAAC,YAAY,CAAC,IAAI;YAC/C,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE;SACpC,CAAA;IACL,CAAC;CACJ;AArBD,8EAqBC"}

package/lib/screenplay/models/PlaywrightPage.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import type { QuestionAdapter } from '@serenity-js/core';
+import { type QuestionAdapter } from '@serenity-js/core';
 import type { CorrelationId } from '@serenity-js/core/lib/model';
 import type { Cookie, CookieData, PageElement, Selector } from '@serenity-js/web';
 import { Key, Page, PageElements } from '@serenity-js/web';
@@ -18,6 +18,7 @@ export declare class PlaywrightPage extends Page<playwright.Locator> {
     private lastScriptExecutionSummary;
     static current(): QuestionAdapter<PlaywrightPage>;
     constructor(session: PlaywrightBrowsingSession, page: playwright.Page, options: PlaywrightOptions, pageId: CorrelationId);
+    createPageElement(nativeElement: playwright.Locator): PageElement<playwright.Locator>;
     locate(selector: Selector): PageElement<playwright.Locator>;
     locateAll(selector: Selector): PageElements<playwright.Locator>;
     navigateTo(destination: string): Promise<void>;

package/lib/screenplay/models/PlaywrightPage.d.ts.map

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

package/lib/screenplay/models/PlaywrightPage.js

@@ -23,6 +23,9 @@ class PlaywrightPage extends web_1.Page {
         this.page = page;
         this.options = options;
     }
+    createPageElement(nativeElement) {
+        return new PlaywrightPageElement_1.PlaywrightPageElement(new locators_1.PlaywrightExistingElementLocator(this.rootLocator, new web_1.ByDeepCss(nativeElement._selector), nativeElement));
+    }
     locate(selector) {
         return new PlaywrightPageElement_1.PlaywrightPageElement(new locators_1.PlaywrightLocator(this.rootLocator, selector));
     }

package/lib/screenplay/models/PlaywrightPage.js.map

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

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

@@ -1,5 +1,7 @@
 export * from './locators';
 export * from './PlaywrightBrowsingSession';
+export * from './PlaywrightBrowsingSessionWithBrowser';
+export * from './PlaywrightBrowsingSessionWithPage';
 export * from './PlaywrightCookie';
 export * from './PlaywrightPage';
 export * from './PlaywrightPageElement';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/lib/screenplay/models/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./locators"), exports);
 __exportStar(require("./PlaywrightBrowsingSession"), exports);
+__exportStar(require("./PlaywrightBrowsingSessionWithBrowser"), exports);
+__exportStar(require("./PlaywrightBrowsingSessionWithPage"), exports);
 __exportStar(require("./PlaywrightCookie"), exports);
 __exportStar(require("./PlaywrightPage"), exports);
 __exportStar(require("./PlaywrightPageElement"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8DAA4C;AAC5C,qDAAmC;AACnC,mDAAiC;AACjC,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8DAA4C;AAC5C,yEAAuD;AACvD,sEAAoD;AACpD,qDAAmC;AACnC,mDAAiC;AACjC,0DAAwC"}

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

@@ -18,4 +18,13 @@ export declare class PlaywrightLocator extends Locator<playwright.Locator, strin
     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/lib/screenplay/models/locators/PlaywrightLocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaywrightLocator.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/PlaywrightLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAmE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;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;IA4B5B,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,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"}
+{"version":3,"file":"PlaywrightLocator.d.ts","sourceRoot":"","sources":["../../../../src/screenplay/models/locators/PlaywrightLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAmE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;;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;IA4B5B,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,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/lib/screenplay/models/locators/PlaywrightLocator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlaywrightLocator = void 0;
+exports.PlaywrightExistingElementLocator = exports.PlaywrightLocator = void 0;
 const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const promised_1 = require("../../promised");
@@ -75,14 +75,14 @@ class PlaywrightLocator extends web_1.Locator {
     }
     async allElements() {
         const elements = await this.allNativeElements();
-        return elements.map(childElement => new PlaywrightPageElement_1.PlaywrightPageElement(new ExistingElementLocator(this.parent, this.selector, childElement)));
+        return elements.map(childElement => new PlaywrightPageElement_1.PlaywrightPageElement(new PlaywrightExistingElementLocator(this.parent, this.selector, childElement)));
     }
 }
 exports.PlaywrightLocator = PlaywrightLocator;
 /**
- * @private
+ * @internal
  */
-class ExistingElementLocator extends PlaywrightLocator {
+class PlaywrightExistingElementLocator extends PlaywrightLocator {
     constructor(parent, selector, existingNativeElement) {
         super(parent, selector);
         this.existingNativeElement = existingNativeElement;
@@ -94,4 +94,5 @@ class ExistingElementLocator extends PlaywrightLocator {
         return [this.existingNativeElement];
     }
 }
+exports.PlaywrightExistingElementLocator = PlaywrightExistingElementLocator;
 //# sourceMappingURL=PlaywrightLocator.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/playwright",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Serenity/JS Screenplay Pattern library for Playwright",
   "author": {
     "name": "Jan Molak",
@@ -43,10 +43,10 @@
     "node": "^16.13 || ^18.12 || ^20"
   },
   "dependencies": {
-    "@serenity-js/core": "3.5.0",
-    "@serenity-js/web": "3.5.0",
+    "@serenity-js/core": "3.6.0",
+    "@serenity-js/web": "3.6.0",
     "playwright-core": "^1.35.1",
-    "tiny-types": "^1.19.1"
+    "tiny-types": "^1.20.0"
   },
   "devDependencies": {
     "@integration/testing-tools": "3.0.0",
@@ -58,5 +58,5 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.1.6"
   },
-  "gitHead": "c34ec9a491ded36cc178f219a9b3cae058c34c2b"
+  "gitHead": "970ac224860693ab70e813e176b7532241503b14"
 }

package/src/screenplay/abilities/BrowseTheWebWithPlaywright.ts

@@ -1,10 +1,12 @@
 import type { Discardable } from '@serenity-js/core';
-import type { BrowserCapabilities} from '@serenity-js/web';
 import { BrowseTheWeb } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
 
 import type { PlaywrightOptions } from '../../PlaywrightOptions';
-import { PlaywrightBrowsingSession } from '../models';
+import {
+    PlaywrightBrowsingSessionWithBrowser,
+    PlaywrightBrowsingSessionWithPage
+} from '../models';
 
 /**
  * This implementation of the {@apilink Ability|ability} to {@apilink BrowseTheWeb}
@@ -12,6 +14,14 @@ import { PlaywrightBrowsingSession } from '../models';
  *
  * ## Using Playwright to `BrowseTheWeb`
  *
+ * In the example below, we configure the ability to {@apilink BrowseTheWebWithPlaywright} with a Playwright
+ * [`Browser`](https://playwright.dev/docs/api/class-browser) so that Serenity/JS {@apilink Actor|actors}
+ * can create a new [`BrowserContext`](https://playwright.dev/docs/api/class-browsercontext) and
+ * instantiate Playwright [`page`s](https://playwright.dev/docs/api/class-page) as and when needed.
+ *
+ * This configuration allows Serenity/JS to control the process of launching and shutting down browser instances
+ * and is useful when your test runner, e.g. [Cucumber.js](/api/cucumber), doesn't offer this functionality.
+ *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
  * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
@@ -34,6 +44,55 @@ import { PlaywrightBrowsingSession } from '../models';
  *   )
  * ```
  *
+ * ## Using `BrowseTheWeb` with an existing Playwright `page`
+ *
+ * Test runners like [Playwright Test](/api/playwright-test/) manage Playwright browsers for you
+ * and offer a [`page`](https://playwright.dev/docs/api/class-page) instance you can
+ * inject into the ability to {@apilink BrowseTheWebWithPlaywright}.
+ *
+ * Note that [Serenity/JS Playwright Test module](/api/playwright-test/)
+ * automatically configures all your {@apilink Actor|actors}
+ * with an ability to {@apilink BrowseTheWebWithPlaywright},
+ * so you don't need to do it by hand unless you want to override the {@apilink SerenityOptions|default configuration}.
+ *
+ * The example below demonstrates how to use the {@apilink BrowseTheWebWithPlaywright.usingPage} API and
+ * override the default {@apilink Cast} of actors.
+ *
+ * ```ts title="specs/example.spec.ts"
+ * import { describe, it, test } from '@playwright/playwright-test'
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright'
+ * import { By, Navigate, PageElement, Text } from '@serenity-js/web'
+ * import { Ensure, equals } from '@serenity-js/assertions'
+ *
+ * const HomePage = {
+ *   title: () =>
+ *     PageElement.located(By.css('h1')).describedAs('title')
+ * }
+ *
+ * describe('Serenity/JS with Playwright', () => {
+ *
+ *   test.use({
+ *     actors: async ({ page, contextOptions }, use) => {
+ *       await use(
+ *         Cast.where((actorName: string) => {
+ *           return actor.whoCan(
+ *             BrowseTheWebWithPlaywright.usingPage(page),
+ *             // ... add any other abilities
+ *           )
+ *         })
+ *       )
+ *     }
+ *   })
+ *
+ *   it('lets you reuse an existing page', async ({ actor }) => {
+ *     await actor.attemptsTo(
+ *       Navigate.to(`https://serenity-js.org`),
+ *       Ensure.that(Text.of(HomePage.title()), equals('Serenity/JS')),
+ *     )
+ *   })
+ * })
+ * ```
+ *
  * ## Learn more
  * - [Playwright website](https://playwright.dev/)
  * - {@apilink BrowseTheWeb}
@@ -45,11 +104,11 @@ import { PlaywrightBrowsingSession } from '../models';
 export class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.Locator> implements Discardable {
 
     static using(browser: playwright.Browser, options?: PlaywrightOptions): BrowseTheWebWithPlaywright {
-        return new BrowseTheWebWithPlaywright(browser, options);
+        return new BrowseTheWebWithPlaywright(new PlaywrightBrowsingSessionWithBrowser(browser, options));
     }
 
-    constructor(protected readonly browser: playwright.Browser, browserContextOptions: PlaywrightOptions = {}) {
-        super(new PlaywrightBrowsingSession(browser, browserContextOptions));
+    static usingPage(page: playwright.Page, options?: PlaywrightOptions): BrowseTheWebWithPlaywright {
+        return new BrowseTheWebWithPlaywright(new PlaywrightBrowsingSessionWithPage(page, options));
     }
 
     /**
@@ -62,19 +121,4 @@ export class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.Locator>
     async discard(): Promise<void> {
         await this.session.closeAllPages();
     }
-
-    /**
-     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this ability.
-     *
-     * **Please note** that since Playwright does not expose information about the operating system
-     * the tests are running on, **Serenity/JS assumes that the tests are running locally**
-     * and therefore returns the value of Node.js `process.platform` for `platformName`.
-     */
-    async browserCapabilities(): Promise<BrowserCapabilities> {
-        return {
-            browserName: (this.browser as any)._initializer.name,   // todo: raise a PR to Playwright to expose this information
-            platformName: process.platform,                         // todo: get the actual platform from Playwright
-            browserVersion: this.browser.version()
-        }
-    }
 }

package/src/screenplay/models/PlaywrightBrowsingSession.ts

@@ -1,9 +1,9 @@
 import { CorrelationId } from '@serenity-js/core/lib/model';
-import type { Cookie, CookieData } from '@serenity-js/web';
-import { BrowsingSession } from '@serenity-js/web';
+import type { BrowserCapabilities } from '@serenity-js/web';
+import { BrowsingSession, type Cookie, type CookieData } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
 
-import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { type PlaywrightOptions } from '../../PlaywrightOptions';
 import { PlaywrightCookie, PlaywrightPage } from '../models';
 
 /**
@@ -11,40 +11,22 @@ import { PlaywrightCookie, PlaywrightPage } from '../models';
  *
  * @group Models
  */
-export class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
+export abstract class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
 
     private currentPlaywrightBrowserContext: playwright.BrowserContext;
 
-    constructor(
-        protected readonly browser: playwright.Browser,
-        protected readonly browserContextOptions: PlaywrightOptions,
-    ) {
+    protected constructor(protected readonly browserContextOptions: PlaywrightOptions) {
         super();
     }
 
-    protected async registerCurrentPage(): Promise<PlaywrightPage> {
-        const context = await this.browserContext();
-
-        await context.newPage();
-
-        // calling context.newPage() triggers a callback registered via browserContext(),
-        // which wraps playwright.Page in PlaywrightPage and adds it to the list of pages
-        // returned by this.allPages()
-
-        const allPages = await this.allPages()
-
-        return allPages.at(-1);
-    }
-
     /**
-     * @override
+     * Returns {@apilink BrowserCapabilities|basic meta-data} about the browser associated with this ability.
+     *
+     * **Please note** that since Playwright does not expose information about the operating system
+     * the tests are running on, **Serenity/JS assumes that the tests are running locally**
+     * and therefore returns the value of Node.js `process.platform` for `platformName`.
      */
-    async closeAllPages(): Promise<void> {
-        await super.closeAllPages();
-
-        const context = await this.browserContext();
-        await context.close();
-    }
+    public abstract browserCapabilities(): Promise<BrowserCapabilities>;
 
     async cookie(name: string): Promise<Cookie> {
         const context = await this.browserContext();
@@ -62,9 +44,23 @@ export class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
         await context.clearCookies();
     }
 
-    private async browserContext(): Promise<playwright.BrowserContext> {
+    protected override async registerCurrentPage(): Promise<PlaywrightPage> {
+        const context = await this.browserContext();
+
+        await context.newPage();
+
+        // calling context.newPage() triggers a callback registered via browserContext(),
+        // which wraps playwright.Page in PlaywrightPage and adds it to the list of pages
+        // returned by this.allPages()
+
+        const allPages = await this.allPages()
+
+        return allPages.at(-1);
+    }
+
+    protected async browserContext(): Promise<playwright.BrowserContext> {
         if (! this.currentPlaywrightBrowserContext) {
-            this.currentPlaywrightBrowserContext = await this.browser.newContext(this.browserContextOptions);
+            this.currentPlaywrightBrowserContext = await this.createBrowserContext(this.browserContextOptions);
 
             this.currentPlaywrightBrowserContext.on('page', async page => {
                 this.register(
@@ -83,4 +79,6 @@ export class PlaywrightBrowsingSession extends BrowsingSession<PlaywrightPage> {
 
         return this.currentPlaywrightBrowserContext;
     }
+
+    protected abstract createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext>;
 }

package/src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts

@@ -0,0 +1,33 @@
+import type { BrowserCapabilities } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+
+import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession';
+
+export class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession {
+    constructor(
+        protected readonly browser: playwright.Browser,
+        browserContextOptions: PlaywrightOptions,
+    ) {
+        super(browserContextOptions);
+    }
+
+    protected override createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext> {
+        return this.browser.newContext(this.browserContextOptions);
+    }
+
+    override async closeAllPages(): Promise<void> {
+        await super.closeAllPages();
+
+        const context = await this.browserContext();
+        await context.close();
+    }
+
+    override async browserCapabilities(): Promise<BrowserCapabilities> {
+        return {
+            browserName: (this.browser as any)._initializer.name,   // todo: raise a PR to Playwright to expose this information
+            platformName: process.platform,                         // todo: get the actual platform from Playwright
+            browserVersion: this.browser.version()
+        }
+    }
+}

package/src/screenplay/models/PlaywrightBrowsingSessionWithPage.ts

@@ -0,0 +1,31 @@
+import { CorrelationId } from '@serenity-js/core/lib/model';
+import type { BrowserCapabilities } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+
+import type { PlaywrightOptions } from '../../PlaywrightOptions';
+import { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession';
+import { PlaywrightPage } from './PlaywrightPage';
+
+export class PlaywrightBrowsingSessionWithPage extends PlaywrightBrowsingSession {
+    constructor(
+        protected readonly page: playwright.Page,
+        browserContextOptions: PlaywrightOptions,
+    ) {
+        super(browserContextOptions);
+        this.currentBrowserPage = new PlaywrightPage(this, this.page, this.browserContextOptions, CorrelationId.create());
+    }
+
+    protected override async createBrowserContext(options: PlaywrightOptions): Promise<playwright.BrowserContext> {
+        return this.page.context();
+    }
+
+    override async browserCapabilities(): Promise<BrowserCapabilities> {
+        const browser = await this.page.context().browser();
+        return {
+            browserName: (browser as any)._initializer.name,   // todo: raise a PR to Playwright to expose this information
+            platformName: process.platform,                    // todo: get the actual platform from Playwright
+            browserVersion: browser.version()
+        }
+    }
+}
+

package/src/screenplay/models/PlaywrightPage.ts

@@ -1,15 +1,14 @@
-import type { QuestionAdapter } from '@serenity-js/core';
-import { LogicError } from '@serenity-js/core';
+import { LogicError, type QuestionAdapter } from '@serenity-js/core';
 import { asyncMap } from '@serenity-js/core/lib/io';
 import type { CorrelationId } from '@serenity-js/core/lib/model';
 import type { Cookie, CookieData, PageElement, Selector } from '@serenity-js/web';
-import { Key, Page, PageElements } from '@serenity-js/web';
+import { ByDeepCss, Key, Page, PageElements } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
 import { URL } from 'url';
 
 import type { PlaywrightOptions } from '../../PlaywrightOptions';
 import { promised } from '../promised';
-import { PlaywrightLocator, PlaywrightRootLocator } from './locators';
+import { PlaywrightExistingElementLocator, PlaywrightLocator, PlaywrightRootLocator } from './locators';
 import type { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession';
 import { PlaywrightModalDialogHandler } from './PlaywrightModalDialogHandler';
 import { PlaywrightPageElement } from './PlaywrightPageElement';
@@ -41,6 +40,16 @@ export class PlaywrightPage extends Page<playwright.Locator> {
         );
     }
 
+    createPageElement(nativeElement: playwright.Locator): PageElement<playwright.Locator> {
+        return new PlaywrightPageElement(
+            new PlaywrightExistingElementLocator(
+                this.rootLocator,
+                new ByDeepCss((nativeElement as any)._selector),
+                nativeElement,
+            )
+        );
+    }
+
     locate(selector: Selector): PageElement<playwright.Locator> {
         return new PlaywrightPageElement(
             new PlaywrightLocator(

package/src/screenplay/models/index.ts

@@ -1,5 +1,7 @@
 export * from './locators';
 export * from './PlaywrightBrowsingSession';
+export * from './PlaywrightBrowsingSessionWithBrowser';
+export * from './PlaywrightBrowsingSessionWithPage';
 export * from './PlaywrightCookie';
 export * from './PlaywrightPage';
 export * from './PlaywrightPageElement';

package/src/screenplay/models/locators/PlaywrightLocator.ts

@@ -105,7 +105,7 @@ export class PlaywrightLocator extends Locator<playwright.Locator, string> {
 
         return elements.map(childElement =>
             new PlaywrightPageElement(
-                new ExistingElementLocator(
+                new PlaywrightExistingElementLocator(
                     this.parent as PlaywrightRootLocator,
                     this.selector,
                     childElement,
@@ -116,9 +116,9 @@ export class PlaywrightLocator extends Locator<playwright.Locator, string> {
 }
 
 /**
- * @private
+ * @internal
  */
-class ExistingElementLocator extends PlaywrightLocator {
+export class PlaywrightExistingElementLocator extends PlaywrightLocator {
     constructor(
         parent: RootLocator<playwright.Locator>,
         selector: Selector,