browser_wait_for
Wait for specific text to appear or disappear on a web page, or pause execution for a set time during browser automation.
Instructions
Wait for text to appear or disappear or a specified time to pass
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | No | The time to wait in seconds | |
| text | No | The text to wait for | |
| textGone | No | The text to wait for to disappear |
Implementation Reference
- src/tools/wait.ts:35-65 (handler)The handler function that implements the logic for the 'browser_wait_for' tool. It handles waiting for a specified time, text to appear (visible), or text to disappear (hidden) using Playwright locators on the current tab.handle: async (context, params) => { 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(10000, 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' }); } return { code, captureSnapshot, waitForNetwork: false, }; },
- src/tools/wait.ts:23-33 (schema)The schema definition for the 'browser_wait_for' tool, specifying 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/wait.ts:68-70 (registration)Registration of the wait tool factory, which includes the 'browser_wait_for' tool, exported for inclusion in main tools arrays.export default (captureSnapshot: boolean) => [ wait(captureSnapshot), ];
- src/tools.ts:35-50 (registration)Top-level registration where the wait tool (including browser_wait_for) is included in the snapshotTools array with captureSnapshot=true.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:52-66 (registration)Top-level registration where the wait tool (including browser_wait_for) is included in the visionTools array with captureSnapshot=false.export const visionTools: Tool<any>[] = [ ...common(false), ...console, ...dialogs(false), ...files(false), ...install, ...keyboard(false), ...navigate(false), ...network, ...pdf, ...tabs(false), ...testing, ...vision, ...wait(false), ];