Navigation: navigateerror event
Baseline
2026
Newly available
Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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.
js
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:
js
navigation.addEventListener("navigatesuccess", (event) => {
loadingIndicator.hidden = true;
});
Or you might show an error message on failure:
js
navigation.addEventListener("navigateerror", (event) => {
loadingIndicator.hidden = true; // also hide indicator
showMessage(`Failed to load page: ${event.message}`);
});
Specifications
| Specification |
|---|
| HTML # event-navigateerror |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
navigateerror event
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support