navigate
Move the shared browser to a URL. Requests permission for cross-site and local URLs, reports HTTP status and content type, and can save downloads with confirmation.
Instructions
Navigate the shared window to a URL.
Going to a different site asks for permission to be on that site.
Moving within the current one does not. A URL with no host — file:,
data:, javascript: — is never "the same site" and is always
asked, every time, because one approval there would cover every local
file or every document the agent can author.
ok means the navigation happened, not that the page is good: read
http_status (404, 500 ...) and content_type (application/pdf
...) of the page that answered. Both are null when no HTTP response was
involved (about:blank, data:). wait_until is how much of the
load to wait for: domcontentloaded (default), load, commit or
networkidle — which never settles on a page that keeps polling. A page
that draws itself after it has loaded needs wait_for. A URL that turns
out to be a file download does not move the tab: with download=true —
which asks for permission to write a file — it is saved and the reply
carries download (filename, path, bytes, url_origin);
without it the download is cancelled and answered download_blocked, so
repeat the call with download=true. The permission pays for one file and
ends with the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| reason | No | ||
| confirm | No | ||
| download | No | ||
| wait_until | No | domcontentloaded |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||