Debugging Your App with DevTools

You can use Chrome DevTools to debug web content embedded in your Java application via Equo Chromium.

This feature is intended for development purposes only. Do not enable it in production environments.

Step 1: Enable Debugging

Tell Chromium to expose a debug interface by setting this system property:

-Dchromium.debug_port=8888

Add this to your Java launch options or run configuration.

Step 2: Open Chrome’s Inspect Page

  • Open Google Chrome

  • Visit: chrome://inspect

Step 3: Add Your Application

  • Inside the inspect page:

  • Click "Add connection…​"

  • Enter: localhost:8888

  • Confirm

Step 4: Refresh and Find Your Target

  • Go back to chrome://inspect

  • Click "Configure…​" if needed

  • Wait a few seconds — your embedded browser should appear under Remote Target

  • Click "Inspect" to open DevTools for your Java app’s browser

Get DevTools URL in Code

You can also programmatically get the DevTools URL from Java:

String devtoolsUrl = browser.getDevtoolsUrl();
System.out.println("Debug at: " + devtoolsUrl);

Paste the URL in Chrome to open DevTools directly.