Back to Content

Navigation: navigateerror event

files/en-us/web/api/navigation/navigateerror_event/index.md

latest1.4 KB
Original Source

{{APIRef("Navigation API")}}

The navigateerror event of the {{domxref("Navigation")}} interface is fired when a navigation fails.

For example, if the network is down, any {{domxref("Window/fetch", "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 {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

js-nolint
addEventListener("navigateerror", (event) => { })

onnavigateerror = (event) => { }

Event type

An {{domxref("ErrorEvent")}}. Inherits from {{domxref("Event")}}.

{{InheritanceDiagram("ErrorEvent")}}

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

{{Specifications}}

Browser compatibility

{{Compat}}

See also