NavigateEvent: downloadRequest-Eigenschaft
Baseline
2026
Neu verfügbar
Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die downloadRequest-Eigenschaft des NavigateEvent-Interfaces gibt den Dateinamen der Datei zurück, die bei einer Download-Navigation angefordert wurde (z. B. ein <a>- oder <area>-Element mit einem download-Attribut) oder null andernfalls.
Wert
Ein String, der den Dateinamen der angeforderten Datei 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
| Spezifikation |
|---|
| HTML # dom-navigateevent-downloadrequest-dev |