browser_hover
Hover over specified web elements using Playwright MCP to interact with page elements directly, enabling precise browser automation without visual models or screenshots.
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-136 (handler)The handler function for the browser_hover tool. It derives a locator from the page snapshot for the given element reference and performs a hover operation using Playwright, generating corresponding code and an action callback.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, specifying name, title, description, input schema (elementSchema), and type as readOnly.schema: { name: 'browser_hover', title: 'Hover mouse', description: 'Hover over element on page', inputSchema: elementSchema, type: 'readOnly', },
- src/tools/snapshot.ts:44-47 (schema)Shared elementSchema used as inputSchema for browser_hover and other interaction tools, defining element description and reference.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'), });
- src/tools/snapshot.ts:111-137 (registration)The browser_hover tool is defined and registered using defineTool, which creates a Tool object exported for inclusion in the tools registry.const hover = defineTool({ capability: 'core', schema: { name: 'browser_hover', title: 'Hover mouse', description: 'Hover over element on page', inputSchema: elementSchema, type: 'readOnly', }, 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.ts:47-47 (registration)The snapshot tools module, which exports browser_hover among others, is spread into the snapshotTools array for top-level tool registration....snapshot,