{"id":13804417,"url":"https://github.com/kklisura/chrome-devtools-java-client","last_synced_at":"2025-10-07T08:24:52.579Z","repository":{"id":50492032,"uuid":"120487379","full_name":"kklisura/chrome-devtools-java-client","owner":"kklisura","description":"Chrome DevTools java client.","archived":false,"fork":false,"pushed_at":"2024-07-25T14:53:44.000Z","size":1417,"stargazers_count":232,"open_issues_count":51,"forks_count":80,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-07-28T15:34:41.246Z","etag":null,"topics":["chrome-devtools","chrome-headless","devtools-protocol","java","java-client"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kklisura.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-06T16:23:48.000Z","updated_at":"2025-07-18T02:47:23.000Z","dependencies_parsed_at":"2024-01-07T09:39:44.330Z","dependency_job_id":"b80c9045-9771-4333-b769-2d7bd7cdec3c","html_url":"https://github.com/kklisura/chrome-devtools-java-client","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/kklisura/chrome-devtools-java-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kklisura%2Fchrome-devtools-java-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kklisura%2Fchrome-devtools-java-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kklisura%2Fchrome-devtools-java-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kklisura%2Fchrome-devtools-java-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kklisura","download_url":"https://codeload.github.com/kklisura/chrome-devtools-java-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kklisura%2Fchrome-devtools-java-client/sbom","scorecard":{"id":562741,"data":{"date":"2025-08-11","repo":{"name":"github.com/kklisura/chrome-devtools-java-client","commit":"54c2dcc9b75da2d2fd04de89b97322c251fe8c1e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Code-Review","score":2,"reason":"Found 5/18 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 18 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"10 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-vmq6-5m68-f53m","Warn: Project is vulnerable to: GHSA-668q-qrv7-99fm","Warn: Project is vulnerable to: GHSA-6v67-2wr5-gvf4","Warn: Project is vulnerable to: GHSA-pr98-23f8-jwxv","Warn: Project is vulnerable to: GHSA-h46c-h94j-95f3","Warn: Project is vulnerable to: GHSA-wf8f-6423-gfxg","Warn: Project is vulnerable to: GHSA-3x8x-79m2-3w2w","Warn: Project is vulnerable to: GHSA-57j2-w4cx-62h2","Warn: Project is vulnerable to: GHSA-jjjh-jjxp-wpff","Warn: Project is vulnerable to: GHSA-rgv9-q543-rqg4"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-20T14:09:14.482Z","repository_id":50492032,"created_at":"2025-08-20T14:09:14.482Z","updated_at":"2025-08-20T14:09:14.482Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278742116,"owners_count":26037754,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome-devtools","chrome-headless","devtools-protocol","java","java-client"],"created_at":"2024-08-04T01:00:47.458Z","updated_at":"2025-10-07T08:24:52.530Z","avatar_url":"https://github.com/kklisura.png","language":"Java","readme":"# Chrome DevTools Java Client\n\n## Description\n\nChrome 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]\n\nFor more information on DevTools, see https://chromedevtools.github.io/devtools-protocol/.\n\n[v1.3.6](https://github.com/kklisura/chrome-devtools-java-client/tree/v1.3.6) tested on Google Chrome Version 67.0.3396.87. Protocol files from [dev-tools-protocol#1aa7b31ca7](https://github.com/ChromeDevTools/devtools-protocol/tree/1aa7b31ca7bba982eceea8d4bd494b27850fb0df/json)\n\n[v2.1.0](https://github.com/kklisura/chrome-devtools-java-client/tree/v2.1.0) tested on Google Chrome Version 76.0.3809.100. Protocol files from [dev-tools-protocol#e1fb93bd76](https://github.com/ChromeDevTools/devtools-protocol/tree/e1fb93bd76f99cdf401b949757c874c579e15434/json)\n\n[v3.0.0](https://github.com/kklisura/chrome-devtools-java-client/tree/v3.0.0) tested on Google Chrome Version 86.0.4240.111. Protocol files from [dev-tools-protocol#fcb68d10bc](https://github.com/ChromeDevTools/devtools-protocol/tree/fcb68d10bc5258ebf96121caf57200069f6e6731/json)\n\n[v4.0.0](https://github.com/kklisura/chrome-devtools-java-client/tree/v4.0.0) tested on Google Chrome Version 90.0.4430.212. Protocol files from [dev-tools-protocol#987bbb1124](https://github.com/ChromeDevTools/devtools-protocol/tree/987bbb1124f098c7e4bca6b2f91c7e96b350a8e6/json)\n\n[1] https://chromedevtools.github.io/devtools-protocol/.\n\n## Usage\n\nAdd the following dependency to your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.kklisura.cdt\u003c/groupId\u003e\n  \u003cartifactId\u003ecdt-java-client\u003c/artifactId\u003e\n  \u003cversion\u003e4.0.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nYou can use following code, taken from, `LogRequestsExample`:\n\n```java\npackage com.github.kklisura.cdt.examples;\n\nimport com.github.kklisura.cdt.launch.ChromeLauncher;\nimport com.github.kklisura.cdt.protocol.commands.Network;\nimport com.github.kklisura.cdt.protocol.commands.Page;\nimport com.github.kklisura.cdt.services.ChromeDevToolsService;\nimport com.github.kklisura.cdt.services.ChromeService;\nimport com.github.kklisura.cdt.services.types.ChromeTab;\n\n/**\n * Log requests example with DevTools java client.\n *\n * \u003cp\u003eThe following example will open chrome, create a tab with about:blank url, subscribe to\n * requestWillBeSent event and then navigate to github.com.\n *\n * @author Kenan Klisura\n */\npublic class LogRequestsExample {\n  public static void main(String[] args) {\n    // Create chrome launcher.\n    final ChromeLauncher launcher = new ChromeLauncher();\n\n    // Launch chrome either as headless (true) or regular (false).\n    final ChromeService chromeService = launcher.launch(false);\n\n    // Create empty tab ie about:blank.\n    final ChromeTab tab = chromeService.createTab();\n\n    // Get DevTools service to this tab\n    final ChromeDevToolsService devToolsService = chromeService.createDevToolsService(tab);\n\n    // Get individual commands\n    final Page page = devToolsService.getPage();\n    final Network network = devToolsService.getNetwork();\n\n    // Log requests with onRequestWillBeSent event handler.\n    network.onRequestWillBeSent(\n        event -\u003e\n            System.out.printf(\n                \"request: %s %s%s\",\n                event.getRequest().getMethod(),\n                event.getRequest().getUrl(),\n                System.lineSeparator()));\n\n    network.onLoadingFinished(\n        event -\u003e {\n          // Close the tab and close the browser when loading finishes.\n          chromeService.closeTab(tab);\n          launcher.close();\n        });\n\n    // Enable network events.\n    network.enable();\n\n    // Navigate to github.com.\n    page.navigate(\"http://github.com\");\n\n    devToolsService.waitUntilClosed();\n  }\n}\n```\n\nFor more examples, see [examples](cdt-examples/src/main/java/com/github/kklisura/cdt/examples).\n\n## Known-issues\n\n### API hangs (ie when printing PDFs)\n\n**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.\n\n**Why:** This is due to underlying WebSocket library having 4MB buffer for receiving data from browser.\n\n**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](cdt-examples/src/main/java/com/github/kklisura/cdt/examples/IncreasedIncomingBufferInTyrusExample.java).\n\n## Debugging chrome\n\nIn order to debug chrome when using this library, set the logger `com.github.kklisura.cdt.launch.chrome.output` to `DEBUG` level. See [ChromeLoggingExample](cdt-examples/src/main/java/com/github/kklisura/cdt/examples/ChromeLoggingExample.java) for more information. Be sure to remove or turn the logger off, when done.\n\n## Running unit tests\n\n`make verify`\n\n## Sonar analysis\n\n`make sonar-analysis`\n\n## Download latest protocol\n\nRun following:\n```\nmake download-latest-protocol\n```\n\nThis will download `browser_protocol.json` and `js_protocol.json` (protocol definitions) from https://github.com/ChromeDevTools/devtools-protocol repo.\n\n## Update protocol (generate Java files from protocol definitions)\n\nMake sure you have correct or latest protocol definitions. See [Download latest protocol](#download-latest-protocol) on how to update protocol definitions to latest version.\n\nRun following:\n```\nmake update-protocol\n```\n\nThis will build the tools for parsing and generating Java files, [cdt-java-protocol-builder](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](cdt-java-client/) project. After building Java files, the [cdt-java-client](cdt-java-client/) will be compiled. If everything goes successfully, consider the protocol updated. :)\n\n## Updating copyright license header\n\nTo go over each module and each source java file to update copyright license header, run:\n\n```\nmake update-copyright-license-header\n```\n\n## License\n\nChrome DevTools Java Client is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE.txt) for the full license text.\n","funding_links":[],"categories":["Chrome DevTools Protocol"],"sub_categories":["Libraries for driving the protocol (or a layer above)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkklisura%2Fchrome-devtools-java-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkklisura%2Fchrome-devtools-java-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkklisura%2Fchrome-devtools-java-client/lists"}