DocsNavigationbrowser_navigate

browser_navigate

Browser Navigate

Navigate the browser to a specified URL. This is a non-blocking operation that starts navigation and returns immediately. Use browser_wait_for_network_idle or browser_wait_for_selector to wait for the page to fully load. Supports HTTP, HTTPS, file, and data URLs. When wait_until is set (load, networkidle, fullscroll, domcontentloaded) and the page declares WebMCP tools, the response includes a webmcp_tools array containing the full tool definitions (name, description, inputSchema). Use browser_webmcp_call_tool to execute any of these tools directly.

Usage Example

123456789101112

import asyncio

from owl_browser import OwlBrowser, RemoteConfig

# Async usage

async with OwlBrowser(config) as browser:

context = await browser.create_context()

context_id = context["context_id"]

await browser.navigate(

context_id=context_id,

url="https://example.com"

)

Parameters

Required

context_idstringrequired

The unique identifier of the browser context to navigate (e.g., 'ctx_000001')

urlstringrequired

The full URL to navigate to, including protocol (e.g., 'https://example.com'). Supports http://, https://, file://, and data: URLs

Optional

wait_untilenum

loaddomcontentloadednetworkidle+1 more

When to consider navigation complete: '' (return immediately, default), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)

timeoutstring

Maximum time to wait for navigation in milliseconds. Only used when wait_until is set. Default: 30000 (30 seconds)

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}