Navigate
Browser Sessions
Navigate
Navigate the active tab to a URL with configurable wait strategy and timeout.
POST
Navigate
Overview
The/browser/sessions/{id}/navigate endpoint navigates the currently active tab of a browser session to the given URL and blocks until the configured wait condition is met or the timeout elapses.
Only http and https URLs are accepted. The navigation is scoped to the active tab — use POST /pages/{pageId}/activate to switch active tabs first.
Path Parameters
string
required
Browser session ID (UUID). Create via
POST /browser/sessions.Body
string
required
Absolute URL to navigate to. Must use the
http or https scheme.string
default:"load"
When to consider the navigation finished. One of
load, domcontentloaded, networkidle.integer
default:"30000"
Maximum time (ms) to wait for navigation. Range
0–120000.string
Optional
Referer header sent with this navigation request only. Does not persist to subsequent navigations.Example Request
Response
Success Response (200)
string
Effective URL of the active tab after all redirects.
string
CDP target identifier of the tab the navigation applied to.
Error Responses
Notes
waitUntil=loadwaits fordocument.readyState === "complete".domcontentloadedreturns once the DOM parser finishes.networkidlewaits for 500ms of no network activity (best-effort, capped at 10s).refereris per-request and does not persist to subsequent navigations.