NavigateEvent: downloadRequest-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die schreibgeschützte Eigenschaft downloadRequest der NavigateEvent-Schnittstelle gibt den Dateinamen der angeforderten Datei für den Download zurück, im Falle einer Download-Navigation (z. B. ein <a>- oder <area>-Element mit einem download-Attribut) oder null andernfalls.

Wert

Ein String, der den Dateinamen der angeforderten Datei für den Download enthält, oder null.

Beispiele

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);
      }
    },
  });
});

Spezifikationen

Specification
HTML Standard
# dom-navigateevent-downloadrequest-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch