Back to Content

NavigateEvent: downloadRequest property

files/en-us/web/api/navigateevent/downloadrequest/index.md

latest1.3 KB
Original Source

{{APIRef("Navigation API")}}

The downloadRequest read-only property of the {{domxref("NavigateEvent")}} interface returns the filename of the file requested for download, in the case of a download navigation (e.g., an {{htmlelement("a")}} or {{htmlelement("area")}} element with a download attribute), or null otherwise.

Value

A string containing the filename of the file requested for download, or null.

Examples

js
navigation.addEventListener("navigate", (event) => {
  // Some navigations, e.g. cross-origin navigations, we
  // cannot intercept. Let the browser handle those normally.
  if (!event.canIntercept) {
    return;
  }

  // Don't intercept fragment navigations or downloads.
  if (event.hashChange || event.downloadRequest !== null) {
    return;
  }

  event.intercept({
    handler() {
      if (event.formData) {
        processFormDataAndUpdateUI(event.formData, event.signal);
      } else {
        doSinglePageAppNav(event.destination, event.signal);
      }
    },
  });
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also