For AI agents: a documentation index is available at /llms.txt
Skip to main content

ReconnectionResponse

The response received after attempting to reconnect a BrowserQL session

type ReconnectionResponse {
browserQLEndpoint: String
browserWSEndpoint: String
devtoolsFrontendUrl: String
webSocketDebuggerUrl: String
}

Fields​

ReconnectionResponse.browserQLEndpoint ● String scalar​

The fully-qualified URL to reconnect future BrowserQL sessions, eg: https://chrome.browserless.io/bql/$id. Please note that token information is not returned by this API and might be required

ReconnectionResponse.browserWSEndpoint ● String scalar​

The fully-qualified URL of the browserWSEndpoint which can be used with other libraries like playwright or puppeteer. Please note that token information is not returned by this API and might be required

ReconnectionResponse.devtoolsFrontendUrl ● String scalar​

The fully-qualified URL of the devtools resources for loading Chrome's developer tools remotely. On Browserless Cloud it carries a short-lived secret, not your API token. The secret opens the bound page's and browser's developer tools until the reconnect timeout ends. Another BrowserQL reconnect on the same browser reuses the secret and refreshes its expiry. Deployments started with a fixed TOKEN embed that token instead, so do not share it there.

ReconnectionResponse.webSocketDebuggerUrl ● String scalar​

The underlying page's webSocketDebuggerUrl, useful for hooking libraries that operate on a page and not a browser object. This URL omits your token: add it as a token query parameter when connecting

Returned By​

reconnect mutation

Was this page helpful?