Navigation: navigateerror-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das navigateerror-Ereignis der Navigation-Schnittstelle wird ausgelöst, wenn eine Navigation fehlschlägt.

Zum Beispiel, wenn das Netzwerk ausfällt, wird jede mit der Navigation verbundene fetch()-Methode fehlschlagen, und der Fehler wird an navigateerror weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

onnavigateerror = (event) => {};

Ereignistyp

Ein ErrorEvent. Erbt von Event.

Event ErrorEvent

Beispiele

Sie könnten mit einer erfolgreichen Navigation umgehen, indem Sie einen zuvor angezeigten Fortschrittsindikator verbergen, so wie dies:

js
navigation.addEventListener("navigatesuccess", (event) => {
  loadingIndicator.hidden = true;
});

Oder Sie können eine Fehlermeldung bei einem Fehler anzeigen:

js
navigation.addEventListener("navigateerror", (event) => {
  loadingIndicator.hidden = true; // also hide indicator
  showMessage(`Failed to load page: ${event.message}`);
});

Spezifikationen

Specification
HTML Standard
# event-navigateerror

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch