/**
* 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';
test('browser_click', async ({ client, server }) => {
server.setContent('/', `
Title
Submit
`, 'text/html');
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: 'e2',
},
})).toHaveResponse({
code: `await page.getByRole('button', { name: 'Submit' }).click();`,
snapshot: expect.stringContaining(`button "Submit" [active] [ref=e2]`),
});
});
test('browser_click (double)', async ({ client, server }) => {
server.setContent('/', `
Title
Click me
`, 'text/html');
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Click me',
target: 'e2',
doubleClick: true,
},
})).toHaveResponse({
code: `await page.getByRole('heading', { name: 'Click me' }).dblclick();`,
snapshot: expect.stringContaining(`heading "Double clicked" [level=1] [ref=e3]`),
});
});
test('browser_click (right)', async ({ client, server }) => {
server.setContent('/', `
Menu
`, 'text/html');
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
const result = await client.callTool({
name: 'browser_click',
arguments: {
element: 'Menu',
target: 'e2',
button: 'right',
},
});
expect(result).toHaveResponse({
code: [
`await page.getByRole('button', { name: 'Menu' }).click({`,
` button: 'right'`,
`});`
].join('\n'),
snapshot: expect.stringContaining(`button "Right clicked"`),
});
});
test('browser_click (modifiers)', async ({ client, server, mcpBrowser }) => {
server.setContent('/', `
Title
Submit
`, 'text/html');
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
if (process.platform !== 'darwin') {
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: 'e2',
modifiers: ['Control'],
},
})).toHaveResponse({
code: [
`await page.getByRole('button', { name: 'Submit' }).click({`,
` modifiers: ['Control']`,
`});`
].join('\n'),
snapshot: expect.stringContaining(`generic [ref=e3]: ctrlKey:true metaKey:false shiftKey:false altKey:false`),
});
}
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: 'e2',
modifiers: ['Shift'],
},
})).toHaveResponse({
code: [
`await page.getByRole('button', { name: 'Submit' }).click({`,
` modifiers: ['Shift']`,
`});`
].join('\n'),
snapshot: expect.stringContaining(`generic [ref=e3]: ctrlKey:false metaKey:false shiftKey:true altKey:false`),
});
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: 'e2',
modifiers: ['Shift', 'Alt'],
},
})).toHaveResponse({
code: [
`await page.getByRole('button', { name: 'Submit' }).click({`,
` modifiers: ['Shift', 'Alt']`,
`});`
].join('\n'),
snapshot: expect.stringContaining(`generic [ref=e3]: ctrlKey:false metaKey:false shiftKey:true altKey:true`),
});
});
test('browser_click (test id attribute)', async ({ startClient, server, mcpBrowser }) => {
server.setContent('/', `
Title
Submit
`, 'text/html');
const { client } = await startClient({
args: [
'--test-id-attribute', 'data-tid',
],
});
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: 'e2',
},
})).toHaveResponse({
code: `await page.getByTestId('submit').click();`,
});
});
test('browser_click (locator target containing aria-ref-like substring)', async ({ client, server }) => {
server.setContent('/', `
Title
Submit
`, 'text/html');
await client.callTool({
name: 'browser_navigate',
arguments: { url: server.PREFIX },
});
expect(await client.callTool({
name: 'browser_click',
arguments: {
element: 'Submit button',
target: '#z2l9e43l3',
},
})).toHaveResponse({
code: `await page.locator('#z2l9e43l3').click();`,
});
});