browserHover
Simulate mouse hover actions on specific web elements using Playwright, enabling precise interactions and snapshot captures for testing and automation workflows.
Instructions
悬停在页面元素上
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageId | Yes | 页面ID | |
| ref | Yes | 元素的xp引用值 | |
| waitForTimeout | No | 操作后等待获取快照的延迟时间（毫秒，默认2000） |
Implementation Reference
- lib/tools/snapshot.js:94-111 (handler)Full implementation of the browser_hover (browserHover) tool handler. It uses element ref to get locator and performs hover, generates code snippet for reproduction, and waits for completion.
const hover = defineTabTool({ capability: 'core', schema: { name: 'browser_hover', title: 'Hover mouse', description: 'Hover over element on page', inputSchema: elementSchema, type: 'readOnly', }, handle: async (tab, params, response) => { response.setIncludeSnapshot(); const locator = await tab.refLocator(params); response.addCode(`await page.${await generateLocator(locator)}.hover();`); await tab.waitForCompletion(async () => { await locator.hover(); }); }, }); - lib/tools/snapshot.js:34-37 (schema)Zod schema for element input, used by browser_hover tool's inputSchema.
export 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'), }); - lib/tools/snapshot.js:133-139 (registration)Exports the hover tool along with others for inclusion in the allTools list.
export default [ snapshot, click, drag, hover, selectOption, ]; - lib/tools.js:46-46 (registration)Includes snapshot tools (containing browser_hover) in the aggregated allTools export used by MCP backend.
...snapshot, - lib/tools/tool.js:19-33 (helper)defineTabTool wrapper used to define the browser_hover tool, adding tab context and modal state checks.
export function defineTabTool(tool) { return { ...tool, handle: async (context, params, response) => { const tab = context.currentTabOrDie(); const modalStates = tab.modalStates().map(state => state.type); if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState)) response.addError(`Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.\n` + tab.modalStatesMarkdown().join('\n')); else if (!tool.clearsModalState && modalStates.length) response.addError(`Error: Tool "${tool.schema.name}" does not handle the modal state.\n` + tab.modalStatesMarkdown().join('\n')); else return tool.handle(tab, params, response); }, }; }