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

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/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-2025-09-11",
   "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-2025-09-11"
   },
   "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
-});

package/lib/mcp/test/browserTools.js

@@ -1,120 +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 browserTools_exports = {};
-__export(browserTools_exports, {
-  elementSchema: () => elementSchema,
-  evaluate: () => evaluate,
-  pickLocator: () => pickLocator,
-  snapshot: () => snapshot
-});
-module.exports = __toCommonJS(browserTools_exports);
-var import_utils = require("playwright-core/lib/utils");
-var import_browserTool = require("./browserTool.js");
-var mcpBundle = __toESM(require("../sdk/bundle"));
-const { z } = mcpBundle;
-const snapshot = (0, import_browserTool.defineBrowserTool)({
-  schema: {
-    name: "playwright_test_browser_snapshot",
-    title: "Capture page snapshot",
-    description: "Capture page snapshot for debugging",
-    inputSchema: z.object({}),
-    type: "readOnly"
-  },
-  handle: async (page, params) => {
-    const snapshot2 = await page._snapshotForAI();
-    return {
-      content: [
-        {
-          type: "text",
-          text: snapshot2
-        }
-      ]
-    };
-  }
-});
-const elementSchema = z.object({
-  element: z.string().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().describe("Exact target element reference from the page snapshot")
-});
-const pickLocator = (0, import_browserTool.defineBrowserTool)({
-  schema: {
-    name: "playwright_test_generate_locator",
-    title: "Create locator for element",
-    description: "Generate locator for the given element to use in tests",
-    inputSchema: elementSchema,
-    type: "readOnly"
-  },
-  handle: async (page, params) => {
-    const locator = await refLocator(page, params);
-    try {
-      const { resolvedSelector } = await locator._resolveSelector();
-      const locatorString = (0, import_utils.asLocator)("javascript", resolvedSelector);
-      return { content: [{ type: "text", text: locatorString }] };
-    } catch (e) {
-      throw new Error(`Ref not found, likely because element was removed. Use ${snapshot.schema.name} to see what elements are currently on the page.`);
-    }
-  }
-});
-const evaluateSchema = z.object({
-  function: z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
-  element: z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
-  ref: z.string().optional().describe("Exact target element reference from the page snapshot")
-});
-const evaluate = (0, import_browserTool.defineBrowserTool)({
-  schema: {
-    name: "playwright_test_evaluate_on_pause",
-    title: "Evaluate in page",
-    description: "Evaluate JavaScript expression on page or element",
-    inputSchema: evaluateSchema,
-    type: "destructive"
-  },
-  handle: async (page, params) => {
-    let locator;
-    if (params.ref && params.element)
-      locator = await refLocator(page, { ref: params.ref, element: params.element });
-    const receiver = locator ?? page;
-    const result = await receiver._evaluateFunction(params.function);
-    return {
-      content: [{ type: "text", text: JSON.stringify(result, null, 2) || "undefined" }]
-    };
-  }
-});
-async function refLocator(page, elementRef) {
-  const snapshot2 = await page._snapshotForAI();
-  if (!snapshot2.includes(`[ref=${elementRef.ref}]`))
-    throw new Error(`Ref ${elementRef.ref} not found in the current page snapshot. Try capturing new snapshot.`);
-  return page.locator(`aria-ref=${elementRef.ref}`).describe(elementRef.element);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  elementSchema,
-  evaluate,
-  pickLocator,
-  snapshot
-});