@serenity-js/playwright 3.42.2 → 3.43.0

package/esm/screenplay/models/SelfLaunchingPlaywrightBrowsingSessionWithElectron.js

@@ -0,0 +1,70 @@
+import * as playwright from 'playwright-core';
+import { PlaywrightBrowsingSessionWithElectron } from './PlaywrightBrowsingSessionWithElectron.js';
+/**
+ * Self-launching implementation of [`PlaywrightBrowsingSession`](https://serenity-js.org/api/playwright/class/PlaywrightBrowsingSession/)
+ * for Electron applications.
+ *
+ * This class launches the Electron application on first use and closes it when discarded.
+ * Use this for test runners like Mocha or Jasmine that don't manage Electron lifecycle.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core';
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+ *
+ * const actor = actorCalled('Tester').whoCan(
+ *     BrowseTheWebWithPlaywright.launchingElectronApp({
+ *         args: ['path/to/main.js'],
+ *         cwd: 'path/to/app',
+ *     })
+ * );
+ *
+ * // The app is automatically closed when the actor is dismissed
+ * ```
+ *
+ * @group Models
+ */
+export class SelfLaunchingPlaywrightBrowsingSessionWithElectron extends PlaywrightBrowsingSessionWithElectron {
+    launchOptions;
+    constructor(launchOptions, extraBrowserContextOptions, selectors) {
+        // setting electronApp to undefined since it's lazily initialised
+        super(undefined, extraBrowserContextOptions, selectors);
+        this.launchOptions = launchOptions;
+    }
+    /**
+     * Launches the Electron application using the configured launch options.
+     *
+     * This method is idempotent - calling it multiple times will only launch
+     * the application once.
+     */
+    async initialise() {
+        if (this.electronApp) {
+            return;
+        }
+        this.electronApp = await playwright._electron.launch(this.launchOptions);
+        this.currentBrowserPage = await this.registerCurrentPage();
+    }
+    /**
+     * Returns `true` if the Electron application has been launched.
+     */
+    isInitialised() {
+        return this.electronApp !== undefined;
+    }
+    /**
+     * Closes the Electron application that was launched by this session.
+     * Called when the ability is discarded.
+     */
+    async closeElectronApp() {
+        if (this.electronApp) {
+            await this.electronApp.close();
+            this.electronApp = undefined;
+        }
+    }
+    async discard() {
+        await this.closeElectronApp();
+        this.pages.clear();
+        this.currentBrowserPage = undefined;
+    }
+}
+//# sourceMappingURL=SelfLaunchingPlaywrightBrowsingSessionWithElectron.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SelfLaunchingPlaywrightBrowsingSessionWithElectron.js","sourceRoot":"","sources":["../../../src/screenplay/models/SelfLaunchingPlaywrightBrowsingSessionWithElectron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAI9C,OAAO,EAAE,qCAAqC,EAAE,MAAM,4CAA4C,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,kDACT,SAAQ,qCAAqC;IAIxB;IADrB,YACqB,aAAoC,EACrD,0BAA+D,EAC/D,SAA+B;QAE/B,iEAAiE;QACjE,KAAK,CAAC,SAAS,EAAE,0BAA0B,EAAE,SAAS,CAAC,CAAC;QALvC,kBAAa,GAAb,aAAa,CAAuB;IAMzD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzE,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB;QAClB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QACjC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE9B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACxC,CAAC;CACJ"}

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

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

package/esm/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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yDAAyD,CAAC"}

package/esm/screenplay/models/index.js

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

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/screenplay/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wCAAwC,CAAC;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yDAAyD,CAAC"}

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

@@ -1,7 +1,8 @@
-import type { Discardable } from '@serenity-js/core';
+import { Discardable, Initialisable } from '@serenity-js/core';
 import { BrowseTheWeb } from '@serenity-js/web';
 import * as playwright from 'playwright-core';
 import type { ExtraBrowserContextOptions } from '../../ExtraBrowserContextOptions.js';
+import { type ElectronLaunchOptions } from '../models/index.js';
 /**
  * This implementation of the [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
  * enables the [`Actor`](https://serenity-js.org/api/core/class/Actor/) to interact with web front-ends using [Playwright](https://playwright.dev/).
@@ -148,12 +149,69 @@ import type { ExtraBrowserContextOptions } from '../../ExtraBrowserContextOption
  *
  * @group Abilities
  */
