Navigation: navigateerror-Ereignis
Baseline
2026
Newly available
Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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
| Specification |
|---|
| HTML # event-navigateerror |