playwright 1.56.0-alpha-1756475278000 → 1.56.0-alpha-2025-08-30

package/lib/common/config.js

@@ -112,7 +112,7 @@ class FullConfigInternal {
     } else {
       this.webServers = [];
     }
-    const projectConfigs = configCLIOverrides.projects || userConfig.projects || [userConfig];
+    const projectConfigs = configCLIOverrides.projects || userConfig.projects || [{ ...userConfig, workers: void 0 }];
     this.projects = projectConfigs.map((p) => new FullProjectInternal(configDir, userConfig, this, p, this.configCLIOverrides, packageJsonDir));
     resolveProjectDependencies(this.projects);
     this._assignUniqueProjectIds(this.projects);

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/bundle.js

@@ -25,6 +25,7 @@ __export(bundle_exports, {
   PingRequestSchema: () => PingRequestSchema,
   SSEServerTransport: () => SSEServerTransport,
   Server: () => Server,
+  StdioClientTransport: () => StdioClientTransport,
   StdioServerTransport: () => StdioServerTransport,
   StreamableHTTPClientTransport: () => StreamableHTTPClientTransport,
   StreamableHTTPServerTransport: () => StreamableHTTPServerTransport,
@@ -37,6 +38,7 @@ const zodToJsonSchema = bundle.zodToJsonSchema;
 const Client = bundle.Client;
 const Server = bundle.Server;
 const SSEServerTransport = bundle.SSEServerTransport;
+const StdioClientTransport = bundle.StdioClientTransport;
 const StdioServerTransport = bundle.StdioServerTransport;
 const StreamableHTTPServerTransport = bundle.StreamableHTTPServerTransport;
 const StreamableHTTPClientTransport = bundle.StreamableHTTPClientTransport;
@@ -54,6 +56,7 @@ const z = bundle.z;
   PingRequestSchema,
   SSEServerTransport,
   Server,
+  StdioClientTransport,
   StdioServerTransport,
   StreamableHTTPClientTransport,
   StreamableHTTPServerTransport,

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) {
@@ -56,11 +55,7 @@ class TestServerBackend {
     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 || {});
-    const result = await tool.handle(this._context, parsedArguments);
-    const stdio = this._context.takeStdio();
-    if (stdio.trim())
-      result.content.push({ type: "text", text: stdio });
-    return result;
+    return await tool.handle(this._context, parsedArguments);
   }
   serverClosed() {
     void this._context.close();

package/lib/mcp/test/context.js

@@ -24,7 +24,6 @@ module.exports = __toCommonJS(context_exports);
 var import_testRunner = require("../../runner/testRunner");
 class Context {
   constructor(configLocation, options) {
-    this._stdio = [];
     this.configLocation = configLocation;
     this.options = options;
   }
@@ -32,13 +31,7 @@ class Context {
     if (this._testRunner)
       await this._testRunner.stopTests();
     const testRunner = new import_testRunner.TestRunner(this.configLocation, {});
-    await testRunner.initialize({
-      sendStdioEvents: true,
-      muteConsole: this.options?.muteConsole
-    });
-    testRunner.on(import_testRunner.TestRunnerEvent.StdioChunk, (chunk, stdio) => {
-      this._stdio.push({ chunk, stdio });
-    });
+    await testRunner.initialize({});
     this._testRunner = testRunner;
     testRunner.on(import_testRunner.TestRunnerEvent.TestFilesChanged, (testFiles) => {
       this._testRunner?.emit(import_testRunner.TestRunnerEvent.TestFilesChanged, testFiles);
@@ -46,19 +39,9 @@ class Context {
     this._testRunner = testRunner;
     return testRunner;
   }
-  takeStdio() {
-    const text = this._stdio.map((entry) => chunkToPayload(entry.stdio, entry.chunk)).join("\n");
-    this._stdio = [];
-    return text;
-  }
   async close() {
   }
 }
-function chunkToPayload(type, chunk) {
-  if (chunk instanceof Uint8Array)
-    return "<binary>";
-  return `[${type}] ${chunk}`;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Context

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
 });