playwright 1.56.0-alpha-2025-09-10 → 1.56.0-alpha-1757624765000

package/lib/mcp/browser/browserContextFactory.js

@@ -38,6 +38,7 @@ var import_path = __toESM(require("path"));
 var playwright = __toESM(require("playwright-core"));
 var import_registry = require("playwright-core/lib/server/registry/index");
 var import_server = require("playwright-core/lib/server");
+var import_processUtils = require("./processUtils");
 var import_log = require("../log");
 var import_config = require("./config");
 function contextFactory(config) {
@@ -160,32 +161,32 @@ class PersistentContextFactory {
     (0, import_log.testDebug)("lock user data dir", userDataDir);
     const browserType = playwright[this.config.browser.browserName];
     for (let i = 0; i < 5; i++) {
-      const launchOptions = {
-        tracesDir,
-        ...this.config.browser.launchOptions,
-        ...this.config.browser.contextOptions,
-        handleSIGINT: false,
-        handleSIGTERM: false,
-        ignoreDefaultArgs: [
-          "--disable-extensions"
-        ],
-        assistantMode: true
-      };
-      try {
-        const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
-        const close = () => this._closeBrowserContext(browserContext, userDataDir);
-        return { browserContext, close };
-      } catch (error) {
-        if (error.message.includes("Executable doesn't exist"))
-          throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
-        if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL")) {
-          await new Promise((resolve) => setTimeout(resolve, 1e3));
-          continue;
-        }
-        throw error;
-      }
+      if (!await alreadyRunning(this.config, browserType, userDataDir))
+        break;
+      await new Promise((resolve) => setTimeout(resolve, 1e3));
+    }
+    const launchOptions = {
+      tracesDir,
+      ...this.config.browser.launchOptions,
+      ...this.config.browser.contextOptions,
+      handleSIGINT: false,
+      handleSIGTERM: false,
+      ignoreDefaultArgs: [
+        "--disable-extensions"
+      ],
+      assistantMode: true
+    };
+    try {
+      const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
+      const close = () => this._closeBrowserContext(browserContext, userDataDir);
+      return { browserContext, close };
+    } catch (error) {
+      if (error.message.includes("Executable doesn't exist"))
+        throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
+      if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL"))
+        throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
+      throw error;
     }
-    throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
   }
   async _closeBrowserContext(browserContext, userDataDir) {
     (0, import_log.testDebug)("close browser context (persistent)");
@@ -204,6 +205,12 @@ class PersistentContextFactory {
     return result;
   }
 }
