browser_wait_for
Wait for specific text to appear or disappear on a web page or pause execution for a set duration, enabling precise control in automated interactions with web content.
Instructions
Wait for text to appear or disappear or a specified time to pass
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | The text to wait for | |
| textGone | No | The text to wait for to disappear | |
| time | No | The time to wait in seconds |
Implementation Reference
- src/tools/wait.ts:35-62 (handler)The handler function that executes the browser_wait_for tool logic. It waits for a specified time, for text to become visible, or for text to disappear using Playwright locators on the current tab.handle: async (context, params, response) => { if (!params.text && !params.textGone && !params.time) throw new Error('Either time, text or textGone must be provided'); const code: string[] = []; if (params.time) { code.push(`await new Promise(f => setTimeout(f, ${params.time!} * 1000));`); await new Promise(f => setTimeout(f, Math.min(30000, params.time! * 1000))); } const tab = context.currentTabOrDie(); const locator = params.text ? tab.page.getByText(params.text).first() : undefined; const goneLocator = params.textGone ? tab.page.getByText(params.textGone).first() : undefined; if (goneLocator) { code.push(`await page.getByText(${JSON.stringify(params.textGone)}).first().waitFor({ state: 'hidden' });`); await goneLocator.waitFor({ state: 'hidden' }); } if (locator) { code.push(`await page.getByText(${JSON.stringify(params.text)}).first().waitFor({ state: 'visible' });`); await locator.waitFor({ state: 'visible' }); } response.addResult(`Waited for ${params.text || params.textGone || params.time}`); response.setIncludeSnapshot(); },
- src/tools/wait.ts:23-33 (schema)The schema definition for the browser_wait_for tool, including name, title, description, input schema using Zod, and type.schema: { name: 'browser_wait_for', title: 'Wait for', description: 'Wait for text to appear or disappear or a specified time to pass', inputSchema: z.object({ time: z.number().optional().describe('The time to wait in seconds'), text: z.string().optional().describe('The text to wait for'), textGone: z.string().optional().describe('The text to wait for to disappear'), }), type: 'readOnly', },
- src/tools.ts:17-52 (registration)Registers the browser_wait_for tool by importing the wait module and including its tools in the allTools array, which is used to provide tools to the MCP server.import common from './tools/common.js'; import console from './tools/console.js'; import dialogs from './tools/dialogs.js'; import evaluate from './tools/evaluate.js'; import files from './tools/files.js'; import install from './tools/install.js'; import keyboard from './tools/keyboard.js'; import navigate from './tools/navigate.js'; import network from './tools/network.js'; import pdf from './tools/pdf.js'; import snapshot from './tools/snapshot.js'; import tabs from './tools/tabs.js'; import screenshot from './tools/screenshot.js'; import wait from './tools/wait.js'; import mouse from './tools/mouse.js'; import type { Tool } from './tools/tool.js'; import type { FullConfig } from './config.js'; export const allTools: Tool<any>[] = [ ...common, ...console, ...dialogs, ...evaluate, ...files, ...install, ...keyboard, ...navigate, ...network, ...mouse, ...pdf, ...screenshot, ...snapshot, ...tabs, ...wait, ];
- src/tools/wait.ts:65-67 (registration)Exports the defined wait tool (containing browser_wait_for) for aggregation in src/tools.ts.export default [ wait, ];