Chrome DevTools Java Client is a DevTools client - in Java. (: It can be used for instrumenting, inspecting, debuging and profiling Chromium, Chrome and other Blink-based browsers. [1]
For more information on DevTools, see https://chromedevtools.github.io/devtools-protocol/.
v1.3.6 tested on Google Chrome Version 67.0.3396.87. Protocol files from dev-tools-protocol#1aa7b31ca7
v2.1.0 tested on Google Chrome Version 76.0.3809.100. Protocol files from dev-tools-protocol#e1fb93bd76
v3.0.0 tested on Google Chrome Version 86.0.4240.111. Protocol files from dev-tools-protocol#fcb68d10bc
v4.0.0 tested on Google Chrome Version 90.0.4430.212. Protocol files from dev-tools-protocol#987bbb1124
[1] https://chromedevtools.github.io/devtools-protocol/.
Add the following dependency to your pom.xml
:
<dependency>
<groupId>com.github.kklisura.cdt</groupId>
<artifactId>cdt-java-client</artifactId>
<version>4.0.0</version>
</dependency>
You can use following code, taken from, LogRequestsExample
:
package com.github.kklisura.cdt.examples;
import com.github.kklisura.cdt.launch.ChromeLauncher;
import com.github.kklisura.cdt.protocol.commands.Network;
import com.github.kklisura.cdt.protocol.commands.Page;
import com.github.kklisura.cdt.services.ChromeDevToolsService;
import com.github.kklisura.cdt.services.ChromeService;
import com.github.kklisura.cdt.services.types.ChromeTab;
/**
* Log requests example with DevTools java client.
*
* <p>The following example will open chrome, create a tab with about:blank url, subscribe to
* requestWillBeSent event and then navigate to github.com.
*
* @author Kenan Klisura
*/
public class LogRequestsExample {
public static void main(String[] args) {
// Create chrome launcher.
final ChromeLauncher launcher = new ChromeLauncher();
// Launch chrome either as headless (true) or regular (false).
final ChromeService chromeService = launcher.launch(false);
// Create empty tab ie about:blank.
final ChromeTab tab = chromeService.createTab();
// Get DevTools service to this tab
final ChromeDevToolsService devToolsService = chromeService.createDevToolsService(tab);
// Get individual commands
final Page page = devToolsService.getPage();
final Network network = devToolsService.getNetwork();
// Log requests with onRequestWillBeSent event handler.
network.onRequestWillBeSent(
event ->
System.out.printf(
"request: %s %s%s",
event.getRequest().getMethod(),
event.getRequest().getUrl(),
System.lineSeparator()));
network.onLoadingFinished(
event -> {
// Close the tab and close the browser when loading finishes.
chromeService.closeTab(tab);
launcher.close();
});
// Enable network events.
network.enable();
// Navigate to github.com.
page.navigate("https://github.com");
devToolsService.waitUntilClosed();
}
}
For more examples, see examples.
What: If you're using cdt-java-client
before version 2.1.0
for printing to PDF or using API which requests large amount of data, API may hang if the requesting data exceeds 4MB.
Why: This is due to underlying WebSocket library having 4MB buffer for receiving data from browser.
How to fix: With the version 2.1.0
and above, this buffer was increased to 8MB and can be further increased if necessary by setting the appropriate configuration property.
In order to debug chrome when using this library, set the logger com.github.kklisura.cdt.launch.chrome.output
to DEBUG
level. See ChromeLoggingExample for more information. Be sure to remove or turn the logger off, when done.
make verify
make sonar-analysis
Run following:
make download-latest-protocol
This will download browser_protocol.json
and js_protocol.json
(protocol definitions) from https://github.com/ChromeDevTools/devtools-protocol repo.
Make sure you have correct or latest protocol definitions. See Download latest protocol on how to update protocol definitions to latest version.
Run following:
make update-protocol
This will build the tools for parsing and generating Java files, cdt-java-protocol-builder project. The input for this tool are protocol definitions files: browser_protocol.json
and js_protocol.json
. The generated Java files will be present in cdt-java-client project. After building Java files, the cdt-java-client will be compiled. If everything goes successfully, consider the protocol updated. :)
To go over each module and each source java file to update copyright license header, run:
make update-copyright-license-header
Chrome DevTools Java Client is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.