playwright-core 1.54.0-alpha-2025-06-19 → 1.54.0-alpha-2025-06-20

package/lib/remote/playwrightConnection.js

@@ -33,15 +33,14 @@ var import_profiler = require("../server/utils/profiler");
 var import_utils = require("../utils");
 var import_debugLogger = require("../server/utils/debugLogger");
 class PlaywrightConnection {
-  constructor(lock, clientType, ws, options, preLaunched, id, onClose) {
+  constructor(lock, clientType, ws, options, playwright, preLaunched, id, onClose) {
     this._cleanups = [];
     this._disconnected = false;
     this._ws = ws;
+    this._playwright = playwright;
     this._preLaunched = preLaunched;
     this._options = options;
     options.launchOptions = filterLaunchOptions(options.launchOptions, options.allowFSPaths);
-    if (clientType === "reuse-browser" || clientType === "pre-launched-browser-or-android")
-      (0, import_assert.assert)(preLaunched.playwright);
     if (clientType === "pre-launched-browser-or-android")
       (0, import_assert.assert)(preLaunched.browser || preLaunched.androidDevice);
     this._onClose = onClose;
@@ -88,7 +87,6 @@ class PlaywrightConnection {
   }
   async _initLaunchBrowserMode(scope, options) {
     import_debugLogger.debugLogger.log("server", `[${this._id}] engaged launch mode for "${this._options.browserName}"`);
-    const playwright = (0, import_server.createPlaywright)({ sdkLanguage: options.sdkLanguage, isServer: true });
     const ownedSocksProxy = await this._createOwnedSocksProxy();
     let browserName = this._options.browserName;
     if ("bidi" === browserName) {
@@ -97,32 +95,29 @@ class PlaywrightConnection {
       else
         browserName = "bidiChromium";
     }
-    const browser = await playwright[browserName].launch((0, import_instrumentation.serverSideCallMetadata)(), this._options.launchOptions);
+    const browser = await this._playwright[browserName].launch((0, import_instrumentation.serverSideCallMetadata)(), this._options.launchOptions);
     browser.options.sdkLanguage = options.sdkLanguage;
-    this._cleanups.push(async () => {
-      for (const browser2 of playwright.allBrowsers())
-        await browser2.close({ reason: "Connection terminated" });
-    });
+    this._cleanups.push(() => browser.close({ reason: "Connection terminated" }));
     browser.on(import_browser.Browser.Events.Disconnected, () => {
       this.close({ code: 1001, reason: "Browser closed" });
     });
-    return new import_server.PlaywrightDispatcher(scope, playwright, { socksProxy: ownedSocksProxy, preLaunchedBrowser: browser });
+    return new import_server.PlaywrightDispatcher(scope, this._playwright, { socksProxy: ownedSocksProxy, preLaunchedBrowser: browser, denyLaunch: true });
   }
   async _initPreLaunchedBrowserMode(scope, options) {
     import_debugLogger.debugLogger.log("server", `[${this._id}] engaged pre-launched (browser) mode`);
-    const playwright = this._preLaunched.playwright;
     this._preLaunched.socksProxy?.setPattern(this._options.socksProxyPattern);
     const browser = this._preLaunched.browser;
     browser.options.sdkLanguage = options.sdkLanguage;
     browser.on(import_browser.Browser.Events.Disconnected, () => {
       this.close({ code: 1001, reason: "Browser closed" });
     });
-    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, playwright, {
+    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, this._playwright, {
       socksProxy: this._preLaunched.socksProxy,
       preLaunchedBrowser: browser,
-      sharedBrowser: this._options.sharedBrowser
+      sharedBrowser: this._options.sharedBrowser,
+      denyLaunch: true
     });
-    for (const b of playwright.allBrowsers()) {
+    for (const b of this._playwright.allBrowsers()) {
       if (b !== browser)
         await b.close({ reason: "Connection terminated" });
     }
@@ -131,38 +126,35 @@ class PlaywrightConnection {
   }
   async _initPreLaunchedAndroidMode(scope) {
     import_debugLogger.debugLogger.log("server", `[${this._id}] engaged pre-launched (Android) mode`);
-    const playwright = this._preLaunched.playwright;
     const androidDevice = this._preLaunched.androidDevice;
     androidDevice.on(import_android.AndroidDevice.Events.Close, () => {
       this.close({ code: 1001, reason: "Android device disconnected" });
     });
-    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, playwright, { preLaunchedAndroidDevice: androidDevice });
+    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, this._playwright, { preLaunchedAndroidDevice: androidDevice, denyLaunch: true });
     this._cleanups.push(() => playwrightDispatcher.cleanup());
     return playwrightDispatcher;
   }
   _initDebugControllerMode() {
     import_debugLogger.debugLogger.log("server", `[${this._id}] engaged reuse controller mode`);
-    const playwright = this._preLaunched.playwright;
-    return new import_debugControllerDispatcher.DebugControllerDispatcher(this._dispatcherConnection, playwright.debugController);
+    return new import_debugControllerDispatcher.DebugControllerDispatcher(this._dispatcherConnection, this._playwright.debugController);
   }
   async _initReuseBrowsersMode(scope, options) {
     import_debugLogger.debugLogger.log("server", `[${this._id}] engaged reuse browsers mode for ${this._options.browserName}`);
-    const playwright = this._preLaunched.playwright;
     const requestedOptions = launchOptionsHash(this._options.launchOptions);
-    let browser = playwright.allBrowsers().find((b) => {
+    let browser = this._playwright.allBrowsers().find((b) => {
       if (b.options.name !== this._options.browserName)
         return false;
       const existingOptions = launchOptionsHash(b.options.originalLaunchOptions);
       return existingOptions === requestedOptions;
     });
-    for (const b of playwright.allBrowsers()) {
+    for (const b of this._playwright.allBrowsers()) {
       if (b === browser)
         continue;
       if (b.options.name === this._options.browserName && b.options.channel === this._options.launchOptions.channel)
         await b.close({ reason: "Connection terminated" });
     }
     if (!browser) {
-      browser = await playwright[this._options.browserName || "chromium"].launch((0, import_instrumentation.serverSideCallMetadata)(), {
+      browser = await this._playwright[this._options.browserName || "chromium"].launch((0, import_instrumentation.serverSideCallMetadata)(), {
         ...this._options.launchOptions,
         headless: !!process.env.PW_DEBUG_CONTROLLER_HEADLESS
       });
@@ -172,7 +164,7 @@ class PlaywrightConnection {
     }
     browser.options.sdkLanguage = options.sdkLanguage;
     this._cleanups.push(async () => {
-      for (const browser2 of playwright.allBrowsers()) {
+      for (const browser2 of this._playwright.allBrowsers()) {
         for (const context of browser2.contexts()) {
           if (!context.pages().length)
             await context.close({ reason: "Connection terminated" });
@@ -183,7 +175,7 @@ class PlaywrightConnection {
           await browser2.close({ reason: "Connection terminated" });
       }
     });
-    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, playwright, { preLaunchedBrowser: browser });
+    const playwrightDispatcher = new import_server.PlaywrightDispatcher(scope, this._playwright, { preLaunchedBrowser: browser, denyLaunch: true });
     return playwrightDispatcher;
   }
   async _createOwnedSocksProxy() {

package/lib/remote/playwrightServer.js

@@ -23,7 +23,6 @@ __export(playwrightServer_exports, {
 module.exports = __toCommonJS(playwrightServer_exports);
 var import_playwrightConnection = require("./playwrightConnection");
 var import_playwright = require("../server/playwright");
-var import_debugLogger = require("../server/utils/debugLogger");
 var import_semaphore = require("../utils/isomorphic/semaphore");
 var import_time = require("../utils/isomorphic/time");
 var import_wsServer = require("../server/utils/wsServer");
@@ -33,9 +32,10 @@ class PlaywrightServer {
   constructor(options) {
     this._options = options;
     if (options.preLaunchedBrowser)
-      this._preLaunchedPlaywright = options.preLaunchedBrowser.attribution.playwright;
+      this._playwright = options.preLaunchedBrowser.attribution.playwright;
     if (options.preLaunchedAndroidDevice)
-      this._preLaunchedPlaywright = options.preLaunchedAndroidDevice._android.attribution.playwright;
+      this._playwright = options.preLaunchedAndroidDevice._android.attribution.playwright;
+    this._playwright ??= (0, import_playwright.createPlaywright)({ sdkLanguage: "javascript", isServer: true });
     const browserSemaphore = new import_semaphore.Semaphore(this._options.maxConnections);
     const controllerSemaphore = new import_semaphore.Semaphore(1);
     const reuseBrowserSemaphore = new import_semaphore.Semaphore(1);
@@ -75,10 +75,6 @@ ${uaError}` };
         } catch (e) {
         }
         const isExtension = this._options.mode === "extension";
-        if (isExtension) {
-          if (!this._preLaunchedPlaywright)
-            this._preLaunchedPlaywright = (0, import_playwright.createPlaywright)({ sdkLanguage: "javascript", isServer: true });
-        }
         let clientType = "launch-browser";
         let semaphore = browserSemaphore;
         if (isExtension && url.searchParams.has("debug-controller")) {
@@ -102,8 +98,8 @@ ${uaError}` };
             allowFSPaths: this._options.mode === "extension",
             sharedBrowser: this._options.mode === "launchServerShared"
           },
+          this._playwright,
           {
-            playwright: this._preLaunchedPlaywright,
             browser: this._options.preLaunchedBrowser,
             androidDevice: this._options.preLaunchedAndroidDevice,
             socksProxy: this._options.preLaunchedSocksProxy
@@ -111,12 +107,6 @@ ${uaError}` };
           id,
           () => semaphore.release()
         );
-      },
-      onClose: async () => {
-        import_debugLogger.debugLogger.log("server", "closing browsers");
-        if (this._preLaunchedPlaywright)
-          await Promise.all(this._preLaunchedPlaywright.allBrowsers().map((browser) => browser.close({ reason: "Playwright Server stopped" })));
-        import_debugLogger.debugLogger.log("server", "closed browsers");
       }
     });
   }

package/lib/server/dispatchers/androidDispatcher.js

@@ -29,9 +29,10 @@ var import_android = require("../android/android");
 var import_eventsHelper = require("../utils/eventsHelper");
 var import_instrumentation = require("../instrumentation");
 class AndroidDispatcher extends import_dispatcher.Dispatcher {
-  constructor(scope, android) {
+  constructor(scope, android, denyLaunch) {
     super(scope, android, "Android", {});
     this._type_Android = true;
+    this._denyLaunch = denyLaunch;
   }
   async devices(params) {
     const devices = await this._object.devices(params);
@@ -136,6 +137,8 @@ class AndroidDeviceDispatcher extends import_dispatcher.Dispatcher {
     await this._object.push(params.file, params.path, params.mode);
   }
   async launchBrowser(params) {
+    if (this.parentScope()._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     const context = await this._object.launchBrowser(params.pkg, params);
     return { context: import_browserContextDispatcher.BrowserContextDispatcher.from(this, context) };
   }
@@ -143,6 +146,8 @@ class AndroidDeviceDispatcher extends import_dispatcher.Dispatcher {
     await this._object.close();
   }
   async connectToWebView(params) {
+    if (this.parentScope()._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     return { context: import_browserContextDispatcher.BrowserContextDispatcher.from(this, await this._object.connectToWebView(params.socketName)) };
   }
 }

package/lib/server/dispatchers/browserTypeDispatcher.js

@@ -25,24 +25,31 @@ var import_browserContextDispatcher = require("./browserContextDispatcher");
 var import_browserDispatcher = require("./browserDispatcher");
 var import_dispatcher = require("./dispatcher");
 class BrowserTypeDispatcher extends import_dispatcher.Dispatcher {
-  constructor(scope, browserType) {
+  constructor(scope, browserType, denyLaunch) {
     super(scope, browserType, "BrowserType", {
       executablePath: browserType.executablePath(),
       name: browserType.name()
     });
     this._type_BrowserType = true;
+    this._denyLaunch = denyLaunch;
   }
   async launch(params, metadata) {
+    if (this._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     const browser = await this._object.launch(metadata, params);
     return { browser: new import_browserDispatcher.BrowserDispatcher(this, browser) };
   }
   async launchPersistentContext(params, metadata) {
+    if (this._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     const browserContext = await this._object.launchPersistentContext(metadata, params.userDataDir, params);
     const browserDispatcher = new import_browserDispatcher.BrowserDispatcher(this, browserContext._browser);
     const contextDispatcher = import_browserContextDispatcher.BrowserContextDispatcher.from(browserDispatcher, browserContext);
     return { browser: browserDispatcher, context: contextDispatcher };
   }
   async connectOverCDP(params, metadata) {
+    if (this._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     const browser = await this._object.connectOverCDP(metadata, params.endpointURL, params);
     const browserDispatcher = new import_browserDispatcher.BrowserDispatcher(this, browser);
     return {

package/lib/server/dispatchers/electronDispatcher.js

@@ -27,11 +27,14 @@ var import_dispatcher = require("./dispatcher");
 var import_jsHandleDispatcher = require("./jsHandleDispatcher");
 var import_electron = require("../electron/electron");
 class ElectronDispatcher extends import_dispatcher.Dispatcher {
-  constructor(scope, electron) {
+  constructor(scope, electron, denyLaunch) {
     super(scope, electron, "Electron", {});
     this._type_Electron = true;
+    this._denyLaunch = denyLaunch;
   }
   async launch(params) {
+    if (this._denyLaunch)
+      throw new Error(`Launching more browsers is not allowed.`);
     const electronApplication = await this._object.launch(params);
     return { electronApplication: new ElectronApplicationDispatcher(this, electronApplication) };
   }

package/lib/server/dispatchers/playwrightDispatcher.js

@@ -35,12 +35,13 @@ var import_instrumentation = require("../instrumentation");
 var import_eventsHelper = require("../utils/eventsHelper");
 class PlaywrightDispatcher extends import_dispatcher.Dispatcher {
   constructor(scope, playwright, options = {}) {
-    const chromium = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.chromium);
-    const firefox = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.firefox);
-    const webkit = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.webkit);
-    const bidiChromium = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.bidiChromium);
-    const bidiFirefox = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.bidiFirefox);
-    const android = new import_androidDispatcher.AndroidDispatcher(scope, playwright.android);
+    const denyLaunch = options.denyLaunch ?? false;
+    const chromium = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.chromium, denyLaunch);
+    const firefox = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.firefox, denyLaunch);
+    const webkit = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.webkit, denyLaunch);
+    const bidiChromium = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.bidiChromium, denyLaunch);
+    const bidiFirefox = new import_browserTypeDispatcher.BrowserTypeDispatcher(scope, playwright.bidiFirefox, denyLaunch);
+    const android = new import_androidDispatcher.AndroidDispatcher(scope, playwright.android, denyLaunch);
     const initializer = {
       chromium,
       firefox,
@@ -48,7 +49,7 @@ class PlaywrightDispatcher extends import_dispatcher.Dispatcher {
       bidiChromium,
       bidiFirefox,
       android,
-      electron: new import_electronDispatcher.ElectronDispatcher(scope, playwright.electron),
+      electron: new import_electronDispatcher.ElectronDispatcher(scope, playwright.electron, denyLaunch),
       utils: playwright.options.isServer ? void 0 : new import_localUtilsDispatcher.LocalUtilsDispatcher(scope, playwright),
       socksSupport: options.socksProxy ? new SocksSupportDispatcher(scope, playwright, options.socksProxy) : void 0
     };

package/lib/server/utils/wsServer.js

@@ -112,7 +112,6 @@ class WSServer {
     this._wsServer = void 0;
     this.server = void 0;
     import_debugLogger.debugLogger.log("server", "closed server");
-    await this._delegate.onClose?.();
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-core",
-  "version": "1.54.0-alpha-2025-06-19",
+  "version": "1.54.0-alpha-2025-06-20",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",