playwright 1.56.0-alpha-2025-09-16 → 1.56.0-alpha-2025-09-17

package/lib/mcp/browser/browserContextFactory.js

@@ -41,6 +41,7 @@ var import_server = require("playwright-core/lib/server");
 var import_processUtils = require("./processUtils");
 var import_log = require("../log");
 var import_config = require("./config");
+var import_server2 = require("../sdk/server");
 function contextFactory(config) {
   if (config.browser.remoteEndpoint)
     return new RemoteContextFactory(config);
@@ -99,7 +100,7 @@ class IsolatedContextFactory extends BaseContextFactory {
   async _doObtainBrowser(clientInfo) {
     await injectCdpPort(this.config.browser);
     const browserType = playwright[this.config.browser.browserName];
-    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo.rootPath, `traces`);
+    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo, `traces`);
     if (this.config.saveTrace)
       await startTraceServer(this.config, tracesDir);
     return browserType.launch({
@@ -153,8 +154,8 @@ class PersistentContextFactory {
   async createContext(clientInfo) {
     await injectCdpPort(this.config.browser);
     (0, import_log.testDebug)("create browser context (persistent)");
-    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo.rootPath);
-    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo.rootPath, `traces`);
+    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo);
+    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo, `traces`);
     if (this.config.saveTrace)
       await startTraceServer(this.config, tracesDir);
     this._userDataDirs.add(userDataDir);
@@ -196,9 +197,10 @@ class PersistentContextFactory {
     this._userDataDirs.delete(userDataDir);
     (0, import_log.testDebug)("close browser context complete (persistent)");
   }
-  async _createUserDataDir(rootPath) {
+  async _createUserDataDir(clientInfo) {
     const dir = process.env.PWMCP_PROFILES_DIR_FOR_TEST ?? import_registry.registryDirectory;
     const browserToken = this.config.browser.launchOptions?.channel ?? this.config.browser?.browserName;
+    const rootPath = (0, import_server2.firstRootPath)(clientInfo);
     const rootPathToken = rootPath ? `-${createHash(rootPath)}` : "";
     const result = import_path.default.join(dir, `mcp-${browserToken}${rootPathToken}`);
     await import_fs.default.promises.mkdir(result, { recursive: true });

package/lib/mcp/browser/browserServerBackend.js

@@ -21,7 +21,6 @@ __export(browserServerBackend_exports, {
   BrowserServerBackend: () => BrowserServerBackend
 });
 module.exports = __toCommonJS(browserServerBackend_exports);
-var import_url = require("url");
 var import_context = require("./context");
 var import_log = require("../log");
 var import_response = require("./response");
@@ -34,19 +33,13 @@ class BrowserServerBackend {
     this._browserContextFactory = factory;
     this._tools = (0, import_tools.filteredTools)(config);
   }
-  async initialize(server, clientVersion, roots) {
-    let rootPath;
-    if (roots.length > 0) {
-      const firstRootUri = roots[0]?.uri;
-      const url = firstRootUri ? new URL(firstRootUri) : void 0;
-      rootPath = url ? (0, import_url.fileURLToPath)(url) : void 0;
-    }
-    this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, rootPath) : void 0;
+  async initialize(server, clientInfo) {
+    this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, clientInfo) : void 0;
     this._context = new import_context.Context({
       config: this._config,
       browserContextFactory: this._browserContextFactory,
       sessionLog: this._sessionLog,
-      clientInfo: { ...clientVersion, rootPath }
+      clientInfo
     });
   }
   async listTools() {

package/lib/mcp/browser/config.js

@@ -45,6 +45,7 @@ var import_os = __toESM(require("os"));
 var import_path = __toESM(require("path"));
 var import_playwright_core = require("playwright-core");
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_server = require("../sdk/server");
 const defaultConfig = {
   browser: {
     browserName: "chromium",
@@ -215,8 +216,9 @@ async function loadConfig(configFile) {
     throw new Error(`Failed to load config file: ${configFile}, ${error}`);
   }
 }
-async function outputFile(config, rootPath, name) {
-  const outputDir = config.outputDir ?? (rootPath ? import_path.default.join(rootPath, ".playwright-mcp") : void 0) ?? import_path.default.join(import_os.default.tmpdir(), "playwright-mcp-output", sanitizeForFilePath((/* @__PURE__ */ new Date()).toISOString()));
+async function outputFile(config, clientInfo, name) {
+  const rootPath = (0, import_server.firstRootPath)(clientInfo);
+  const outputDir = config.outputDir ?? (rootPath ? import_path.default.join(rootPath, ".playwright-mcp") : void 0) ?? import_path.default.join(process.env.PW_TMPDIR_FOR_TEST ?? import_os.default.tmpdir(), "playwright-mcp-output", String(clientInfo.timestamp));
   await import_fs.default.promises.mkdir(outputDir, { recursive: true });
   const fileName = sanitizeForFilePath(name);
   return import_path.default.join(outputDir, fileName);

package/lib/mcp/browser/context.js

@@ -96,7 +96,7 @@ class Context {
     return url;
   }
   async outputFile(name) {
-    return (0, import_config.outputFile)(this.config, this._clientInfo.rootPath, name);
+    return (0, import_config.outputFile)(this.config, this._clientInfo, name);
   }
   _onPageCreated(page) {
     const tab = new import_tab.Tab(this, page, (tab2) => this._onPageClosed(tab2));

package/lib/mcp/browser/sessionLog.js

@@ -43,8 +43,8 @@ class SessionLog {
     this._folder = sessionFolder;
     this._file = import_path.default.join(this._folder, "session.md");
   }
-  static async create(config, rootPath) {
-    const sessionFolder = await (0, import_config.outputFile)(config, rootPath, `session-${Date.now()}`);
+  static async create(config, clientInfo) {
+    const sessionFolder = await (0, import_config.outputFile)(config, clientInfo, `session-${Date.now()}`);
     await import_fs.default.promises.mkdir(sessionFolder, { recursive: true });
     console.error(`Session: ${sessionFolder}`);
     return new SessionLog(sessionFolder);

package/lib/mcp/sdk/mdb.js

@@ -48,9 +48,9 @@ class MDBBackend {
     this._stack = [];
     this._topLevelBackend = topLevelBackend;
   }
-  async initialize(server, clientVersion, roots) {
-    if (!this._roots)
-      this._roots = roots;
+  async initialize(server, clientInfo) {
+    if (!this._clientInfo)
+      this._clientInfo = clientInfo;
   }
   async listTools() {
     const client = await this._client();
@@ -103,8 +103,8 @@ class MDBBackend {
   }
   async _pushClient(transport, introMessage) {
     mdbDebug("pushing client to the stack");
-    const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" }, { capabilities: { roots: {} } });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots || [] }));
+    const client = new mcpBundle.Client({ name: "Pushing client", version: "0.0.0" }, { capabilities: { roots: {} } });
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     await client.connect(transport);
     mdbDebug("connected to the new client");
@@ -155,7 +155,7 @@ async function runOnPauseBackendLoop(backend, introMessage) {
   const httpServer = await mcpHttp.startHttpServer({ port: 0 });
   await mcpHttp.installHttpTransport(httpServer, factory);
   const url = mcpHttp.httpAddressToString(httpServer.address());
-  const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" });
+  const client = new mcpBundle.Client({ name: "On-pause client", version: "0.0.0" });
   client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
   const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(process.env.PLAYWRIGHT_DEBUGGER_MCP));
   await client.connect(transport);
@@ -183,8 +183,8 @@ class ServerBackendWithCloseListener {
     this._serverClosedPromise = new import_utils.ManualPromise();
     this._backend = backend;
   }
-  async initialize(server, clientVersion, roots) {
-    await this._backend.initialize?.(server, clientVersion, roots);
+  async initialize(server, clientInfo) {
+    await this._backend.initialize?.(server, clientInfo);
   }
   async listTools() {
     return this._backend.listTools();

package/lib/mcp/sdk/proxyBackend.js

@@ -37,12 +37,11 @@ const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
 const { z, zodToJsonSchema } = mcpBundle;
 class ProxyBackend {
   constructor(mcpProviders) {
-    this._roots = [];
     this._mcpProviders = mcpProviders;
     this._contextSwitchTool = this._defineContextSwitchTool();
   }
-  async initialize(server, clientVersion, roots) {
-    this._roots = roots;
+  async initialize(server, clientInfo) {
+    this._clientInfo = clientInfo;
   }
   async listTools() {
     const currentClient = await this._ensureCurrentClient();
@@ -115,7 +114,7 @@ Error: ${error}
         listRoots: true
       }
     });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots }));
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     const transport = await factory.connect();
     await client.connect(transport);

package/lib/mcp/sdk/server.js

@@ -30,10 +30,12 @@ var server_exports = {};
 __export(server_exports, {
   connect: () => connect,
   createServer: () => createServer,
+  firstRootPath: () => firstRootPath,
   start: () => start,
   wrapInProcess: () => wrapInProcess
 });
 module.exports = __toCommonJS(server_exports);
+var import_url = require("url");
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var mcpBundle = __toESM(require("./bundle"));
 var import_http = require("./http");
@@ -83,8 +85,13 @@ const initializeServer = async (server, backend, runHeartbeat) => {
     const { roots } = await server.listRoots();
     clientRoots = roots;
   }
-  const clientVersion = server.getClientVersion() ?? { name: "unknown", version: "unknown" };
-  await backend.initialize?.(server, clientVersion, clientRoots);
+  const clientInfo = {
+    name: server.getClientVersion()?.name ?? "unknown",
+    version: server.getClientVersion()?.version ?? "unknown",
+    roots: clientRoots,
+    timestamp: Date.now()
+  };
+  await backend.initialize?.(server, clientInfo);
   if (runHeartbeat)
     startHeartbeat(server);
 };
@@ -128,10 +135,18 @@ async function start(serverBackendFactory, options) {
   ].join("\n");
   console.error(message);
 }
+function firstRootPath(clientInfo) {
+  if (clientInfo.roots.length === 0)
+    return void 0;
+  const firstRootUri = clientInfo.roots[0]?.uri;
+  const url = firstRootUri ? new URL(firstRootUri) : void 0;
+  return url ? (0, import_url.fileURLToPath)(url) : void 0;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   connect,
   createServer,
+  firstRootPath,
   start,
   wrapInProcess
 });

package/lib/mcp/test/testBackend.js

@@ -31,7 +31,6 @@ __export(testBackend_exports, {
   TestServerBackend: () => TestServerBackend
 });
 module.exports = __toCommonJS(testBackend_exports);
-var import_url = require("url");
 var mcp = __toESM(require("../sdk/exports"));
 var import_testContext = require("./testContext");
 var import_testTools = require("./testTools.js");
@@ -45,19 +44,15 @@ class TestServerBackend {
     this._context = new import_testContext.TestContext(options);
     this._configOption = configOption;
   }
-  async initialize(server, clientVersion, roots) {
+  async initialize(server, clientInfo) {
     if (this._configOption) {
       this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(this._configOption));
       return;
     }
-    if (roots.length > 0) {
-      const firstRootUri = roots[0]?.uri;
-      const url = firstRootUri ? new URL(firstRootUri) : void 0;
-      const folder = url ? (0, import_url.fileURLToPath)(url) : void 0;
-      if (folder) {
-        this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(folder));
-        return;
-      }
+    const rootPath = mcp.firstRootPath(clientInfo);
+    if (rootPath) {
+      this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(rootPath));
+      return;
     }
     throw new Error("No config option or MCP root path provided");
   }

package/lib/mcp/test/testTools.js

@@ -144,7 +144,10 @@ const setupPage = (0, import_testTool.defineTestTool)({
     let testLocation = params.testLocation;
     if (!testLocation) {
       testLocation = ".template.spec.ts";
-      const templateFile = import_path.default.join(configDir, testLocation);
+      const config = await testRunner.loadConfig();
+      const project = params.project ? config.projects.find((p) => p.project.name === params.project) : config.projects[0];
+      const testDir = project?.project.testDir || configDir;
+      const templateFile = import_path.default.join(testDir, testLocation);
       if (!import_fs.default.existsSync(templateFile)) {
         await import_fs.default.promises.writeFile(templateFile, `
           import { test, expect } from '@playwright/test';

package/lib/mcp/vscode/host.js

@@ -50,12 +50,10 @@ class VSCodeProxyBackend {
     this._defaultTransportFactory = _defaultTransportFactory;
     this.name = "Playwright MCP Client Switcher";
     this.version = packageJSON.version;
-    this._roots = [];
     this._contextSwitchTool = this._defineContextSwitchTool();
   }
-  async initialize(server, clientVersion, roots) {
-    this._clientVersion = clientVersion;
-    this._roots = roots;
+  async initialize(server, clientInfo) {
+    this._clientInfo = clientInfo;
     const transport = await this._defaultTransportFactory(this);
     await this._setCurrentClient(transport);
   }
@@ -147,13 +145,13 @@ class VSCodeProxyBackend {
   async _setCurrentClient(transport) {
     await this._currentClient?.close();
     this._currentClient = void 0;
-    const client = new mcpBundle.Client(this._clientVersion);
+    const client = new mcpBundle.Client({ name: this._clientInfo.name, version: this._clientInfo.version });
     client.registerCapabilities({
       roots: {
         listRoots: true
       }
     });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots }));
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo.roots }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     await client.connect(transport);
     this._currentClient = client;

package/lib/runner/testRunner.js

@@ -95,6 +95,12 @@ class TestRunner extends import_events.default {
     const executables = import_server.registry.defaultExecutables();
     await import_server.registry.install(executables, false);
   }
+  async loadConfig() {
+    const { config, error } = await this._loadConfig(this._configCLIOverrides);
+    if (config)
+      return config;
+    throw new Error("Failed to load config: " + (error ? error.message : "Unknown error"));
+  }
   async runGlobalSetup(userReporters) {
     await this.runGlobalTeardown();
     const reporter = new import_internalReporter.InternalReporter(userReporters);

package/lib/worker/fixtureRunner.js

@@ -96,6 +96,8 @@ class Fixture {
     this._selfTeardownComplete = (async () => {
       try {
         await this.registration.fn(params, useFunc, info);
+        if (!useFuncStarted.isDone())
+          throw new Error(`use() was not called in fixture "${this.registration.name}"`);
       } catch (error) {
         this.failed = true;
         if (!useFuncStarted.isDone())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.56.0-alpha-2025-09-16",
+  "version": "1.56.0-alpha-2025-09-17",
   "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-16"
+    "playwright-core": "1.56.0-alpha-2025-09-17"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"