Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

NavigationTransition

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'interface NavigationTransition de l'API Navigation représente une navigation en cours — une navigation qui n'a pas encore atteint l'évènement navigatesuccess ou navigateerror.

Elle est accessible par la propriété Navigation.transition. Notez que cette propriété n'est remplie que tant que le gestionnaire intercept() n'est pas résolu (c'est-à-dire, lors d'une interception de navigation), et est sinon null.

Propriétés d'instance

committed Lecture seule

Retourne une promesse (Promise) qui se complète lorsque Navigation.currentEntry est mis à jour et que la nouvelle URL est affichée dans le navigateur, marquant la navigation comme engagée.

finished Lecture seule

Retourne une promesse (Promise) qui se complète en même temps que l'évènement navigatesuccess se déclenche, ou se rompt en même temps que l'évènement navigateerror se déclenche.

from Lecture seule

Retourne l'entrée NavigationHistoryEntry depuis laquelle la transition provient.

Retourne le type de la navigation en cours.

to Lecture seule

Retourne un objet NavigationDestination vers lequel la transition se dirige.

Exemples

js
async function cleanupNavigation() {
  await navigation.transition.finished;
  // La navigation s'est terminée avec succès
  // Nettoyer toute surveillance en cours
}

Spécifications

Spécification
HTML
# navigationtransition

Compatibilité des navigateurs

Voir aussi