NavigateEvent: downloadRequest property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The downloadRequest
read-only property of the
NavigateEvent
interface returns the filename of the file requested for download, in the case of a download navigation (e.g. an <a>
or <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
Specification |
---|
HTML Standard # dom-navigateevent-downloadrequest-dev |
Browser compatibility
BCD tables only load in the browser