+async function alreadyRunning(config, browserType, userDataDir) {
+  const execPath = config.browser.launchOptions.executablePath ?? (0, import_processUtils.getBrowserExecPath)(config.browser.launchOptions.channel ?? browserType.name());
+  if (!execPath)
+    return false;
+  return !!(0, import_processUtils.findBrowserProcess)(execPath, userDataDir);
+}
 async function injectCdpPort(browserConfig) {
   if (browserConfig.browserName === "chromium")
     browserConfig.launchOptions.cdpPort = await findFreePort();

package/lib/mcp/browser/browserServerBackend.js

@@ -43,7 +43,6 @@ class BrowserServerBackend {
     }
     this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, rootPath) : void 0;
     this._context = new import_context.Context({
-      tools: this._tools,
       config: this._config,
       browserContextFactory: this._browserContextFactory,
       sessionLog: this._sessionLog,

package/lib/mcp/browser/config.js

@@ -30,6 +30,7 @@ var config_exports = {};
 __export(config_exports, {
   commaSeparatedList: () => commaSeparatedList,
   configFromCLIOptions: () => configFromCLIOptions,
+  defaultConfig: () => defaultConfig,
   dotenvFileLoader: () => dotenvFileLoader,
   headerParser: () => headerParser,
   numberParser: () => numberParser,
@@ -307,6 +308,7 @@ function sanitizeForFilePath(s) {
 0 && (module.exports = {
   commaSeparatedList,
   configFromCLIOptions,
+  defaultConfig,
   dotenvFileLoader,
   headerParser,
   numberParser,

package/lib/mcp/browser/context.js

@@ -42,7 +42,6 @@ class Context {
   constructor(options) {
     this._tabs = [];
     this._abortController = new AbortController();
-    this.tools = options.tools;
     this.config = options.config;
     this.sessionLog = options.sessionLog;
     this.options = options;

package/lib/mcp/browser/processUtils.js

@@ -0,0 +1,102 @@
+"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 processUtils_exports = {};
+__export(processUtils_exports, {
+  findBrowserProcess: () => findBrowserProcess,
+  getBrowserExecPath: () => getBrowserExecPath
+});
+module.exports = __toCommonJS(processUtils_exports);
+var import_child_process = __toESM(require("child_process"));
+var import_fs = __toESM(require("fs"));
+var import_registry = require("playwright-core/lib/server/registry/index");
+function getBrowserExecPath(channelOrName) {
+  return import_registry.registry.findExecutable(channelOrName)?.executablePath("javascript");
+}
+function findBrowserProcess(execPath, arg) {
+  const predicate = (line) => line.includes(execPath) && line.includes(arg) && !line.includes("--type");
+  try {
+    switch (process.platform) {
+      case "darwin":
+        return findProcessMacos(predicate);
+      case "linux":
+        return findProcessLinux(predicate);
+      case "win32":
+        return findProcessWindows(execPath, arg, predicate);
+      default:
+        return void 0;
+    }
+  } catch {
+    return void 0;
+  }
+}
+function findProcessLinux(predicate) {
+  const procDirs = import_fs.default.readdirSync("/proc").filter((name) => /^\d+$/.test(name));
+  for (const pid of procDirs) {
+    try {
+      const cmdlineBuffer = import_fs.default.readFileSync(`/proc/${pid}/cmdline`);
+      const cmdline = cmdlineBuffer.toString().replace(/\0/g, " ").trim();
+      if (predicate(cmdline))
+        return `${pid} ${cmdline}`;
+    } catch {
+      continue;
+    }
+  }
+  return void 0;
+}
+function findProcessMacos(predicate) {
+  const result = import_child_process.default.spawnSync("/bin/ps", ["-axo", "pid=,command="]);
+  if (result.status !== 0 || !result.stdout)
+    return void 0;
+  return findMatchingLine(result.stdout.toString(), predicate);
+}
+function findProcessWindows(execPath, arg, predicate) {
+  const psEscape = (path) => `'${path.replaceAll("'", "''")}'`;
+  const filter = `$_.ExecutablePath -eq ${psEscape(execPath)} -and $_.CommandLine.Contains(${psEscape(arg)}) -and $_.CommandLine -notmatch '--type'`;
+  const ps = import_child_process.default.spawnSync(
+    "powershell.exe",
+    [
+      "-NoProfile",
+      "-Command",
+      `Get-CimInstance Win32_Process | Where-Object { ${filter} } | Select-Object -Property ProcessId,CommandLine | ForEach-Object { "$($_.ProcessId) $($_.CommandLine)" }`
+    ],
+    { encoding: "utf8" }
+  );
+  if (ps.status !== 0 || !ps.stdout)
+    return void 0;
+  return findMatchingLine(ps.stdout.toString(), predicate);
+}
+function findMatchingLine(psOutput, predicate) {
+  const lines = psOutput.split("\n").map((l) => l.trim()).filter(Boolean);
+  return lines.find(predicate);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findBrowserProcess,
+  getBrowserExecPath
+});

package/lib/mcp/browser/tab.js

@@ -51,7 +51,8 @@ class Tab extends import_events.EventEmitter {
       this.setModalState({
         type: "fileChooser",
         description: "File chooser",
-        fileChooser: chooser
+        fileChooser: chooser,
+        clearedBy: "browser_file_upload"
       });
     });
     page.on("dialog", (dialog) => this._dialogShown(dialog));
@@ -82,7 +83,8 @@ class Tab extends import_events.EventEmitter {
     this.setModalState({
       type: "dialog",
       description: `"${dialog.type()}" dialog with message "${dialog.message()}"`,
-      dialog
+      dialog,
+      clearedBy: "browser_handle_dialog"
     });
   }
   async _downloadStarted(download) {
@@ -241,10 +243,8 @@ function renderModalStates(context, modalStates) {
   const result = ["### Modal state"];
   if (modalStates.length === 0)
     result.push("- There is no modal state present");
-  for (const state of modalStates) {
-    const tool = context.tools.filter((tool2) => "clearsModalState" in tool2).find((tool2) => tool2.clearsModalState === state.type);
-    result.push(`- [${state.description}]: can be handled by the "${tool?.schema.name}" tool`);
-  }
+  for (const state of modalStates)
+    result.push(`- [${state.description}]: can be handled by the "${state.clearedBy}" tool`);
   return result;
 }
 const tabSymbol = Symbol("tabSymbol");

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

@@ -30,7 +30,7 @@ const uploadFile = (0, import_tool.defineTabTool)({
     title: "Upload files",
     description: "Upload one or multiple files",
     inputSchema: import_bundle.z.object({
-      paths: import_bundle.z.array(import_bundle.z.string()).describe("The absolute paths to the files to upload. Can be a single file or multiple files.")
+      paths: import_bundle.z.array(import_bundle.z.string()).optional().describe("The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.")
     }),
     type: "destructive"
   },
@@ -42,7 +42,8 @@ const uploadFile = (0, import_tool.defineTabTool)({
     response.addCode(`await fileChooser.setFiles(${JSON.stringify(params.paths)})`);
     tab.clearModalState(modalState);
     await tab.waitForCompletion(async () => {
-      await modalState.fileChooser.setFiles(params.paths);
+      if (params.paths)
+        await modalState.fileChooser.setFiles(params.paths);
     });
   },
   clearsModalState: "fileChooser"

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

@@ -154,12 +154,27 @@ const selectOption = (0, import_tool.defineTabTool)({
     });
   }
 });
+const pickLocator = (0, import_tool.defineTabTool)({
+  capability: "testing",
+  schema: {
+    name: "browser_generate_locator",
+    title: "Create locator for element",
+    description: "Generate locator for the given element to use in tests",
+    inputSchema: elementSchema,
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const locator = await tab.refLocator(params);
+    response.addResult(await (0, import_utils.generateLocator)(locator));
+  }
+});
 var snapshot_default = [
   snapshot,
   click,
   drag,
   hover,
-  selectOption
+  selectOption,
+  pickLocator
 ];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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

@@ -29,7 +29,7 @@ function defineTabTool(tool) {
   return {
     ...tool,
     handle: async (context, params, response) => {
-      const tab = context.currentTabOrDie();
+      const tab = await context.ensureTab();
       const modalStates = tab.modalStates().map((state) => state.type);
       if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState))
         response.addError(`Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.

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

@@ -36,7 +36,7 @@ var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
 var import_utils = require("./utils");
 const verifyElement = (0, import_tool.defineTabTool)({
-  capability: "verify",
+  capability: "testing",
   schema: {
     name: "browser_verify_element_visible",
     title: "Verify element visible",
@@ -58,7 +58,7 @@ const verifyElement = (0, import_tool.defineTabTool)({
   }
 });
 const verifyText = (0, import_tool.defineTabTool)({
-  capability: "verify",
+  capability: "testing",
   schema: {
     name: "browser_verify_text_visible",
     title: "Verify text visible",
@@ -79,7 +79,7 @@ const verifyText = (0, import_tool.defineTabTool)({
   }
 });
 const verifyList = (0, import_tool.defineTabTool)({
-  capability: "verify",
+  capability: "testing",
   schema: {
     name: "browser_verify_list_visible",
     title: "Verify list visible",
@@ -111,7 +111,7 @@ ${itemTexts.map((t) => `  - listitem: ${javascript.escapeWithQuotes(t, '"')}`).j
   }
 });
 const verifyValue = (0, import_tool.defineTabTool)({
-  capability: "verify",
+  capability: "testing",
   schema: {
     name: "browser_verify_value",
     title: "Verify value",

package/lib/mcp/browser/tools.js

@@ -28,7 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var tools_exports = {};
 __export(tools_exports, {
-  allTools: () => allTools,
+  browserTools: () => browserTools,
   filteredTools: () => filteredTools
 });
 module.exports = __toCommonJS(tools_exports);
@@ -50,7 +50,7 @@ var import_tabs = __toESM(require("./tools/tabs"));
 var import_tracing = __toESM(require("./tools/tracing"));
 var import_wait = __toESM(require("./tools/wait"));
 var import_verify = __toESM(require("./tools/verify"));
-const allTools = [
+const browserTools = [
   ...import_common.default,
   ...import_console.default,
   ...import_dialogs.default,
@@ -71,10 +71,10 @@ const allTools = [
   ...import_verify.default
 ];
 function filteredTools(config) {
-  return allTools.filter((tool) => tool.capability.startsWith("core") || config.capabilities?.includes(tool.capability));
+  return browserTools.filter((tool) => tool.capability.startsWith("core") || config.capabilities?.includes(tool.capability));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  allTools,
+  browserTools,
   filteredTools
 });

package/lib/mcp/test/browserBackend.js

@@ -28,66 +28,43 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var browserBackend_exports = {};
 __export(browserBackend_exports, {
-  BrowserBackend: () => BrowserBackend,
   runBrowserBackendOnError: () => runBrowserBackendOnError
 });
 module.exports = __toCommonJS(browserBackend_exports);
 var mcp = __toESM(require("../sdk/exports"));
-var mcpBundle = __toESM(require("../sdk/bundle"));
 var import_globals = require("../../common/globals");
-var import_browserTools = require("./browserTools");
 var import_util = require("../../util");
-const tools = [import_browserTools.snapshot, import_browserTools.pickLocator, import_browserTools.evaluate];
-class BrowserBackend {
-  constructor(page) {
-    this.name = "Playwright";
-    this.version = "0.0.1";
-    this._tools = tools;
-    this._page = page;
-  }
-  async initialize() {
-  }
-  async listTools() {
-    return [...this._tools.map((tool) => mcp.toMcpTool(tool.schema)), mcp.toMcpTool(doneToolSchema)];
-  }
-  async callTool(name, args) {
-    if (name === "done") {
-      this.requestSelfDestruct?.();
-      return {
-        content: [{ type: "text", text: "Done" }]
-      };
-    }
-    const tool = this._tools.find((tool2) => tool2.schema.name === name);
-    if (!tool)
-      throw new Error(`Tool not found: ${name}. Available tools: ${this._tools.map((tool2) => tool2.schema.name).join(", ")}`);
-    const parsedArguments = tool.schema.inputSchema.parse(args || {});
-    return await tool.handle(this._page, parsedArguments);
-  }
-}
-const doneToolSchema = mcp.defineToolSchema({
-  name: "done",
-  title: "Done",
-  description: "Done",
-  inputSchema: mcpBundle.z.object({}),
-  type: "destructive"
-});
+var import_config = require("../browser/config");
+var import_browserServerBackend = require("../browser/browserServerBackend");
 async function runBrowserBackendOnError(page, message) {
   const testInfo = (0, import_globals.currentTestInfo)();
   if (!testInfo || !testInfo._pauseOnError())
     return;
-  const snapshot2 = await page._snapshotForAI();
+  const browserContextFactory = {
+    createContext: async (clientInfo, abortSignal, toolName) => {
+      return {
+        browserContext: page.context(),
+        close: async () => {
+        }
+      };
+    }
+  };
+  const config = {
+    ...import_config.defaultConfig,
+    capabilities: ["testing"]
+  };
+  const snapshot = await page._snapshotForAI();
   const introMessage = `### Paused on error:
 ${(0, import_util.stripAnsiEscapes)(message())}
 
 ### Current page snapshot:
-${snapshot2}
+${snapshot}
 
 ### Task
-Try recovering from the error prior to continuing, use following tools to recover: ${tools.map((tool) => tool.schema.name).join(", ")}`;
-  await mcp.runOnPauseBackendLoop(new BrowserBackend(page), introMessage);
+Try recovering from the error prior to continuing`;
+  await mcp.runOnPauseBackendLoop(new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory), introMessage);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BrowserBackend,
   runBrowserBackendOnError
 });

package/lib/mcp/test/testBackend.js

@@ -34,7 +34,7 @@ module.exports = __toCommonJS(testBackend_exports);
 var mcp = __toESM(require("../sdk/exports"));
 var import_testContext = require("./testContext");
 var import_testTools = require("./testTools.js");
-var import_browserTools = require("./browserTools");
+var import_tools = require("../browser/tools");
 class TestServerBackend {
   constructor(resolvedLocation, options) {
     this.name = "Playwright";
@@ -45,9 +45,7 @@ class TestServerBackend {
   async listTools() {
     return [
       ...this._tools.map((tool) => mcp.toMcpTool(tool.schema)),
-      mcp.toMcpTool(import_browserTools.snapshot.schema),
-      mcp.toMcpTool(import_browserTools.pickLocator.schema),
-      mcp.toMcpTool(import_browserTools.evaluate.schema)
+      ...import_tools.browserTools.map((tool) => mcp.toMcpTool(tool.schema))
     ];
   }
   async callTool(name, args) {

package/lib/runner/testRunner.js

@@ -71,6 +71,7 @@ class TestRunner extends import_events.default {
     });
   }
   async initialize(params) {
+    (0, import_utils.setPlaywrightTestProcessEnv)();
     this._watchTestDirs = !!params.watchTestDirs;
     this._populateDependenciesOnList = !!params.populateDependenciesOnList;
   }
@@ -352,6 +353,7 @@ async function resolveCtDirs(config) {
   };
 }
 async function runAllTestsWithConfig(config) {
+  (0, import_utils.setPlaywrightTestProcessEnv)();
   const listOnly = config.cliListOnly;
   (0, import_gitCommitInfoPlugin.addGitCommitInfoPlugin)(config);
   (0, import_webServerPlugin.webServerPluginsForConfig)(config).forEach((p) => config.plugins.push({ factory: p }));

package/lib/util.js

@@ -30,7 +30,6 @@ var util_exports = {};
 __export(util_exports, {
   addSuffixToFilePath: () => addSuffixToFilePath,
   ansiRegex: () => ansiRegex,
-  callLogText: () => callLogText,
   createFileFiltersFromArguments: () => createFileFiltersFromArguments,
   createFileMatcher: () => createFileMatcher,
   createFileMatcherFromArguments: () => createFileMatcherFromArguments,
@@ -227,14 +226,6 @@ function getContainedPath(parentPath, subPath = "") {
   return null;
 }
 const debugTest = (0, import_utilsBundle.debug)("pw:test");
-const callLogText = (log) => {
-  if (!log || !log.some((l) => !!l))
-    return "";
-  return `
-Call log:
-${import_utilsBundle.colors.dim(log.join("\n"))}
-`;
-};
 const folderToPackageJsonPath = /* @__PURE__ */ new Map();
 function getPackageJsonPath(folderPath) {
   const cached = folderToPackageJsonPath.get(folderPath);
@@ -376,7 +367,6 @@ function stripAnsiEscapes(str) {
 0 && (module.exports = {
   addSuffixToFilePath,
   ansiRegex,
-  callLogText,
   createFileFiltersFromArguments,
   createFileMatcher,
   createFileMatcherFromArguments,

package/package.json

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

package/lib/mcp/test/browserTool.js

@@ -1,30 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var browserTool_exports = {};
-__export(browserTool_exports, {
-  defineBrowserTool: () => defineBrowserTool
-});
-module.exports = __toCommonJS(browserTool_exports);
-function defineBrowserTool(tool) {
-  return tool;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  defineBrowserTool
-});