playwright 1.56.0-alpha-2025-09-04 → 1.56.0-alpha-1757023974000

package/lib/matchers/matcherHint.js

@@ -20,12 +20,10 @@ var matcherHint_exports = {};
 __export(matcherHint_exports, {
   ExpectError: () => ExpectError,
   isJestError: () => isJestError,
-  kNoElementsFoundError: () => kNoElementsFoundError,
   matcherHint: () => matcherHint
 });
 module.exports = __toCommonJS(matcherHint_exports);
 var import_utils = require("playwright-core/lib/utils");
-const kNoElementsFoundError = "<element(s) not found>";
 function matcherHint(state, locator, matcherName, expression, actual, matcherOptions, timeout, expectedReceivedString, preventExtraStatIndent = false) {
   let header = state.utils.matcherHint(matcherName, expression, actual, matcherOptions).replace(/ \/\/ deep equality/, "") + " failed\n\n";
   const extraSpace = preventExtraStatIndent ? "" : " ";
@@ -58,6 +56,5 @@ function isJestError(e) {
 0 && (module.exports = {
   ExpectError,
   isJestError,
-  kNoElementsFoundError,
   matcherHint
 });

package/lib/matchers/toBeTruthy.js

@@ -31,10 +31,7 @@ async function toBeTruthy(matcherName, receiver, receiverType, expected, arg, qu
     promise: this.promise
   };
   const timeout = options.timeout ?? this.timeout;
-  const { matches: pass, log, timedOut, received } = await query(!!this.isNot, timeout).catch(async (error) => {
-    await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
-    throw error;
-  });
+  const { matches: pass, log, timedOut, received, errorMessage } = await query(!!this.isNot, timeout);
   if (pass === !this.isNot) {
     return {
       name: matcherName,
@@ -43,15 +40,14 @@ async function toBeTruthy(matcherName, receiver, receiverType, expected, arg, qu
       expected
     };
   }
-  const notFound = received === import_matcherHint.kNoElementsFoundError ? received : void 0;
   let printedReceived;
   let printedExpected;
   if (pass) {
     printedExpected = `Expected: not ${expected}`;
-    printedReceived = `Received: ${notFound ? import_matcherHint.kNoElementsFoundError : expected}`;
+    printedReceived = errorMessage ?? `Received: ${expected}`;
   } else {
     printedExpected = `Expected: ${expected}`;
-    printedReceived = `Received: ${notFound ? import_matcherHint.kNoElementsFoundError : received}`;
+    printedReceived = errorMessage ?? `Received: ${received}`;
   }
   const message = () => {
     const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", arg, matcherOptions, timedOut ? timeout : void 0, `${printedExpected}

package/lib/matchers/toEqual.js

@@ -35,10 +35,7 @@ async function toEqual(matcherName, receiver, receiverType, query, expected, opt
     promise: this.promise
   };
   const timeout = options.timeout ?? this.timeout;
-  const { matches: pass, received, log, timedOut } = await query(!!this.isNot, timeout).catch(async (error) => {
-    await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
-    throw error;
-  });
+  const { matches: pass, received, log, timedOut, errorMessage } = await query(!!this.isNot, timeout);
   if (pass === !this.isNot) {
     return {
       name: matcherName,
@@ -52,7 +49,10 @@ async function toEqual(matcherName, receiver, receiverType, query, expected, opt
   let printedDiff;
   if (pass) {
     printedExpected = `Expected: not ${this.utils.printExpected(expected)}`;
-    printedReceived = `Received: ${this.utils.printReceived(received)}`;
+    printedReceived = errorMessage ?? `Received: ${this.utils.printReceived(received)}`;
+  } else if (errorMessage) {
+    printedExpected = `Expected: ${this.utils.printExpected(expected)}`;
+    printedReceived = errorMessage;
   } else if (Array.isArray(expected) && Array.isArray(received)) {
     const normalizedExpected = expected.map((exp, index) => {
       const rec = received[index];

package/lib/matchers/toMatchAriaSnapshot.js

@@ -35,7 +35,6 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_utils = require("playwright-core/lib/utils");
 var import_matcherHint = require("./matcherHint");
-var import_expectBundle = require("../common/expectBundle");
 var import_util = require("../util");
 var import_expect = require("./expect");
 var import_globals = require("../common/globals");
@@ -75,17 +74,16 @@ async function toMatchAriaSnapshot(receiver, expectedParam, options = {}) {
     }
   }
   expected = unshift(expected);
-  const { matches: pass, received, log, timedOut } = await receiver._expect("to.match.aria", { expectedValue: expected, isNot: this.isNot, timeout });
+  const { matches: pass, received, log, timedOut, errorMessage } = await receiver._expect("to.match.aria", { expectedValue: expected, isNot: this.isNot, timeout });
   const typedReceived = received;
   const matcherHintWithExpect = (expectedReceivedString) => {
     return (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0, expectedReceivedString);
   };
-  const notFound = typedReceived === import_matcherHint.kNoElementsFoundError;
-  if (notFound) {
+  if (errorMessage) {
     return {
       pass: this.isNot,
       message: () => matcherHintWithExpect(`Expected: ${this.utils.printExpected(expected)}
-Received: ${(0, import_expectBundle.EXPECTED_COLOR)("<element not found>")}`) + (0, import_util.callLogText)(log),
+${errorMessage}`) + (0, import_util.callLogText)(log),
       name: "toMatchAriaSnapshot",
       expected
     };
@@ -93,14 +91,13 @@ Received: ${(0, import_expectBundle.EXPECTED_COLOR)("<element not found>")}`) +
   const receivedText = typedReceived.raw;
   const message = () => {
     if (pass) {
-      const receivedString = notFound ? receivedText : (0, import_expect.printReceivedStringContainExpectedSubstring)(receivedText, receivedText.indexOf(expected), expected.length);
+      const receivedString = (0, import_expect.printReceivedStringContainExpectedSubstring)(receivedText, receivedText.indexOf(expected), expected.length);
       const expectedReceivedString = `Expected: not ${this.utils.printExpected(expected)}
 Received: ${receivedString}`;
       return matcherHintWithExpect(expectedReceivedString) + (0, import_util.callLogText)(log);
     } else {
       const labelExpected = `Expected`;
-      const expectedReceivedString = notFound ? `${labelExpected}: ${this.utils.printExpected(expected)}
-Received: ${receivedText}` : this.utils.printDiffOrStringify(expected, receivedText, labelExpected, "Received", false);
+      const expectedReceivedString = this.utils.printDiffOrStringify(expected, receivedText, labelExpected, "Received", false);
       return matcherHintWithExpect(expectedReceivedString) + (0, import_util.callLogText)(log);
     }
   };

package/lib/matchers/toMatchText.js

@@ -41,11 +41,7 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
     ].join("\n\n"));
   }
   const timeout = options.timeout ?? this.timeout;
-  const { matches: pass, received, log, timedOut } = await query(!!this.isNot, timeout).catch(async (error) => {
-    if (receiverType === "Locator")
-      await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
-    throw error;
-  });
+  const { matches: pass, received, log, timedOut, errorMessage } = await query(!!this.isNot, timeout);
   if (pass === !this.isNot) {
     return {
       name: matcherName,
@@ -56,35 +52,32 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
   }
   const stringSubstring = options.matchSubstring ? "substring" : "string";
   const receivedString = received || "";
-  const notFound = received === import_matcherHint.kNoElementsFoundError;
   let printedReceived;
   let printedExpected;
   let printedDiff;
   if (pass) {
     if (typeof expected === "string") {
-      if (notFound) {
-        printedExpected = `Expected ${stringSubstring}: not ${this.utils.printExpected(expected)}`;
-        printedReceived = `Received: ${received}`;
+      printedExpected = `Expected ${stringSubstring}: not ${this.utils.printExpected(expected)}`;
+      if (errorMessage) {
+        printedReceived = errorMessage;
       } else {
-        printedExpected = `Expected ${stringSubstring}: not ${this.utils.printExpected(expected)}`;
         const formattedReceived = (0, import_expect.printReceivedStringContainExpectedSubstring)(receivedString, receivedString.indexOf(expected), expected.length);
         printedReceived = `Received string: ${formattedReceived}`;
       }
     } else {
-      if (notFound) {
-        printedExpected = `Expected pattern: not ${this.utils.printExpected(expected)}`;
-        printedReceived = `Received: ${received}`;
+      printedExpected = `Expected pattern: not ${this.utils.printExpected(expected)}`;
+      if (errorMessage) {
+        printedReceived = errorMessage;
       } else {
-        printedExpected = `Expected pattern: not ${this.utils.printExpected(expected)}`;
         const formattedReceived = (0, import_expect.printReceivedStringContainExpectedResult)(receivedString, typeof expected.exec === "function" ? expected.exec(receivedString) : null);
         printedReceived = `Received string: ${formattedReceived}`;
       }
     }
   } else {
     const labelExpected = `Expected ${typeof expected === "string" ? stringSubstring : "pattern"}`;
-    if (notFound) {
+    if (errorMessage) {
       printedExpected = `${labelExpected}: ${this.utils.printExpected(expected)}`;
-      printedReceived = `Received: ${received}`;
+      printedReceived = errorMessage;
     } else {
       printedDiff = this.utils.printDiffOrStringify(expected, receivedString, labelExpected, "Received string", false);
     }

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) {
@@ -118,7 +119,7 @@ class CdpContextFactory extends BaseContextFactory {
     super("cdp", config);
   }
   async _doObtainBrowser() {
-    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint);
+    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, { headers: this.config.browser.cdpHeaders });
   }
   async _doCreateContext(browser) {
     return this.config.browser.isolated ? await browser.newContext() : browser.contexts()[0];
@@ -155,27 +156,27 @@ 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++) {
-      try {
-        const browserContext = await browserType.launchPersistentContext(userDataDir, {
-          tracesDir,
-          ...this.config.browser.launchOptions,
-          ...this.config.browser.contextOptions,
-          handleSIGINT: false,
-          handleSIGTERM: false
-        });
-        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));
+    }
+    try {
+      const browserContext = await browserType.launchPersistentContext(userDataDir, {
+        tracesDir,
+        ...this.config.browser.launchOptions,
+        ...this.config.browser.contextOptions,
+        handleSIGINT: false,
+        handleSIGTERM: false
+      });
+      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)");
@@ -194,6 +195,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/config.js

@@ -30,6 +30,8 @@ var config_exports = {};
 __export(config_exports, {
   commaSeparatedList: () => commaSeparatedList,
   configFromCLIOptions: () => configFromCLIOptions,
+  dotenvFileLoader: () => dotenvFileLoader,
+  headerParser: () => headerParser,
   outputFile: () => outputFile,
   resolveCLIConfig: () => resolveCLIConfig,
   resolveConfig: () => resolveConfig,
@@ -40,6 +42,7 @@ var import_fs = __toESM(require("fs"));
 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");
 const defaultConfig = {
   browser: {
     browserName: "chromium",
@@ -137,7 +140,8 @@ function configFromCLIOptions(cliOptions) {
       userDataDir: cliOptions.userDataDir,
       launchOptions,
       contextOptions,
-      cdpEndpoint: cliOptions.cdpEndpoint
+      cdpEndpoint: cliOptions.cdpEndpoint,
+      cdpHeaders: cliOptions.cdpHeader
     },
     server: {
       port: cliOptions.port,
@@ -150,6 +154,7 @@ function configFromCLIOptions(cliOptions) {
     },
     saveSession: cliOptions.saveSession,
     saveTrace: cliOptions.saveTrace,
+    secrets: cliOptions.secrets,
     outputDir: cliOptions.outputDir,
     imageResponses: cliOptions.imageResponses
   };
@@ -163,6 +168,7 @@ function configFromEnv() {
   options.browser = envToString(process.env.PLAYWRIGHT_MCP_BROWSER);
   options.caps = commaSeparatedList(process.env.PLAYWRIGHT_MCP_CAPS);
   options.cdpEndpoint = envToString(process.env.PLAYWRIGHT_MCP_CDP_ENDPOINT);
+  options.cdpHeader = headerParser(process.env.PLAYWRIGHT_MCP_CDP_HEADERS, {});
   options.config = envToString(process.env.PLAYWRIGHT_MCP_CONFIG);
   options.device = envToString(process.env.PLAYWRIGHT_MCP_DEVICE);
   options.executablePath = envToString(process.env.PLAYWRIGHT_MCP_EXECUTABLE_PATH);
@@ -178,6 +184,7 @@ function configFromEnv() {
   options.proxyBypass = envToString(process.env.PLAYWRIGHT_MCP_PROXY_BYPASS);
   options.proxyServer = envToString(process.env.PLAYWRIGHT_MCP_PROXY_SERVER);
   options.saveTrace = envToBoolean(process.env.PLAYWRIGHT_MCP_SAVE_TRACE);
+  options.secrets = dotenvFileLoader(process.env.PLAYWRIGHT_MCP_SECRETS_FILE);
   options.storageState = envToString(process.env.PLAYWRIGHT_MCP_STORAGE_STATE);
   options.userAgent = envToString(process.env.PLAYWRIGHT_MCP_USER_AGENT);
   options.userDataDir = envToString(process.env.PLAYWRIGHT_MCP_USER_DATA_DIR);
@@ -246,6 +253,19 @@ function commaSeparatedList(value) {
     return void 0;
   return value.split(",").map((v) => v.trim());
 }
+function dotenvFileLoader(value) {
+  if (!value)
+    return void 0;
+  return import_utilsBundle.dotenv.parse(import_fs.default.readFileSync(value, "utf8"));
+}
+function headerParser(arg, previous) {
+  if (!arg)
+    return previous || {};
+  const result = previous || {};
+  const [name, value] = arg.split(":").map((v) => v.trim());
+  result[name] = value;
+  return result;
+}
 function envToNumber(value) {
   if (!value)
     return void 0;
@@ -272,6 +292,8 @@ function sanitizeForFilePath(s) {
 0 && (module.exports = {
   commaSeparatedList,
   configFromCLIOptions,
+  dotenvFileLoader,
+  headerParser,
   outputFile,
   resolveCLIConfig,
   resolveConfig,

package/lib/mcp/browser/context.js

@@ -1,7 +1,9 @@
 "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)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   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 context_exports = {};
 __export(context_exports, {
@@ -26,6 +36,7 @@ var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_log = require("../log");
 var import_tab = require("./tab");
 var import_config = require("./config");
+var codegen = __toESM(require("./codegen"));
 const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
 class Context {
   constructor(options) {
@@ -174,6 +185,14 @@ class Context {
     }
     return result;
   }
+  lookupSecret(secretName) {
+    if (!this.config.secrets?.[secretName])
+      return { value: secretName, code: codegen.quote(secretName) };
+    return {
+      value: this.config.secrets[secretName],
+      code: `process.env['${secretName}']`
+    };
+  }
 }
 class InputRecorder {
   constructor(context, browserContext) {

package/lib/mcp/browser/processUtils.js

@@ -0,0 +1,87 @@
+"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_registry = require("playwright-core/lib/server/registry/index");
+function getBrowserExecPath(channelOrName) {
+  return import_registry.registry.findExecutable(channelOrName)?.executablePath("javascript");
+}
+function findBrowserProcess(execPath, arg) {
+  switch (process.platform) {
+    case "darwin":
+      return findProcessMacos(execPath, arg);
+    case "linux":
+      return findProcessLinux(execPath, arg);
+    case "win32":
+      return findProcessWindows(execPath, arg);
+    default:
+      return null;
+  }
+}
+function findProcessLinux(execPath, arg) {
+  const psResult = import_child_process.default.spawnSync("ps", ["-eo", "pid=,args="]);
+  return findMatchingLine(psResult.stdout.toString(), execPath, arg);
+}
+function findProcessMacos(execPath, arg) {
+  const psResult = import_child_process.default.spawnSync("ps", ["-axo", "pid=,command="]);
+  return findMatchingLine(psResult.stdout.toString(), execPath, arg);
+}
+function findProcessWindows(execPath, arg) {
+  const filter = `$_.ExecutablePath -eq '${execPath}' -and $_.CommandLine.Contains('${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)
+    return null;
+  return findMatchingLine(ps.stdout.toString(), execPath, arg);
+}
+function findMatchingLine(psOutput, execPath, arg) {
+  const lines = psOutput.split("\n").map((l) => l.trim()).filter(Boolean);
+  for (const line of lines) {
+    if (line.includes(execPath) && line.includes(arg) && !line.includes("--type"))
+      return line;
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  findBrowserProcess,
+  getBrowserExecPath
+});

package/lib/mcp/browser/response.js

@@ -103,8 +103,19 @@ ${this._code.join("\n")}
       for (const image of this._images)
         content.push({ type: "image", data: image.data.toString("base64"), mimeType: image.contentType });
     }
+    this._redactSecrets(content);
     return { content, isError: this._isError };
   }
+  _redactSecrets(content) {
+    if (!this._context.config.secrets)
+      return;
+    for (const item of content) {
+      if (item.type !== "text")
+        continue;
+      for (const [secretName, secretValue] of Object.entries(this._context.config.secrets))
+        item.text = item.text.replaceAll(secretValue, `<secret>${secretName}</secret>`);
+    }
+  }
 }
 function renderTabSnapshot(tabSnapshot) {
   const lines = [];

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

@@ -34,7 +34,7 @@ module.exports = __toCommonJS(form_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var import_utils = require("./utils");
-var javascript = __toESM(require("../codegen"));
+var codegen = __toESM(require("../codegen"));
 const fillForm = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
@@ -56,14 +56,15 @@ const fillForm = (0, import_tool.defineTabTool)({
       const locator = await tab.refLocator({ element: field.name, ref: field.ref });
       const locatorSource = `await page.${await (0, import_utils.generateLocator)(locator)}`;
       if (field.type === "textbox" || field.type === "slider") {
-        await locator.fill(field.value);
-        response.addCode(`${locatorSource}.fill(${javascript.quote(field.value)});`);
+        const secret = tab.context.lookupSecret(field.value);
+        await locator.fill(secret.value);
+        response.addCode(`${locatorSource}.fill(${secret.code});`);
       } else if (field.type === "checkbox" || field.type === "radio") {
         await locator.setChecked(field.value === "true");
-        response.addCode(`${locatorSource}.setChecked(${javascript.quote(field.value)});`);
+        response.addCode(`${locatorSource}.setChecked(${field.value});`);
       } else if (field.type === "combobox") {
         await locator.selectOption({ label: field.value });
-        response.addCode(`${locatorSource}.selectOption(${javascript.quote(field.value)});`);
+        response.addCode(`${locatorSource}.selectOption(${codegen.quote(field.value)});`);
       }
     }
   }

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

@@ -1,9 +1,7 @@
 "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)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   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 keyboard_exports = {};
 __export(keyboard_exports, {
@@ -35,7 +25,6 @@ var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var import_snapshot = require("./snapshot");
 var import_utils = require("./utils");
-var javascript = __toESM(require("../codegen"));
 const pressKey = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
@@ -72,14 +61,15 @@ const type = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     const locator = await tab.refLocator(params);
+    const secret = tab.context.lookupSecret(params.text);
     await tab.waitForCompletion(async () => {
       if (params.slowly) {
         response.setIncludeSnapshot();
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.pressSequentially(${javascript.quote(params.text)});`);
-        await locator.pressSequentially(params.text);
+        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.pressSequentially(${secret.code});`);
+        await locator.pressSequentially(secret.value);
       } else {
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.fill(${javascript.quote(params.text)});`);
-        await locator.fill(params.text);
+        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.fill(${secret.code});`);
+        await locator.fill(secret.value);
       }
       if (params.submit) {
         response.setIncludeSnapshot();

package/lib/mcp/program.js

@@ -30,7 +30,7 @@ var import_proxyBackend = require("./sdk/proxyBackend");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
 const packageJSON = require("../../package.json");
-import_utilsBundle.program.version("Version " + packageJSON.version).name("Playwright MCP").option("--allowed-origins <origins>", "semicolon-separated list of origins to allow the browser to request. Default is to allow all.", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--config <path>", "path to the configuration file.").option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".').option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280, 720"').addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+import_utilsBundle.program.version("Version " + packageJSON.version).name("Playwright MCP").option("--allowed-origins <origins>", "semicolon-separated list of origins to allow the browser to request. Default is to allow all.", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".').option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280, 720"').addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
   setupExitWatchdog();
   if (options.vision) {
     console.error("The --vision option is deprecated, use --caps=vision instead");