browser_navigate
Navigate the active browser tab to a new URL with configurable wait strategies for SPAs and static pages, and optionally capture changes via delta computation.
Instructions
Navigate the active browser tab to a new URL. By default, waits for the page load event before returning. For SPAs (React, Vue, etc.), use waitUntil="networkidle0" to wait for all async requests to complete. After navigation, call get_semantic_surface to perceive the new page content.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The full URL to navigate to (must include protocol, e.g., https://) | |
| waitUntil | No | Navigation wait strategy. "load" (default) waits for the window load event. "networkidle0" waits until there are no network connections for 500ms — ideal for SPAs that fetch data after mount. "networkidle2" allows up to 2 open connections (for long-polling/WebSocket apps). "domcontentloaded" returns as soon as the DOM is parsed (fastest, but page may still be loading). | |
| returnDelta | No | If true, immediately computes and returns a unified delta of what changed (DOM changes, network traffic, console logs) directly in the feedback. | |
| settleTimeMs | No | Delay in ms after navigation completes before capturing the delta and screenshots (default: 250ms). |