browser_hover
Simulate mouse hover actions on web page elements using Playwright MCP. Specify the target element to interact with, enabling precise browser automation without visual models.
Instructions
Hover over element on page
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| element | Yes | Human-readable element description used to obtain permission to interact with the element | |
| ref | Yes | Exact target element reference from the page snapshot |
Implementation Reference
- src/tools/snapshot.ts:121-137 (handler)The main handler function for the 'browser_hover' tool. It retrieves the page snapshot, creates a locator for the target element, generates code for hovering, and executes the hover action using Playwright.handle: async (context, params) => { const snapshot = context.currentTabOrDie().snapshotOrDie(); const locator = snapshot.refLocator(params); const code = [ `// Hover over ${params.element}`, `await page.${await generateLocator(locator)}.hover();` ]; return { code, action: () => locator.hover(), captureSnapshot: true, waitForNetwork: true, }; }, });
- src/tools/snapshot.ts:113-119 (schema)Schema definition for the 'browser_hover' tool, including name, title, description, input schema (elementSchema), and type.schema: { name: 'browser_hover', title: 'Hover mouse', description: 'Hover over element on page', inputSchema: elementSchema, type: 'readOnly', },
- src/tools.ts:35-50 (registration)Registration of the 'browser_hover' tool by including the 'snapshot' module (which exports it) in the 'snapshotTools' array via spread operator.export const snapshotTools: Tool<any>[] = [ ...common(true), ...console, ...dialogs(true), ...files(true), ...install, ...keyboard(true), ...navigate(true), ...network, ...pdf, ...screenshot, ...snapshot, ...tabs(true), ...testing, ...wait(true), ];
- src/tools.ts:26-26 (registration)Import of the snapshot module containing the 'browser_hover' tool definition.import snapshot from './tools/snapshot.js';
- src/tools/snapshot.ts:44-47 (schema)Shared 'elementSchema' used as inputSchema for 'browser_hover' and other interaction tools.const elementSchema = z.object({ element: z.string().describe('Human-readable element description used to obtain permission to interact with the element'), ref: z.string().describe('Exact target element reference from the page snapshot'), });