Navigation: navigateerror-Ereignis
Baseline 2026
Neu verfügbar
Seit Januar 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.
addEventListener("navigateerror", (event) => { })
onnavigateerror = (event) => { }
Ereignistyp
Ein ErrorEvent. Erbt von Event.
Beispiele
Sie könnten mit einer erfolgreichen Navigation umgehen, indem Sie ein zuvor angezeigtes Fortschrittsanzeige verbergen, wie hier:
navigation.addEventListener("navigatesuccess", (event) => {
loadingIndicator.hidden = true;
});
Oder Sie könnten bei einem Fehler eine Fehlermeldung anzeigen:
navigation.addEventListener("navigateerror", (event) => {
loadingIndicator.hidden = true; // also hide indicator
showMessage(`Failed to load page: ${event.message}`);
});
Spezifikationen
| Spezifikation |
|---|
| HTML # event-navigateerror |