chrome-devtools-kotlin / org.hildan.chrome.devtools.protocol / ChromeDPClient / <init>

<init>

ChromeDPClient(remoteDebugUrl: String = "http://localhost:9222", overrideHostHeader: Boolean = false, webSocketClient: WebSocketClient = DEFAULT_WEBSOCKET_CLIENT, httpClient: HttpClient = if (overrideHostHeader) DEFAULT_HTTP_CLIENT_WITH_HOST_OVERRIDE else DEFAULT_HTTP_CLIENT)

A Chrome Devtools Protocol client.

It provides access to the basic HTTP endpoints exposed by the Chrome browser, as well as web socket connections to the browser and its targets to make use of the full Chrome Devtools Protocol API.

Note: if you already know the browser target's web socket URL, you don't need to create a ChromeDPClient. Instead, use a WebSocketClient and WebSocketClient.connectToChrome instead. A default web socket client can be created using defaultWebSocketClient.

Host override

Chrome doesn't accept a Host header that is not an IP nor localhost, but in some environments it might be hard to provide this (e.g. docker services in a docker swarm, communicating using service names).

To work around this problem, simply set overrideHostHeader to true. This overrides the Host header to "localhost" in the HTTP requests to the Chrome debugger to make it happy, and also replaces the host in subsequent web socket URLs (returned by Chrome) by the initial host provided in remoteDebugUrl. This is necessary because Chrome uses the Host header to build these URLs, and it would be incorrect to keep this.