/Web APIs

Navigation: navigateerror event

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.


Use the event name in methods like addEventListener(), or set an event handler property.


addEventListener("navigateerror", (event) => {});

onnavigateerror = (event) => {};

Event type


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


Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
navigateerror_event 102 102 No No 88 No 102 102 No 70 No 19.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.