Navigation: navigateerror event
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 navigateerror
event of the Navigation
interface is fired when a navigation fails.
For example, if the network is down, any fetch()
method invoked to handle a navigation will fail, and the error will be routed to navigateerror
.
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener("navigateerror", (event) => {});
onnavigateerror = (event) => {};
Event type
An ErrorEvent
. Inherits from Event
.
Examples
You might deal with a successful navigation by hiding a previously displayed progress indicator, like this:
navigation.addEventListener("navigatesuccess", (event) => {
loadingIndicator.hidden = true;
});
Or you might show an error message on failure:
navigation.addEventListener("navigateerror", (event) => {
loadingIndicator.hidden = true; // also hide indicator
showMessage(`Failed to load page: ${event.message}`);
});
Specifications
Specification |
---|
HTML Standard # event-navigateerror |
Browser compatibility
BCD tables only load in the browser