playwright 1.56.0-alpha-1756505518000 → 1.56.0-alpha-2025-08-31

package/lib/index.js

@@ -222,7 +222,7 @@ const playwrightFixtures = {
     if ((0, import_utils.debugMode)() === "inspector")
       testInfo._setDebugMode();
     playwright._defaultContextOptions = _combinedContextOptions;
-    playwright._defaultContextTimeout = process.env.PLAYWRIGHT_DEBUGGER_MCP ? 5e3 : actionTimeout || 0;
+    playwright._defaultContextTimeout = process.env.PLAYWRIGHT_DEBUGGER_ENABLED ? 5e3 : actionTimeout || 0;
     playwright._defaultContextNavigationTimeout = navigationTimeout || 0;
     await use();
     playwright._defaultContextOptions = void 0;

package/lib/mcp/browser/backend.js

@@ -73,7 +73,7 @@ const doneToolSchema = (0, import_exports.defineToolSchema)({
   type: "destructive"
 });
 async function runBrowserBackendOnError(page, message) {
-  if (!process.env.PLAYWRIGHT_DEBUGGER_MCP)
+  if (!process.env.PLAYWRIGHT_DEBUGGER_ENABLED)
     return;
   const snapshot2 = await page._snapshotForAI();
   const introMessage = `### Paused on error:
@@ -84,7 +84,7 @@ ${snapshot2}
 
 ### Task
 Try recovering from the error prior to continuing, use following tools to recover: ${tools.map((tool) => tool.schema.name).join(", ")}`;
-  await (0, import_mdb.runOnPauseBackendLoop)(process.env.PLAYWRIGHT_DEBUGGER_MCP, new BrowserBackend(page), introMessage);
+  await (0, import_mdb.runOnPauseBackendLoop)(process.env.PLAYWRIGHT_MDB_URL, new BrowserBackend(page), introMessage);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/mcp/sdk/mdb.js

@@ -144,7 +144,7 @@ async function runMainBackend(backendFactory, options) {
     create: () => mdbBackend
   };
   const url = await startAsHttp(factory, { port: options?.port || 0 });
-  process.env.PLAYWRIGHT_DEBUGGER_MCP = url;
+  process.env.PLAYWRIGHT_MDB_URL = url;
   if (options?.port !== void 0)
     return url;
   await mcpServer.connect(factory, new mcpBundle.StdioServerTransport(), false);

package/lib/mcp/test/backend.js

@@ -33,22 +33,21 @@ __export(backend_exports, {
 module.exports = __toCommonJS(backend_exports);
 var mcp = __toESM(require("../sdk/exports.js"));
 var import_context = require("./context");
-var import_listTests = require("./listTests");
-var import_runTests = require("./runTests");
-var import_tools = require("../browser/tools");
+var import_tools = require("./tools.js");
+var import_tools2 = require("../browser/tools");
 class TestServerBackend {
   constructor(resolvedLocation, options) {
     this.name = "Playwright";
     this.version = "0.0.1";
-    this._tools = [import_listTests.listTests, import_runTests.runTests];
+    this._tools = [import_tools.listTests, import_tools.runTests, import_tools.debugTest];
     this._context = new import_context.Context(resolvedLocation, options);
   }
   async listTools() {
     return [
       ...this._tools.map((tool) => mcp.toMcpTool(tool.schema)),
-      mcp.toMcpTool(import_tools.snapshot.schema),
-      mcp.toMcpTool(import_tools.pickLocator.schema),
-      mcp.toMcpTool(import_tools.evaluate.schema)
+      mcp.toMcpTool(import_tools2.snapshot.schema),
+      mcp.toMcpTool(import_tools2.pickLocator.schema),
+      mcp.toMcpTool(import_tools2.evaluate.schema)
     ];
   }
   async callTool(name, args) {

package/lib/mcp/test/{runTests.js → tools.js}

@@ -26,27 +26,77 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var runTests_exports = {};
-__export(runTests_exports, {
+var tools_exports = {};
+__export(tools_exports, {
+  debugTest: () => debugTest,
+  listTests: () => listTests,
   runTests: () => runTests
 });
-module.exports = __toCommonJS(runTests_exports);
+module.exports = __toCommonJS(tools_exports);
 var import_utils = require("playwright-core/lib/utils");
 var import_bundle = require("../sdk/bundle");
 var import_base = require("../../reporters/base");
 var import_list = __toESM(require("../../reporters/list"));
+var import_listModeReporter = __toESM(require("../../reporters/listModeReporter"));
 var import_tool = require("./tool");
 var import_streams = require("./streams");
+const listTests = (0, import_tool.defineTool)({
+  schema: {
+    name: "playwright_test_list_tests",
+    title: "List tests",
+    description: "List tests",
+    inputSchema: import_bundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (context) => {
+    const { screen, stream } = createScreen();
+    const reporter = new import_listModeReporter.default({ screen, includeTestId: true });
+    const testRunner = await context.createTestRunner();
+    await testRunner.listTests(reporter, {});
+    return {
+      content: [{ type: "text", text: stream.content() }]
+    };
+  }
+});
 const runTests = (0, import_tool.defineTool)({
   schema: {
     name: "playwright_test_run_tests",
     title: "Run tests",
     description: "Run tests",
     inputSchema: import_bundle.z.object({
-      tests: import_bundle.z.array(import_bundle.z.object({
-        id: import_bundle.z.string().describe("Test ID to run."),
-        title: import_bundle.z.string().describe("Human readable test title for granting permission to run the test.")
-      })).optional().describe("Tests to run. All tests are run if not provided.")
+      locations: import_bundle.z.array(import_bundle.z.string()).describe('Folder, file or location to run: "test/e2e" or "test/e2e/file.spec.ts" or "test/e2e/file.spec.ts:20"'),
+      projects: import_bundle.z.array(import_bundle.z.string()).optional().describe('Projects to run, projects from playwright.config.ts, by default runs all projects. Running with "chromium" is a good start')
+    }),
+    type: "readOnly"
+  },
+  handle: async (context, params) => {
+    const { screen, stream } = createScreen();
+    const configDir = context.configLocation.configDir;
+    const reporter = new import_list.default({ configDir, screen, includeTestId: true });
+    const testRunner = await context.createTestRunner();
+    const result = await testRunner.runTests(reporter, {
+      locations: params.locations,
+      projects: params.projects
+    });
+    const text = stream.content();
+    return {
+      content: [
+        { type: "text", text }
+      ],
+      isError: result.status !== "passed"
+    };
+  }
+});
+const debugTest = (0, import_tool.defineTool)({
+  schema: {
+    name: "playwright_test_debug_test",
+    title: "Debug single test",
+    description: "Debug single test",
+    inputSchema: import_bundle.z.object({
+      test: import_bundle.z.object({
+        id: import_bundle.z.string().describe("Test ID to debug."),
+        title: import_bundle.z.string().describe("Human readable test title for granting permission to debug the test.")
+      })
     }),
     type: "readOnly"
   },
@@ -62,11 +112,15 @@ const runTests = (0, import_tool.defineTool)({
     const configDir = context.configLocation.configDir;
     const reporter = new import_list.default({ configDir, screen });
     const testRunner = await context.createTestRunner();
+    process.env.PLAYWRIGHT_DEBUGGER_ENABLED = "1";
     const result = await testRunner.runTests(reporter, {
-      testIds: params.tests?.map((test) => test.id),
+      headed: true,
+      testIds: [params.test.id],
       // For automatic recovery
       timeout: 0,
       workers: 1
+    }).finally(() => {
+      process.env.PLAYWRIGHT_DEBUGGER_ENABLED = void 0;
     });
     const text = stream.content();
     return {
@@ -77,7 +131,20 @@ const runTests = (0, import_tool.defineTool)({
     };
   }
 });
+function createScreen() {
+  const stream = new import_streams.StringWriteStream();
+  const screen = {
+    ...import_base.terminalScreen,
+    isTTY: false,
+    colors: import_utils.noColors,
+    stdout: stream,
+    stderr: stream
+  };
+  return { screen, stream };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  debugTest,
+  listTests,
   runTests
 });

package/lib/reporters/base.js

@@ -120,7 +120,7 @@ class TerminalReporter {
     this._fatalErrors = [];
     this._failureCount = 0;
     this.screen = options.screen ?? terminalScreen;
-    this._omitFailures = options.omitFailures || false;
+    this._options = options;
   }
   version() {
     return "v2";
@@ -258,7 +258,7 @@ class TerminalReporter {
   epilogue(full) {
     const summary = this.generateSummary();
     const summaryMessage = this.generateSummaryMessage(summary);
-    if (full && summary.failuresToPrint.length && !this._omitFailures)
+    if (full && summary.failuresToPrint.length && !this._options.omitFailures)
       this._printFailures(summary.failuresToPrint);
     this._printSlowTests();
     this._printSummary(summaryMessage);
@@ -284,14 +284,14 @@ class TerminalReporter {
   willRetry(test) {
     return test.outcome() === "unexpected" && test.results.length <= test.retries;
   }
-  formatTestTitle(test, step, omitLocation = false) {
-    return formatTestTitle(this.screen, this.config, test, step, omitLocation);
+  formatTestTitle(test, step) {
+    return formatTestTitle(this.screen, this.config, test, step, this._options);
   }
   formatTestHeader(test, options = {}) {
-    return formatTestHeader(this.screen, this.config, test, options);
+    return formatTestHeader(this.screen, this.config, test, { ...options, includeTestId: this._options.includeTestId });
   }
   formatFailure(test, index) {
-    return formatFailure(this.screen, this.config, test, index);
+    return formatFailure(this.screen, this.config, test, index, this._options);
   }
   formatError(error) {
     return formatError(this.screen, error);
@@ -300,9 +300,9 @@ class TerminalReporter {
     this.screen.stdout?.write(line ? line + "\n" : "\n");
   }
 }
-function formatFailure(screen, config, test, index) {
+function formatFailure(screen, config, test, index, options) {
   const lines = [];
-  const header = formatTestHeader(screen, config, test, { indent: "  ", index, mode: "error" });
+  const header = formatTestHeader(screen, config, test, { indent: "  ", index, mode: "error", includeTestId: options?.includeTestId });
   lines.push(screen.colors.red(header));
   for (const result of test.results) {
     const resultLines = [];
@@ -416,20 +416,18 @@ function stepSuffix(step) {
   const stepTitles = step ? step.titlePath() : [];
   return stepTitles.map((t) => t.split("\n")[0]).map((t) => " \u203A " + t).join("");
 }
-function formatTestTitle(screen, config, test, step, omitLocation = false) {
+function formatTestTitle(screen, config, test, step, options = {}) {
   const [, projectName, , ...titles] = test.titlePath();
-  let location;
-  if (omitLocation)
-    location = `${relativeTestPath(screen, config, test)}`;
-  else
-    location = `${relativeTestPath(screen, config, test)}:${test.location.line}:${test.location.column}`;
-  const projectTitle = projectName ? `[${projectName}] \u203A ` : "";
-  const testTitle = `${projectTitle}${location} \u203A ${titles.join(" \u203A ")}`;
+  const location = `${relativeTestPath(screen, config, test)}:${test.location.line}:${test.location.column}`;
+  const testId = options.includeTestId ? `[id=${test.id}] ` : "";
+  const projectLabel = options.includeTestId ? `project=` : "";
+  const projectTitle = projectName ? `[${projectLabel}${projectName}] \u203A ` : "";
+  const testTitle = `${testId}${projectTitle}${location} \u203A ${titles.join(" \u203A ")}`;
   const extraTags = test.tags.filter((t) => !testTitle.includes(t));
   return `${testTitle}${stepSuffix(step)}${extraTags.length ? " " + extraTags.join(" ") : ""}`;
 }
 function formatTestHeader(screen, config, test, options = {}) {
-  const title = formatTestTitle(screen, config, test);
+  const title = formatTestTitle(screen, config, test, void 0, options);
   const header = `${options.indent || ""}${options.index ? options.index + ") " : ""}${title}`;
   let fullHeader = header;
   if (options.mode === "error") {

package/lib/reporters/listModeReporter.js

@@ -34,7 +34,8 @@ module.exports = __toCommonJS(listModeReporter_exports);
 var import_path = __toESM(require("path"));
 var import_base = require("./base");
 class ListModeReporter {
-  constructor(options) {
+  constructor(options = {}) {
+    this._options = options;
     this.screen = options?.screen ?? import_base.terminalScreen;
   }
   version() {
@@ -50,8 +51,10 @@ class ListModeReporter {
     for (const test of tests) {
       const [, projectName, , ...titles] = test.titlePath();
       const location = `${import_path.default.relative(this.config.rootDir, test.location.file)}:${test.location.line}:${test.location.column}`;
-      const projectTitle = projectName ? `[${projectName}] \u203A ` : "";
-      this._writeLine(`  ${projectTitle}${location} \u203A ${titles.join(" \u203A ")}`);
+      const testId = this._options.includeTestId ? `[id=${test.id}] ` : "";
+      const projectLabel = this._options.includeTestId ? `project=` : "";
+      const projectTitle = projectName ? `[${projectLabel}${projectName}] \u203A ` : "";
+      this._writeLine(`  ${testId}${projectTitle}${location} \u203A ${titles.join(" \u203A ")}`);
       files.add(test.location.file);
     }
     this._writeLine(`Total: ${tests.length} ${tests.length === 1 ? "test" : "tests"} in ${files.size} ${files.size === 1 ? "file" : "files"}`);

package/package.json

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

package/lib/mcp/test/listTests.js

@@ -1,88 +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 listTests_exports = {};
-__export(listTests_exports, {
-  listTests: () => listTests
-});
-module.exports = __toCommonJS(listTests_exports);
-var import_path = __toESM(require("path"));
-var import_bundle = require("../sdk/bundle");
-var import_tool = require("./tool.js");
-const listTests = (0, import_tool.defineTool)({
-  schema: {
-    name: "playwright_test_list_tests",
-    title: "List tests",
-    description: "List tests",
-    inputSchema: import_bundle.z.object({}),
-    type: "readOnly"
-  },
-  handle: async (context, params) => {
-    const reporter = new ListModeReporter();
-    const testRunner = await context.createTestRunner();
-    await testRunner.listTests(reporter, {});
-    if (reporter.hasErrors())
-      throw new Error(reporter.content());
-    return {
-      content: [{ type: "text", text: reporter.content() }]
-    };
-  }
-});
-class ListModeReporter {
-  constructor() {
-    this._lines = [];
-    this._hasErrors = false;
-  }
-  onBegin(config, suite) {
-    this._lines.push(`Listing tests:`);
-    const tests = suite.allTests();
-    const files = /* @__PURE__ */ new Set();
-    for (const test of tests) {
-      const [, projectName, , ...titles] = test.titlePath();
-      const location = `${import_path.default.relative(config.rootDir, test.location.file)}:${test.location.line}:${test.location.column}`;
-      const projectTitle = projectName ? `[${projectName}] \u203A ` : "";
-      this._lines.push(`  [id=${test.id}] ${projectTitle}${location} \u203A ${titles.join(" \u203A ")}`);
-      files.add(test.location.file);
-    }
-    this._lines.push(`Total: ${tests.length} ${tests.length === 1 ? "test" : "tests"} in ${files.size} ${files.size === 1 ? "file" : "files"}`);
-  }
-  onError(error) {
-    this._hasErrors = true;
-    this._lines.push(error.stack || error.message || error.value || "");
-  }
-  hasErrors() {
-    return this._hasErrors;
-  }
-  content() {
-    return this._lines.join("\n");
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  listTests
-});