Location Listener

In certain applications, it may be useful to detect when a file download is about to start—whether for logging, auditing, or simply tracking user interactions. Equo Chromium provides a system property that enables this behavior by triggering a LocationListener just before a download begins.

Usage

Enable download interception by setting the following system property before creating any browser instance:

-Dchromium.downloadLocationListener=true

When this property is enabled, the registered LocationListener will be notified immediately before a download is initiated.

This can be useful for:

  • Logging download URLs or metadata.

  • Tracking user behavior within the embedded browser.

  • Implementing conditional logic before downloads begin.

Note that this feature does not modify or replace the actual download behavior of Chromium; it simply allows your application to observe the event as it occurs.