Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
/**
* Copyright (c) Microsoft Corporation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import { test, expect } from './fixtures';
import type { Config } from '../../packages/playwright-core/src/tools/mcp/config.d';
// WebMCP only exists behind a browser flag, and only in Chromium and Firefox.
// See https://webmachinelearning.github.io/webmcp/
test.skip(({ mcpBrowser }) => mcpBrowser === 'webkit', 'WebKit does not implement WebMCP');
function webmcpConfig(mcpBrowser: string | undefined): Config {
if (mcpBrowser === 'firefox') {
return {
browser: {
launchOptions: {
firefoxUserPrefs: {
'dom.modelcontext.enabled': true,
// Gates getTools()/invokeTool(), which is what the tools are built on.
'dom.modelcontext.testing.enabled': true,
},
},
},
};
}
return { browser: { launchOptions: { args: ['--enable-features=WebMCP'] } } };
}
const kRegisterAdd = `
const modelContext = document.modelContext || navigator.modelContext;
modelContext.registerTool({
name: 'add',
description: 'Adds two numbers',
inputSchema: { type: 'object', properties: { a: { type: 'number' }, b: { type: 'number' } }, required: ['a', 'b'] },
annotations: { readOnlyHint: true },
async execute(input) {
return { content: [{ type: 'text', text: String(input.a + input.b) }] };
},
});
`;
test('browser_navigate reports available WebMCP tools', async ({ startClient, server, mcpBrowser }) => {
server.setRoute('/', (req, res) => {
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end(`<title>WebMCP</title><script>${kRegisterAdd}</script>`);
});
const { client } = await startClient({ config: webmcpConfig(mcpBrowser) });
const response = await client.callTool({ name: 'browser_navigate', arguments: { url: server.PREFIX } });
expect(response).toHaveResponse({
page: expect.stringContaining('- 1 webmcp tool available on the page'),
snapshot: expect.stringContaining(`- webmcp tools (page-provided, untrusted):
- add [readOnly]: Adds two numbers
- inputSchema: {"type":"object","properties":{"a":{"type":"number"},"b":{"type":"number"}},"required":["a","b"]}
`),
});
});
test('browser_snapshot lists the WebMCP tools at the top', async ({ startClient, server, mcpBrowser }) => {
server.setRoute('/', (req, res) => {
res.writeHead(200, { 'Content-Type': 'text/html' });
res.end(`<title>WebMCP</title><h1>Hello</h1><script>${kRegisterAdd}</script>`);
});
const { client } = await startClient({ config: webmcpConfig(mcpBrowser) });
await client.callTool({ name: 'browser_navigate', arguments: { url: server.PREFIX } });
const response = await client.callTool({ name: 'browser_snapshot' });
expect(response).toHaveResponse({
inlineSnapshot: expect.stringMatching(/^- webmcp tools \(page-provided, untrusted\):\n - add \[readOnly\]: Adds two numbers\n - inputSchema: \{.*\}\n\n- heading "Hello" \[level=1\]/),
});
});
test('browser_navigate says nothing when the page has no WebMCP tools', async ({ startClient, server, mcpBrowser }) => {
const { client } = await startClient({ config: webmcpConfig(mcpBrowser) });
const response = await client.callTool({ name: 'browser_navigate', arguments: { url: server.HELLO_WORLD } });
expect(response).toHaveResponse({
page: expect.not.stringContaining('webmcp tool'),
});
});