/** * 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 `, '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('/', ` `, '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
`, '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 `, '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 `, '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();`, }); });