Navigation : évènement navigateerror
Baseline 2026
Nouvellement disponible
Depuis janvier 2026, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.
L'évènement navigateerror de l'interface Navigation est déclenché lorsqu'une navigation échoue.
Par exemple, si le réseau est indisponible, toute méthode fetch() invoquée pour gérer une navigation échoue, et l'erreur est transmise à navigateerror.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("navigateerror", (event) => { })
onnavigateerror = (event) => { }
Type d'évènement
Un objet ErrorEvent. Hérite de Event.
Exemples
Vous pouvez gérer une navigation réussie en masquant un indicateur de progression précédemment affiché, comme ceci :
navigation.addEventListener("navigatesuccess", (event) => {
loadingIndicator.hidden = true;
});
Ou vous pouvez afficher un message d'erreur en cas d'échec :
navigation.addEventListener("navigateerror", (event) => {
loadingIndicator.hidden = true; // masque également l'indicateur
showMessage(`Failed to load page: ${event.message}`);
});
Spécifications
| Spécification |
|---|
| HTML # event-navigateerror |