-export declare class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.Locator> implements Discardable {
+export declare class BrowseTheWebWithPlaywright extends BrowseTheWeb<playwright.Locator> implements Initialisable, Discardable {
     static using(browser: playwright.Browser, browserContextOptions?: playwright.BrowserContextOptions, extraBrowserContextOptions?: ExtraBrowserContextOptions): BrowseTheWebWithPlaywright;
     static usingPage(page: playwright.Page, extraBrowserContextOptions?: ExtraBrowserContextOptions): BrowseTheWebWithPlaywright;
+    /**
+     * Creates an ability to browse the web using an already-launched Electron application.
+     *
+     * Use this method when the Electron application lifecycle is managed externally,
+     * such as in Playwright Test where the app is launched per-worker.
+     *
+     * ## Example
+     *
+     * ```ts
+     * import { _electron as electron } from 'playwright';
+     * import { actorCalled } from '@serenity-js/core';
+     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+     *
+     * const electronApp = await electron.launch({ args: ['main.js'] });
+     *
+     * const actor = actorCalled('Tester').whoCan(
+     *     BrowseTheWebWithPlaywright.usingElectronApp(electronApp)
+     * );
+     *
+     * // After tests, close the app manually
+     * await electronApp.close();
+     * ```
+     *
+     * @param electronApp - An already-launched Playwright ElectronApplication instance
+     * @param extraBrowserContextOptions - Optional configuration for timeouts and navigation
+     */
+    static usingElectronApp(electronApp: playwright.ElectronApplication, extraBrowserContextOptions?: ExtraBrowserContextOptions): BrowseTheWebWithPlaywright;
+    /**
+     * Creates an ability to browse the web by launching and managing an Electron application.
+     *
+     * Use this method when you want Serenity/JS to manage the Electron application lifecycle.
+     * The app is launched on first use and closed when the ability is discarded.
+     *
+     * ## Example
+     *
+     * ```typescript
+     * import { actorCalled } from '@serenity-js/core';
+     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+     *
+     * const actor = actorCalled('Tester').whoCan(
+     *     BrowseTheWebWithPlaywright.launchingElectronApp({
+     *         args: ['path/to/main.js'],
+     *         cwd: 'path/to/app',
+     *     })
+     * );
+     *
+     * // The app is automatically closed when the actor is dismissed
+     * ```
+     *
+     * @param launchOptions - Options for launching the Electron application
+     * @param extraBrowserContextOptions - Optional configuration for timeouts and navigation
+     */
+    static launchingElectronApp(launchOptions: ElectronLaunchOptions, extraBrowserContextOptions?: ExtraBrowserContextOptions): BrowseTheWebWithPlaywright;
+    initialise(): Promise<void>;
+    isInitialised(): boolean;
     /**
      * Automatically closes any open [pages](https://serenity-js.org/api/web/class/Page/) when the [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/)
      *
+     * For self-launching Electron sessions, also closes the Electron application.
+     *
      * #### Learn more
      * - [`PlaywrightBrowsingSession.closeAllPages`](https://serenity-js.org/api/playwright/class/PlaywrightBrowsingSession/#closeAllPages)
      * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)

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,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAMtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiJG;AACH,qBAAa,0BAA2B,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,CAAE,YAAW,WAAW;IAEnG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,EAAE,UAAU,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,EAAE,0BAA0B,GAAG,0BAA0B;IAIxL,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,0BAA0B,CAAC,EAAE,0BAA0B,GAAG,0BAA0B;IAI5H;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}
+{"version":3,"file":"BrowseTheWebWithPlaywright.d.ts","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EACH,KAAK,qBAAqB,EAK7B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiJG;AACH,qBAAa,0BACT,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,CACvC,YAAW,aAAa,EAAE,WAAW;IAErC,MAAM,CAAC,KAAK,CACR,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,qBAAqB,CAAC,EAAE,UAAU,CAAC,qBAAqB,EACxD,0BAA0B,CAAC,EAAE,0BAA0B,GACxD,0BAA0B;IAI7B,MAAM,CAAC,SAAS,CACZ,IAAI,EAAE,UAAU,CAAC,IAAI,EACrB,0BAA0B,CAAC,EAAE,0BAA0B,GACxD,0BAA0B;IAI7B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,gBAAgB,CACnB,WAAW,EAAE,UAAU,CAAC,mBAAmB,EAC3C,0BAA0B,CAAC,EAAE,0BAA0B,GACxD,0BAA0B;IAU7B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,oBAAoB,CACvB,aAAa,EAAE,qBAAqB,EACpC,0BAA0B,CAAC,EAAE,0BAA0B,GACxD,0BAA0B;IAUvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,aAAa,IAAI,OAAO;IAMxB;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAKjC"}

package/lib/screenplay/abilities/BrowseTheWebWithPlaywright.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BrowseTheWebWithPlaywright = void 0;
+const core_1 = require("@serenity-js/core");
 const web_1 = require("@serenity-js/web");
 const playwright = __importStar(require("playwright-core"));
 const index_js_1 = require("../models/index.js");
@@ -190,15 +191,86 @@ class BrowseTheWebWithPlaywright extends web_1.BrowseTheWeb {
     static usingPage(page, extraBrowserContextOptions) {
         return new BrowseTheWebWithPlaywright(new index_js_1.PlaywrightBrowsingSessionWithPage(page, extraBrowserContextOptions, playwright.selectors));
     }
+    /**
+     * Creates an ability to browse the web using an already-launched Electron application.
+     *
+     * Use this method when the Electron application lifecycle is managed externally,
+     * such as in Playwright Test where the app is launched per-worker.
+     *
+     * ## Example
+     *
+     * ```ts
+     * import { _electron as electron } from 'playwright';
+     * import { actorCalled } from '@serenity-js/core';
+     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+     *
+     * const electronApp = await electron.launch({ args: ['main.js'] });
+     *
+     * const actor = actorCalled('Tester').whoCan(
+     *     BrowseTheWebWithPlaywright.usingElectronApp(electronApp)
+     * );
+     *
+     * // After tests, close the app manually
+     * await electronApp.close();
+     * ```
+     *
+     * @param electronApp - An already-launched Playwright ElectronApplication instance
+     * @param extraBrowserContextOptions - Optional configuration for timeouts and navigation
+     */
+    static usingElectronApp(electronApp, extraBrowserContextOptions) {
+        return new BrowseTheWebWithPlaywright(new index_js_1.PlaywrightBrowsingSessionWithElectron(electronApp, extraBrowserContextOptions ?? {}, playwright.selectors));
+    }
+    /**
+     * Creates an ability to browse the web by launching and managing an Electron application.
+     *
+     * Use this method when you want Serenity/JS to manage the Electron application lifecycle.
+     * The app is launched on first use and closed when the ability is discarded.
+     *
+     * ## Example
+     *
+     * ```typescript
+     * import { actorCalled } from '@serenity-js/core';
+     * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+     *
+     * const actor = actorCalled('Tester').whoCan(
+     *     BrowseTheWebWithPlaywright.launchingElectronApp({
+     *         args: ['path/to/main.js'],
+     *         cwd: 'path/to/app',
+     *     })
+     * );
+     *
+     * // The app is automatically closed when the actor is dismissed
+     * ```
+     *
+     * @param launchOptions - Options for launching the Electron application
+     * @param extraBrowserContextOptions - Optional configuration for timeouts and navigation
+     */
+    static launchingElectronApp(launchOptions, extraBrowserContextOptions) {
+        return new BrowseTheWebWithPlaywright(new index_js_1.SelfLaunchingPlaywrightBrowsingSessionWithElectron(launchOptions, extraBrowserContextOptions ?? {}, playwright.selectors));
+    }
+    async initialise() {
+        if (core_1.Initialisable.isInitialisable(this.session)) {
+            await this.session.initialise();
+        }
+    }
+    isInitialised() {
+        return core_1.Initialisable.isInitialisable(this.session)
+            ? this.session.isInitialised()
+            : true;
+    }
     /**
      * Automatically closes any open [pages](https://serenity-js.org/api/web/class/Page/) when the [SceneFinishes](https://serenity-js.org/api/core-events/class/SceneFinishes/)
      *
+     * For self-launching Electron sessions, also closes the Electron application.
+     *
      * #### Learn more
      * - [`PlaywrightBrowsingSession.closeAllPages`](https://serenity-js.org/api/playwright/class/PlaywrightBrowsingSession/#closeAllPages)
      * - [`Discardable`](https://serenity-js.org/api/core/interface/Discardable/)
      */
     async discard() {
-        await this.session.closeAllPages();
+        if (core_1.Discardable.isDiscardable(this.session)) {
+            await this.session.discard();
+        }
     }
 }
 exports.BrowseTheWebWithPlaywright = BrowseTheWebWithPlaywright;

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

@@ -1 +1 @@
-{"version":3,"file":"BrowseTheWebWithPlaywright.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,0CAAgD;AAChD,4DAA8C;AAG9C,iDAG4B;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiJG;AACH,MAAa,0BAA2B,SAAQ,kBAAgC;IAE5E,MAAM,CAAC,KAAK,CAAC,OAA2B,EAAE,qBAAwD,EAAE,0BAAuD;QACvJ,OAAO,IAAI,0BAA0B,CAAC,IAAI,+CAAoC,CAAC,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACtK,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,IAAqB,EAAE,0BAAuD;QAC3F,OAAO,IAAI,0BAA0B,CAAC,IAAI,4CAAiC,CAAC,IAAI,EAAE,0BAA0B,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACzI,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACvC,CAAC;CACJ;AApBD,gEAoBC"}
+{"version":3,"file":"BrowseTheWebWithPlaywright.js","sourceRoot":"","sources":["../../../src/screenplay/abilities/BrowseTheWebWithPlaywright.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA+D;AAC/D,0CAAgD;AAChD,4DAA8C;AAG9C,iDAM4B;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiJG;AACH,MAAa,0BACT,SAAQ,kBAAgC;IAGxC,MAAM,CAAC,KAAK,CACR,OAA2B,EAC3B,qBAAwD,EACxD,0BAAuD;QAEvD,OAAO,IAAI,0BAA0B,CAAC,IAAI,+CAAoC,CAAC,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACtK,CAAC;IAED,MAAM,CAAC,SAAS,CACZ,IAAqB,EACrB,0BAAuD;QAEvD,OAAO,IAAI,0BAA0B,CAAC,IAAI,4CAAiC,CAAC,IAAI,EAAE,0BAA0B,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IACzI,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,MAAM,CAAC,gBAAgB,CACnB,WAA2C,EAC3C,0BAAuD;QAEvD,OAAO,IAAI,0BAA0B,CACjC,IAAI,gDAAqC,CACrC,WAAW,EACX,0BAA0B,IAAI,EAAE,EAChC,UAAU,CAAC,SAAS,CACvB,CACJ,CAAC;IACN,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,oBAAoB,CACvB,aAAoC,EACpC,0BAAuD;QAEvD,OAAO,IAAI,0BAA0B,CACjC,IAAI,6DAAkD,CAClD,aAAa,EACb,0BAA0B,IAAI,EAAE,EAChC,UAAU,CAAC,SAAS,CACvB,CACJ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,IAAI,oBAAa,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;IACL,CAAC;IAED,aAAa;QACT,OAAO,oBAAa,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;YAC9B,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO;QACT,IAAI,kBAAW,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;IACL,CAAC;CACJ;AA1HD,gEA0HC"}

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

@@ -0,0 +1,55 @@
+import type * as playwright from 'playwright-core';
+/**
+ * Options for launching an Electron application via Playwright.
+ *
+ * This type re-exports Playwright's Electron launch options with additional documentation
+ * for commonly used properties.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * import { actorCalled } from '@serenity-js/core';
+ * import { BrowseTheWebWithPlaywright, ElectronLaunchOptions } from '@serenity-js/playwright';
+ *
+ * const options: ElectronLaunchOptions = {
+ *     executablePath: '/path/to/electron',
+ *     args: ['main.js'],
+ *     cwd: '/path/to/app',
+ *     env: { NODE_ENV: 'test' },
+ *     timeout: 30000,
+ * };
+ *
+ * const actor = actorCalled('Tester').whoCan(
+ *     BrowseTheWebWithPlaywright.launchingElectronApp(options)
+ * );
+ * ```
+ *
+ * ## Common Options
+ *
+ * - **executablePath**: Path to the Electron executable. If not specified, uses the default
+ *   Electron installed in `node_modules/.bin/electron`.
+ * - **args**: Command-line arguments passed to the application. Typically includes the path
+ *   to the main script (e.g., `['main.js']`).
+ * - **cwd**: Current working directory for the Electron process.
+ * - **env**: Environment variables visible to the Electron process. Defaults to `process.env`.
+ * - **timeout**: Maximum time in milliseconds to wait for the application to start.
+ *   Defaults to 30000 (30 seconds). Pass 0 to disable timeout.
+ *
+ * ## Additional Options
+ *
+ * - **acceptDownloads**: Whether to automatically download all attachments. Defaults to `true`.
+ * - **bypassCSP**: Toggles bypassing page's Content-Security-Policy. Defaults to `false`.
+ * - **colorScheme**: Emulates `prefers-colors-scheme` media feature. Supported values are `'light'`, `'dark'`, and `'no-preference'`.
+ * - **locale**: Specify user locale, for example `en-GB`, `de-DE`, etc.
+ * - **offline**: Whether to emulate network being offline. Defaults to `false`.
+ * - **recordVideo**: Enables video recording for all pages.
+ * - **timezoneId**: Changes the timezone of the context.
+ *
+ * ## Learn more
+ * - [Playwright Electron API](https://playwright.dev/docs/api/class-electron)
+ * - [Electron Testing with Playwright](https://playwright.dev/docs/electron)
+ *
+ * @group Configuration
+ */
+export type ElectronLaunchOptions = Parameters<typeof playwright._electron.launch>[0];
+//# sourceMappingURL=ElectronLaunchOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronLaunchOptions.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/ElectronLaunchOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/lib/screenplay/models/ElectronLaunchOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ElectronLaunchOptions.js.map

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

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

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

@@ -1,3 +1,4 @@
+import type { Discardable } from '@serenity-js/core';
 import type { BrowserCapabilities } from '@serenity-js/web';
 import type * as playwright from 'playwright-core';
 import type { ExtraBrowserContextOptions } from '../../ExtraBrowserContextOptions.js';
@@ -6,13 +7,13 @@ import type { PlaywrightPage } from './PlaywrightPage.js';
 /**
  *  @group Models
  */
-export declare class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession {
+export declare class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession implements Discardable {
     protected readonly browser: playwright.Browser;
     protected readonly browserContextOptions: playwright.BrowserContextOptions;
     constructor(browser: playwright.Browser, browserContextOptions: playwright.BrowserContextOptions, extraBrowserContextOptions: ExtraBrowserContextOptions, selectors: playwright.Selectors);
     protected createBrowserContext(): Promise<playwright.BrowserContext>;
     protected registerCurrentPage(): Promise<PlaywrightPage>;
-    closeAllPages(): Promise<void>;
     browserCapabilities(): Promise<BrowserCapabilities>;
+    discard(): Promise<void>;
 }
 //# sourceMappingURL=PlaywrightBrowsingSessionWithBrowser.d.ts.map

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

@@ -1 +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,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,yBAAyB;IAG3E,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO;IAC9C,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,UAAU,CAAC,qBAAqB;gBADvD,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,EAC1E,0BAA0B,EAAE,0BAA0B,EACtD,SAAS,EAAE,UAAU,CAAC,SAAS;cAKV,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;cAI1D,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;IAcxD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAOrE"}
+{"version":3,"file":"PlaywrightBrowsingSessionWithBrowser.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,qBAAa,oCACT,SAAQ,yBACR,YAAW,WAAW;IAIlB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO;IAC9C,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,UAAU,CAAC,qBAAqB;gBADvD,OAAO,EAAE,UAAU,CAAC,OAAO,EAC3B,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,EAC1E,0BAA0B,EAAE,0BAA0B,EACtD,SAAS,EAAE,UAAU,CAAC,SAAS;cAKV,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;cAK1D,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;IAcxD,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAQ5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAMjC"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithBrowser.js

@@ -14,6 +14,7 @@ class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession_js_
         this.browserContextOptions = browserContextOptions;
     }
     async createBrowserContext() {
+        // todo: move to initialise?
         return this.browser.newContext(this.browserContextOptions);
     }
     async registerCurrentPage() {
@@ -25,11 +26,6 @@ class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession_js_
         const allPages = await this.allPages();
         return allPages.at(-1);
     }
-    async closeAllPages() {
-        await super.closeAllPages();
-        const context = await this.browserContext();
-        await context.close();
-    }
     async browserCapabilities() {
         return {
             browserName: this.browser._initializer.name, // todo: raise a PR to Playwright to expose this information
@@ -37,6 +33,11 @@ class PlaywrightBrowsingSessionWithBrowser extends PlaywrightBrowsingSession_js_
             browserVersion: this.browser.version()
         };
     }
+    async discard() {
+        await this.closeAllPages();
+        const context = await this.browserContext();
+        await context.close();
+    }
 }
 exports.PlaywrightBrowsingSessionWithBrowser = PlaywrightBrowsingSessionWithBrowser;
 //# sourceMappingURL=PlaywrightBrowsingSessionWithBrowser.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"PlaywrightBrowsingSessionWithBrowser.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts"],"names":[],"mappings":";;;AAIA,iFAA2E;AAG3E;;GAEG;AACH,MAAa,oCAAqC,SAAQ,wDAAyB;IAGxD;IACA;IAFvB,YACuB,OAA2B,EAC3B,qBAAuD,EAC1E,0BAAsD,EACtD,SAA+B;QAE/B,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;QAL1B,YAAO,GAAP,OAAO,CAAoB;QAC3B,0BAAqB,GAArB,qBAAqB,CAAkC;IAK9E,CAAC;IAEkB,KAAK,CAAC,oBAAoB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/D,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;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,EAAI,4DAA4D;YACpH,YAAY,EAAE,OAAO,CAAC,QAAQ,EAA0B,gDAAgD;YACxG,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;SACzC,CAAA;IACL,CAAC;CACJ;AA3CD,oFA2CC"}
+{"version":3,"file":"PlaywrightBrowsingSessionWithBrowser.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithBrowser.ts"],"names":[],"mappings":";;;AAKA,iFAA2E;AAG3E;;GAEG;AACH,MAAa,oCACT,SAAQ,wDAAyB;IAKV;IACA;IAFvB,YACuB,OAA2B,EAC3B,qBAAuD,EAC1E,0BAAsD,EACtD,SAA+B;QAE/B,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;QAL1B,YAAO,GAAP,OAAO,CAAoB;QAC3B,0BAAqB,GAArB,qBAAqB,CAAkC;IAK9E,CAAC;IAEkB,KAAK,CAAC,oBAAoB;QACzC,4BAA4B;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/D,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;IAEQ,KAAK,CAAC,mBAAmB;QAC9B,OAAO;YACH,WAAW,EAAG,IAAI,CAAC,OAAe,CAAC,YAAY,CAAC,IAAI,EAAI,4DAA4D;YACpH,YAAY,EAAE,OAAO,CAAC,QAAQ,EAA0B,gDAAgD;YACxG,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;SACzC,CAAA;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACJ;AA/CD,oFA+CC"}

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

@@ -0,0 +1,52 @@
+import type { BrowserCapabilities } from '@serenity-js/web';
+import type * as playwright from 'playwright-core';
+import type { ExtraBrowserContextOptions } from '../../ExtraBrowserContextOptions.js';
+import { PlaywrightBrowsingSession } from './PlaywrightBrowsingSession.js';
+import { PlaywrightPage } from './PlaywrightPage.js';
+/**
+ * Playwright-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/)
+ * for Electron applications.
+ *
+ * Use this class when you have an already-launched `ElectronApplication` instance,
+ * typically in Playwright Test scenarios where the app is managed per-worker.
+ *
+ * ## Example
+ *
+ * ```ts
+ * import { _electron as electron } from 'playwright';
+ * import { actorCalled } from '@serenity-js/core';
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+ *
+ * const electronApp = await electron.launch({ args: ['main.js'] });
+ *
+ * const actor = actorCalled('Tester').whoCan(
+ *     BrowseTheWebWithPlaywright.usingElectronApp(electronApp)
+ * );
+ *
+ * // After tests, close the app manually
+ * await electronApp.close();
+ * ```
+ *
+ * @group Models
+ */
+export declare class PlaywrightBrowsingSessionWithElectron extends PlaywrightBrowsingSession {
+    protected electronApp: playwright.ElectronApplication;
+    constructor(electronApp: playwright.ElectronApplication, extraBrowserContextOptions: Partial<ExtraBrowserContextOptions>, selectors: playwright.Selectors);
+    protected createBrowserContext(): Promise<playwright.BrowserContext>;
+    protected registerCurrentPage(): Promise<PlaywrightPage>;
+    /**
+     * Closes all Electron windows but does NOT close the Electron application itself.
+     * The application lifecycle is managed externally.
+     */
+    closeAllPages(): Promise<void>;
+    /**
+     * Returns [basic meta-data](https://serenity-js.org/api/web/interface/BrowserCapabilities/) about the Electron application.
+     *
+     * **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>;
+    private getElectronVersion;
+}
+//# sourceMappingURL=PlaywrightBrowsingSessionWithElectron.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithElectron.d.ts","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithElectron.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qCAAsC,SAAQ,yBAAyB;IAG5E,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,mBAAmB;gBAA3C,WAAW,EAAE,UAAU,CAAC,mBAAmB,EACrD,0BAA0B,EAAE,OAAO,CAAC,0BAA0B,CAAC,EAC/D,SAAS,EAAE,UAAU,CAAC,SAAS;cAKV,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;cAI1D,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;IA2CvE;;;OAGG;IACY,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7C;;;;;;OAMG;IACY,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;YAQpD,kBAAkB;CAWnC"}

package/lib/screenplay/models/PlaywrightBrowsingSessionWithElectron.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaywrightBrowsingSessionWithElectron = void 0;
+const model_1 = require("@serenity-js/core/model");
+const PlaywrightBrowsingSession_js_1 = require("./PlaywrightBrowsingSession.js");
+const PlaywrightPage_js_1 = require("./PlaywrightPage.js");
+/**
+ * Playwright-specific implementation of [`BrowsingSession`](https://serenity-js.org/api/web/class/BrowsingSession/)
+ * for Electron applications.
+ *
+ * Use this class when you have an already-launched `ElectronApplication` instance,
+ * typically in Playwright Test scenarios where the app is managed per-worker.
+ *
+ * ## Example
+ *
+ * ```ts
+ * import { _electron as electron } from 'playwright';
+ * import { actorCalled } from '@serenity-js/core';
+ * import { BrowseTheWebWithPlaywright } from '@serenity-js/playwright';
+ *
+ * const electronApp = await electron.launch({ args: ['main.js'] });
+ *
+ * const actor = actorCalled('Tester').whoCan(
+ *     BrowseTheWebWithPlaywright.usingElectronApp(electronApp)
+ * );
+ *
+ * // After tests, close the app manually
+ * await electronApp.close();
+ * ```
+ *
+ * @group Models
+ */
+class PlaywrightBrowsingSessionWithElectron extends PlaywrightBrowsingSession_js_1.PlaywrightBrowsingSession {
+    electronApp;
+    constructor(electronApp, extraBrowserContextOptions, selectors) {
+        super(extraBrowserContextOptions, selectors);
+        this.electronApp = electronApp;
+    }
+    async createBrowserContext() {
+        return this.electronApp.context();
+    }
+    async registerCurrentPage() {
+        // Ensure browser context is initialized before accessing windows
+        await this.browserContext();
+        const windows = this.electronApp.windows();
+        let targetPage;
+        if (windows.length === 0) {
+            // Wait for the first window to open
+            targetPage = await this.electronApp.firstWindow();
+        }
+        else {
+            // Use the last opened window
+            targetPage = windows.at(-1);
+        }
+        // Check if this window is already registered
+        const allPages = await this.allPages();
+        for (const page of allPages) {
+            const nativePage = await page.nativePage();
+            if (nativePage === targetPage) {
+                return page;
+            }
+        }
+        // Create and register a new PlaywrightPage
+        const playwrightPage = new PlaywrightPage_js_1.PlaywrightPage(this, targetPage, this.extraBrowserContextOptions, model_1.CorrelationId.create());
+        this.register(playwrightPage);
+        // Set up close handler for automatic deregistration
+        targetPage.on('close', () => {
+            this.deregister(playwrightPage.id);
+        });
+        return playwrightPage;
+    }
+    /**
+     * Closes all Electron windows but does NOT close the Electron application itself.
+     * The application lifecycle is managed externally.
+     */
+    async closeAllPages() {
+        const pages = await this.allPages();
+        for (const page of pages) {
+            await page.close();
+        }
+    }
+    /**
+     * Returns [basic meta-data](https://serenity-js.org/api/web/interface/BrowserCapabilities/) about the Electron application.
+     *
+     * **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: 'electron',
+            platformName: process.platform,
+            browserVersion: await this.getElectronVersion(),
+        };
+    }
+    async getElectronVersion() {
+        try {
+            const version = await this.electronApp.evaluate(() => process.versions.electron);
+            return version || 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+}
+exports.PlaywrightBrowsingSessionWithElectron = PlaywrightBrowsingSessionWithElectron;
+//# sourceMappingURL=PlaywrightBrowsingSessionWithElectron.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowsingSessionWithElectron.js","sourceRoot":"","sources":["../../../src/screenplay/models/PlaywrightBrowsingSessionWithElectron.ts"],"names":[],"mappings":";;;AAAA,mDAAwD;AAKxD,iFAA2E;AAC3E,2DAAqD;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAa,qCAAsC,SAAQ,wDAAyB;IAGlE;IADd,YACc,WAA2C,EACrD,0BAA+D,EAC/D,SAA+B;QAE/B,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAC;QAJnC,gBAAW,GAAX,WAAW,CAAgC;IAKzD,CAAC;IAEkB,KAAK,CAAC,oBAAoB;QACzC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IAEkB,KAAK,CAAC,mBAAmB;QACxC,iEAAiE;QACjE,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAE3C,IAAI,UAA2B,CAAC;QAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,oCAAoC;YACpC,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QACtD,CAAC;aACI,CAAC;YACF,6BAA6B;YAC7B,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;QACjC,CAAC;QAED,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,2CAA2C;QAC3C,MAAM,cAAc,GAAG,IAAI,kCAAc,CACrC,IAAI,EACJ,UAAU,EACV,IAAI,CAAC,0BAA0B,EAC/B,qBAAa,CAAC,MAAM,EAAE,CACzB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAE9B,oDAAoD;QACpD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACM,KAAK,CAAC,aAAa;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACM,KAAK,CAAC,mBAAmB;QAC9B,OAAO;YACH,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,OAAO,CAAC,QAAQ;YAC9B,cAAc,EAAE,MAAM,IAAI,CAAC,kBAAkB,EAAE;SAClD,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC5B,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAC3C,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAClC,CAAC;YACF,OAAO,OAAO,IAAI,SAAS,CAAC;QAChC,CAAC;QACD,MAAM,CAAC;YACH,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;CACJ;AA9FD,sFA8FC"}

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

@@ -17,5 +17,6 @@ export declare class PlaywrightBrowsingSessionWithPage extends PlaywrightBrowsin
      */
     closeAllPages(): Promise<void>;
     browserCapabilities(): Promise<BrowserCapabilities>;
+    discard(): Promise<void>;
 }
 //# sourceMappingURL=PlaywrightBrowsingSessionWithPage.d.ts.map

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

@@ -1 +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,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,yBAAyB;IAIxE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI;IAH5C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAyC;gBAG1D,IAAI,EAAE,UAAU,CAAC,IAAI,EACxC,qBAAqB,EAAE,0BAA0B,EACjD,SAAS,EAAE,UAAU,CAAC,SAAS;cAKV,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;cAU9C,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;IAInF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAQrE"}
+{"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,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,yBAAyB;IAIxE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI;IAH5C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAyC;gBAG1D,IAAI,EAAE,UAAU,CAAC,IAAI,EACxC,qBAAqB,EAAE,0BAA0B,EACjD,SAAS,EAAE,UAAU,CAAC,SAAS;cAKV,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;cAU9C,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;IAInF;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAS5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}