Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

chore(mcp): respect browser.launchOptions.headless options from config (#39112)

Yury Semikhatskyc1385dc133b5
diff --git a/packages/playwright/src/mcp/browser/config.ts b/packages/playwright/src/mcp/browser/config.ts
index 342be44d48..3525856d7a 100644
--- a/packages/playwright/src/mcp/browser/config.ts
+++ b/packages/playwright/src/mcp/browser/config.ts
@@ -145,6 +145,9 @@ export async function resolveCLIConfig(cliOptions: CLIOptions): Promise<FullConf
const configInFile = await loadConfig(configFile);
let result = defaultConfig;
+ // Daemon session is always headless by default.
+ if (cliOptions.daemonSession)
+ result.browser.launchOptions.headless = true;
result = mergeConfig(result, configInFile);
result = mergeConfig(result, daemonOverrides);
result = mergeConfig(result, envOverrides);
@@ -368,7 +371,7 @@ async function configForDaemonSession(cliOptions: CLIOptions): Promise<Config &
config: sessionConfig.cli.config,
browser: sessionConfig.cli.browser,
isolated: sessionConfig.cli.isolated,
- headless: !sessionConfig.cli.headed,
+ headless: sessionConfig.cli.headed ? false : undefined,
extension: sessionConfig.cli.extension,
outputMode: 'file',
snapshotMode: 'full',
diff --git a/tests/mcp/cli-config.spec.ts b/tests/mcp/cli-config.spec.ts
index 75dc8a70de..cfeac33b31 100644
--- a/tests/mcp/cli-config.spec.ts
+++ b/tests/mcp/cli-config.spec.ts
@@ -42,6 +42,23 @@ test('context options', async ({ cli, server }, testInfo) => {
expect(output).toContain('800x600');
});
+test('headless options from config is respected', async ({ cli, server, mcpBrowser }, testInfo) => {
+ test.skip(mcpBrowser !== 'chrome', 'HeadlessChrome detection only works in Chromium');
+ const config = {
+ browser: {
+ launchOptions: {
+ headless: false,
+ },
+ },
+ };
+ await fs.promises.writeFile(testInfo.outputPath('playwright-cli.json'), JSON.stringify(config, null, 2));
+ const options = { env: { PLAYWRIGHT_MCP_HEADLESS: undefined } };
+ await cli('open', server.PREFIX, options);
+ const { output } = await cli('eval', 'navigator.userAgent', options);
+ expect(output).not.toContain('HeadlessChrome');
+ expect(output).toContain(' Chrome/');
+});
+
test('isolated', async ({ cli, server }, testInfo) => {
const config = {
browser: {
diff --git a/tests/mcp/files.spec.ts b/tests/mcp/files.spec.ts
index a41294ff62..c922151cb0 100644
--- a/tests/mcp/files.spec.ts
+++ b/tests/mcp/files.spec.ts
@@ -133,7 +133,7 @@ test('clicking on download link emits download', async ({ startClient, server },
if (p.events)
events += '\n' + p.events;
return events;
- }).toBe(`- Downloading file test.txt ...
+ }).toContain(`- Downloading file test.txt ...
- Downloaded file test.txt to "output${path.sep}test.txt"`);
});