Skip to main content
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 0120000.
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.
Example Response:

Error Responses

Notes

  • waitUntil=load waits for document.readyState === "complete". domcontentloaded returns once the DOM parser finishes. networkidle waits for 500ms of no network activity (best-effort, capped at 10s).
  • referer is per-request and does not persist to subsequent navigations.