Skip to main content
POST
Reload

Overview

The /browser/sessions/{id}/reload endpoint reloads the currently active tab. By default the reload reuses the HTTP cache; pass ignoreCache: true to force a full re-fetch of all resources. The call blocks until the configured wait condition is met or the timeout elapses.

Path Parameters

string
required
Browser session ID (UUID). Create via POST /browser/sessions.

Body

All body fields are optional — the request body may be omitted entirely.
boolean
default:"false"
When true, bypasses the HTTP cache (equivalent to Ctrl+Shift+R). Re-fetches all resources from origin.
string
default:"load"
When to consider the reload finished. One of load, domcontentloaded, networkidle.
integer
default:"30000"
Maximum time (ms) to wait for the reload to complete. Range 0120000.

Example Request

Response

Success Response (200)

string
Effective URL of the active tab after reload.
string
CDP target identifier of the tab the reload applied to.
Example Response:

Error Responses

Notes

  • ignoreCache: true is equivalent to Ctrl+Shift+R — re-fetches all resources bypassing the HTTP cache.
  • The URL of the active tab is preserved across reloads; only the document and its subresources are refetched.