Navigation: navigateerror-Ereignis - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Navigation: navigateerror-Ereignis

Baseline 2026
Neu verfügbar

Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

>

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

Zum Beispiel, wenn das Netzwerk nicht verfügbar ist, wird jede mit der fetch()-Methode initiierte Navigation fehlschlagen, und der Fehler wird an navigateerror weitergeleitet.

Syntax

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

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 ein zuvor angezeigtes Fortschrittsanzeige verbergen, wie hier:

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

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

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

Spezifikationen

Spezifikation
HTML>
# event-navigateerror>

Browser-Kompatibilität

Siehe auch