playwright 1.58.0-alpha-2025-12-18 → 1.58.0-alpha-2025-12-19

package/lib/index.js

@@ -612,18 +612,21 @@ class ArtifactsRecorder {
     if (!this._agent)
       return;
     const cachePathTemplate = this._agent.cachePathTemplate ?? "{testDir}/{testFilePath}-cache.json";
-    const cacheFile = this._testInfo._applyPathTemplate(cachePathTemplate, "", ".json");
-    const workerFile = await this._testInfo._cloneStorage(cacheFile);
+    this._agentCacheFile = this._testInfo._applyPathTemplate(cachePathTemplate, "", ".json");
+    this._agentCacheOutFile = import_path.default.join(this._testInfo.artifactsDir(), "agent-cache-" + (0, import_utils.createGuid)() + ".json");
+    const cacheFile = this._testInfo.config.runAgents ? void 0 : await this._testInfo._cloneStorage(this._agentCacheFile);
     options.agent = {
       ...this._agent,
-      cacheFile: workerFile,
-      cacheMode: this._testInfo.config.runAgents ? "update" : "force"
+      cacheFile,
+      cacheOutFile: this._agentCacheOutFile
     };
   }
   async _upstreamAgentCache(context) {
-    const agent = context._options.agent;
-    if (this._testInfo.status === "passed" && agent?.cacheFile)
-      await this._testInfo._upstreamStorage(agent.cacheFile);
+    if (!this._agentCacheFile || !this._agentCacheOutFile)
+      return;
+    if (this._testInfo.status !== "passed")
+      return;
+    await this._testInfo._upstreamStorage(this._agentCacheFile, this._agentCacheOutFile);
   }
   async didCreateRequestContext(context) {
     await this._startTraceChunkOnContextCreation(context, context._tracing);

package/lib/mcp/browser/browserContextFactory.js

@@ -134,7 +134,7 @@ class IsolatedContextFactory extends BaseContextFactory {
     });
   }
   async _doCreateContext(browser) {
-    return browser.newContext(this.config.browser.contextOptions);
+    return browser.newContext(browserContextOptionsFromConfig(this.config));
   }
 }
 class CdpContextFactory extends BaseContextFactory {
@@ -184,7 +184,7 @@ class PersistentContextFactory {
       const launchOptions = {
         tracesDir,
         ...this.config.browser.launchOptions,
-        ...this.config.browser.contextOptions,
+        ...browserContextOptionsFromConfig(this.config),
         handleSIGINT: false,
         handleSIGTERM: false,
         ignoreDefaultArgs: [
@@ -303,6 +303,16 @@ async function computeTracesDir(config, clientInfo) {
     return;
   return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", reason: "Collecting trace" });
 }
+function browserContextOptionsFromConfig(config) {
+  const result = { ...config.browser.contextOptions };
+  if (config.saveVideo) {
+    result.recordVideo = {
+      dir: (0, import_config.tmpDir)(),
+      size: config.saveVideo
+    };
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SharedContextFactory,

package/lib/mcp/browser/config.js

@@ -40,7 +40,8 @@ __export(config_exports, {
   resolutionParser: () => resolutionParser,
   resolveCLIConfig: () => resolveCLIConfig,
   resolveConfig: () => resolveConfig,
-  semicolonSeparatedList: () => semicolonSeparatedList
+  semicolonSeparatedList: () => semicolonSeparatedList,
+  tmpDir: () => tmpDir
 });
 module.exports = __toCommonJS(config_exports);
 var import_fs = __toESM(require("fs"));
@@ -161,13 +162,6 @@ function configFromCLIOptions(cliOptions) {
     contextOptions.serviceWorkers = "block";
   if (cliOptions.grantPermissions)
     contextOptions.permissions = cliOptions.grantPermissions;
-  if (cliOptions.saveVideo) {
-    contextOptions.recordVideo = {
-      // Videos are moved to output directory on saveAs.
-      dir: tmpDir(),
-      size: cliOptions.saveVideo
-    };
-  }
   const result = {
     browser: {
       browserName,
@@ -419,5 +413,6 @@ function sanitizeForFilePath(s) {
   resolutionParser,
   resolveCLIConfig,
   resolveConfig,
-  semicolonSeparatedList
+  semicolonSeparatedList,
+  tmpDir
 });

package/lib/mcp/browser/tab.js

@@ -154,18 +154,16 @@ class Tab extends import_events.EventEmitter {
   async navigate(url) {
     await this._initializedPromise;
     this._clearCollectedArtifacts();
-    const downloadEvent = (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForEvent("download").catch(import_log.logUnhandledError));
+    const { promise: downloadEvent, abort: abortDownloadEvent } = (0, import_utils2.eventWaiter)(this.page, "download", 3e3);
     try {
       await this.page.goto(url, { waitUntil: "domcontentloaded" });
+      abortDownloadEvent();
     } catch (_e) {
       const e = _e;
       const mightBeDownload = e.message.includes("net::ERR_ABORTED") || e.message.includes("Download is starting");
       if (!mightBeDownload)
         throw e;
-      const download = await Promise.race([
-        downloadEvent,
-        new Promise((resolve) => setTimeout(resolve, 3e3))
-      ]);
+      const download = await downloadEvent;
       if (!download)
         throw e;
       await new Promise((resolve) => setTimeout(resolve, 500));

package/lib/mcp/browser/tools/utils.js

@@ -20,6 +20,7 @@ var utils_exports = {};
 __export(utils_exports, {
   callOnPageNoTrace: () => callOnPageNoTrace,
   dateAsFileName: () => dateAsFileName,
+  eventWaiter: () => eventWaiter,
   waitForCompletion: () => waitForCompletion
 });
 module.exports = __toCommonJS(utils_exports);
@@ -65,9 +66,29 @@ function dateAsFileName(extension) {
   const date = /* @__PURE__ */ new Date();
   return `page-${date.toISOString().replace(/[:.]/g, "-")}.${extension}`;
 }
+function eventWaiter(page, event, timeout) {
+  const disposables = [];
+  const eventPromise = new Promise((resolve, reject) => {
+    page.on(event, resolve);
+    disposables.push(() => page.off(event, resolve));
+  });
+  let abort;
+  const abortPromise = new Promise((resolve, reject) => {
+    abort = () => resolve(void 0);
+  });
+  const timeoutPromise = new Promise((f) => {
+    const timeoutId = setTimeout(() => f(void 0), timeout);
+    disposables.push(() => clearTimeout(timeoutId));
+  });
+  return {
+    promise: Promise.race([eventPromise, abortPromise, timeoutPromise]).finally(() => disposables.forEach((dispose) => dispose())),
+    abort
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   callOnPageNoTrace,
   dateAsFileName,
+  eventWaiter,
   waitForCompletion
 });

package/lib/mcp/extension/extensionContextFactory.js

@@ -55,7 +55,7 @@ class ExtensionContextFactory {
   async _obtainBrowser(clientInfo, abortSignal, toolName) {
     const relay = await this._startRelay(abortSignal);
     await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);
-    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint());
+    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint(), { isLocal: true });
   }
   async _startRelay(abortSignal) {
     const httpServer = await (0, import_http.startHttpServer)({});

package/lib/mcp/program.js

@@ -38,11 +38,10 @@ var mcpServer = __toESM(require("./sdk/server"));
 var import_config = require("./browser/config");
 var import_watchdog = require("./browser/watchdog");
 var import_browserContextFactory = require("./browser/browserContextFactory");
-var import_proxyBackend = require("./sdk/proxyBackend");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
 function decorateCommand(command, version) {
-  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");
@@ -71,28 +70,6 @@ Please run the command below. It will install a local copy of ffmpeg and will no
       await mcpServer.start(serverBackendFactory, config.server);
       return;
     }
-    if (options.connectTool) {
-      const providers = [
-        {
-          name: "default",
-          description: "Starts standalone browser",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory))
-        },
-        {
-          name: "extension",
-          description: "Connect to a browser using the Playwright MCP extension",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory))
-        }
-      ];
-      const factory2 = {
-        name: "Playwright w/ switch",
-        nameInConfig: "playwright-switch",
-        version,
-        create: () => new import_proxyBackend.ProxyBackend(providers)
-      };
-      await mcpServer.start(factory2, config.server);
-      return;
-    }
     const factory = {
       name: "Playwright",
       nameInConfig: "playwright",

package/lib/mcp/sdk/exports.js

@@ -16,14 +16,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var exports_exports = {};
 module.exports = __toCommonJS(exports_exports);
 __reExport(exports_exports, require("./inProcessTransport"), module.exports);
-__reExport(exports_exports, require("./proxyBackend"), module.exports);
 __reExport(exports_exports, require("./server"), module.exports);
 __reExport(exports_exports, require("./tool"), module.exports);
 __reExport(exports_exports, require("./http"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./inProcessTransport"),
-  ...require("./proxyBackend"),
   ...require("./server"),
   ...require("./tool"),
   ...require("./http")

package/lib/runner/dispatcher.js

@@ -199,10 +199,10 @@ class Dispatcher {
       this._producedEnvByProjectId.set(testGroup.projectId, { ...producedEnv, ...worker.producedEnv() });
     });
     worker.onRequest("cloneStorage", async (params) => {
-      return await import_storage.Storage.clone(params.storageFile, worker.artifactsDir());
+      return await import_storage.Storage.clone(params.storageFile, outputDir);
     });
     worker.onRequest("upstreamStorage", async (params) => {
-      await import_storage.Storage.upstream(params.workerFile);
+      await import_storage.Storage.upstream(params.storageFile, params.storageOutFile);
     });
     return worker;
   }

package/lib/runner/storage.js

@@ -35,68 +35,55 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_utils = require("playwright-core/lib/utils");
 class Storage {
-  constructor(fileName) {
-    this._writeChain = Promise.resolve();
-    this._fileName = fileName;
-  }
   static {
     this._storages = /* @__PURE__ */ new Map();
   }
   static {
-    this._workerFiles = /* @__PURE__ */ new Map();
+    this._serializeQueue = Promise.resolve();
   }
-  static async clone(storageFile, artifactsDir) {
-    const workerFile = await this._storage(storageFile)._clone(artifactsDir);
-    const stat = await import_fs.default.promises.stat(workerFile);
-    const lastModified = stat.mtime.getTime();
-    Storage._workerFiles.set(workerFile, { storageFile, lastModified });
-    return workerFile;
+  static clone(storageFile, outputDir) {
+    return Storage._withStorage(storageFile, (storage) => storage._clone(outputDir));
   }
-  static async upstream(workerFile) {
-    const entry = Storage._workerFiles.get(workerFile);
-    if (!entry)
-      return;
-    const { storageFile, lastModified } = entry;
-    const stat = await import_fs.default.promises.stat(workerFile);
-    const newLastModified = stat.mtime.getTime();
-    if (lastModified !== newLastModified)
-      await this._storage(storageFile)._upstream(workerFile);
-    Storage._workerFiles.delete(workerFile);
+  static upstream(storageFile, storageOutFile) {
+    return Storage._withStorage(storageFile, (storage) => storage._upstream(storageOutFile));
   }
-  static _storage(fileName) {
-    if (!Storage._storages.has(fileName))
-      Storage._storages.set(fileName, new Storage(fileName));
-    return Storage._storages.get(fileName);
+  static _withStorage(fileName, runnable) {
+    this._serializeQueue = this._serializeQueue.then(() => {
+      let storage = Storage._storages.get(fileName);
+      if (!storage) {
+        storage = new Storage(fileName);
+        Storage._storages.set(fileName, storage);
+      }
+      return runnable(storage);
+    });
+    return this._serializeQueue;
   }
-  async _clone(artifactsDir) {
+  constructor(fileName) {
+    this._fileName = fileName;
+  }
+  async _clone(outputDir) {
     const entries = await this._load();
-    const workerFile = import_path.default.join(artifactsDir, `pw-storage-${(0, import_utils.createGuid)()}.json`);
-    await import_fs.default.promises.writeFile(workerFile, JSON.stringify(entries, null, 2)).catch(() => {
+    if (this._lastSnapshotFileName)
+      return this._lastSnapshotFileName;
+    const snapshotFile = import_path.default.join(outputDir, `pw-storage-${(0, import_utils.createGuid)()}.json`);
+    await import_fs.default.promises.writeFile(snapshotFile, JSON.stringify(entries, null, 2)).catch(() => {
     });
-    return workerFile;
+    this._lastSnapshotFileName = snapshotFile;
+    return snapshotFile;
   }
-  async _upstream(workerFile) {
+  async _upstream(storageOutFile) {
     const entries = await this._load();
-    const newEntries = await import_fs.default.promises.readFile(workerFile, "utf8").then(JSON.parse).catch(() => ({}));
-    for (const [key, newValue] of Object.entries(newEntries)) {
-      const existing = entries[key];
-      if (!existing || existing.timestamp < newValue.timestamp)
-        entries[key] = newValue;
-    }
-    await this._writeFile(entries);
+    const newEntries = await import_fs.default.promises.readFile(storageOutFile, "utf8").then(JSON.parse).catch(() => ({}));
+    for (const [key, newValue] of Object.entries(newEntries))
+      entries[key] = newValue;
+    this._lastSnapshotFileName = void 0;
+    await import_fs.default.promises.writeFile(this._fileName, JSON.stringify(entries, null, 2));
   }
   async _load() {
     if (!this._entriesPromise)
       this._entriesPromise = import_fs.default.promises.readFile(this._fileName, "utf8").then(JSON.parse).catch(() => ({}));
     return this._entriesPromise;
   }
-  _writeFile(entries) {
-    this._writeChain = this._writeChain.then(() => import_fs.default.promises.writeFile(this._fileName, JSON.stringify(entries, null, 2)));
-    return this._writeChain;
-  }
-  async flush() {
-    await this._writeChain;
-  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/worker/testInfo.js

@@ -493,12 +493,14 @@ ${(0, import_utils.stringifyStackFrames)(step.boxedStack).join("\n")}`;
   setTimeout(timeout) {
     this._timeoutManager.setTimeout(timeout);
   }
-  async _cloneStorage(cacheFileTemplate) {
-    const storageFile = this._applyPathTemplate(cacheFileTemplate, "cache", ".json");
+  async _cloneStorage(storageFile) {
     return await this._callbacks.onCloneStorage({ storageFile });
   }
-  async _upstreamStorage(workerFile) {
-    await this._callbacks.onUpstreamStorage?.({ workerFile });
+  async _upstreamStorage(storageFile, storageOutFile) {
+    await this._callbacks.onUpstreamStorage({ storageFile, storageOutFile });
+  }
+  artifactsDir() {
+    return this._workerParams.artifactsDir;
   }
 }
 class TestStepInfoImpl {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.58.0-alpha-2025-12-18",
+  "version": "1.58.0-alpha-2025-12-19",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "playwright-core": "1.58.0-alpha-2025-12-18"
+    "playwright-core": "1.58.0-alpha-2025-12-19"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"

package/test.mjs

@@ -25,6 +25,7 @@ export const errors = playwright.errors;
 export const request = playwright.request;
 export const _electron = playwright._electron;
 export const _android = playwright._android;
+export const _baseTest = playwright._baseTest;
 export const test = playwright.test;
 export const expect = playwright.expect;
 export const defineConfig = playwright.defineConfig;

package/lib/mcp/sdk/proxyBackend.js

@@ -1,128 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var proxyBackend_exports = {};
-__export(proxyBackend_exports, {
-  ProxyBackend: () => ProxyBackend
-});
-module.exports = __toCommonJS(proxyBackend_exports);
-var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var mcpBundle = __toESM(require("playwright-core/lib/mcpBundle"));
-const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
-const { z, zodToJsonSchema } = mcpBundle;
-class ProxyBackend {
-  constructor(mcpProviders) {
-    this._mcpProviders = mcpProviders;
-    this._contextSwitchTool = this._defineContextSwitchTool();
-  }
-  async initialize(clientInfo) {
-    this._clientInfo = clientInfo;
-  }
-  async listTools() {
-    const currentClient = await this._ensureCurrentClient();
-    const response = await currentClient.listTools();
-    if (this._mcpProviders.length === 1)
-      return response.tools;
-    return [
-      ...response.tools,
-      this._contextSwitchTool
-    ];
-  }
-  async callTool(name, args) {
-    if (name === this._contextSwitchTool.name)
-      return this._callContextSwitchTool(args);
-    const currentClient = await this._ensureCurrentClient();
-    return await currentClient.callTool({
-      name,
-      arguments: args
-    });
-  }
-  serverClosed() {
-    void this._currentClient?.close().catch(errorsDebug);
-  }
-  async _callContextSwitchTool(params) {
-    try {
-      const factory = this._mcpProviders.find((factory2) => factory2.name === params.name);
-      if (!factory)
-        throw new Error("Unknown connection method: " + params.name);
-      await this._setCurrentClient(factory);
-      return {
-        content: [{ type: "text", text: "### Result\nSuccessfully changed connection method.\n" }]
-      };
-    } catch (error) {
-      return {
-        content: [{ type: "text", text: `### Result
-Error: ${error}
-` }],
-        isError: true
-      };
-    }
-  }
-  _defineContextSwitchTool() {
-    return {
-      name: "browser_connect",
-      description: [
-        "Connect to a browser using one of the available methods:",
-        ...this._mcpProviders.map((factory) => `- "${factory.name}": ${factory.description}`)
-      ].join("\n"),
-      inputSchema: zodToJsonSchema(z.object({
-        name: z.enum(this._mcpProviders.map((factory) => factory.name)).default(this._mcpProviders[0].name).describe("The method to use to connect to the browser")
-      }), { strictUnions: true }),
-      annotations: {
-        title: "Connect to a browser context",
-        readOnlyHint: true,
-        openWorldHint: false
-      }
-    };
-  }
-  async _ensureCurrentClient() {
-    if (this._currentClient)
-      return this._currentClient;
-    return await this._setCurrentClient(this._mcpProviders[0]);
-  }
-  async _setCurrentClient(factory) {
-    await this._currentClient?.close();
-    this._currentClient = void 0;
-    const client = new mcpBundle.Client({ name: "Playwright MCP Proxy", version: "0.0.0" });
-    client.registerCapabilities({
-      roots: {
-        listRoots: true
-      }
-    });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
-    client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
-    const transport = factory.connect();
-    await client.connect(transport);
-    this._currentClient = client;
-    return client;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ProxyBackend
-});