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.
Wenn beispielsweise die Netzwerkverbindung unterbrochen ist, schlägt jede fetch()-Methode fehl, die zur Verarbeitung einer Navigation aufgerufen wird. Der Fehler wird dann an navigateerror weitergeleitet.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("navigateerror", (event) => { })
Alternativ können Sie der Event-Handler-Eigenschaft der Schnittstelle einen Wert zuweisen:
onnavigateerror = (event) => { }
Ereignistyp
Ein ErrorEvent. Erbt von Event.
Beispiele
Nach einer erfolgreichen Navigation können Sie beispielsweise einen zuvor angezeigten Fortschrittsindikator ausblenden:
navigation.addEventListener("navigatesuccess", (event) => {
loadingIndicator.hidden = true;
});
Bei einem Fehler können Sie stattdessen 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 |