NavigationPrecommitController : méthode redirect()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Vous voulez une meilleure prise en charge pour cette fonctionnalité ? Dites-nous pourquoi.

Voir la compatibilité complète
En savoir plus

La méthode redirect() de l'interface NavigationPrecommitController redirige le navigateur vers une URL définie et précise le comportement de l'historique ainsi que toute information d'état souhaitée.

Syntaxe

redirect(url, options)

Paramètres

url

L'URL vers laquelle rediriger.

options Facultatif

Un objet d'options, dont les propriétés peuvent inclure :

state Facultatif

Contient toutes les informations d'état que vous souhaitez transmettre avec la navigation ; par exemple, à des fins de journalisation ou de suivi. Cela peut être représenté par n'importe quel type de valeur. L'état de la navigation peut ensuite être récupéré par la méthode NavigationHistoryEntry.getState() de l'entrée d'historique qui en résulte.

history Facultatif

Une valeur énumérée qui définit comment cette redirection doit être ajoutée à l'historique de navigation. Elle peut prendre l'une des valeurs suivantes :

auto

La valeur par défaut, qui laisse le navigateur décider comment la gérer :

Si la navigation d'origine a eu lieu à la suite d'un appel à Navigation.navigate(), la valeur est celle définie dans l'option history de l'appel navigate().
Sinon, la valeur utilisée est généralement push, mais elle devient replace si la redirection pointe vers la même URL que l'URL avant la navigation.

push

Ajoute un nouvel objet NavigationHistoryEntry à l'historique de navigation et efface toute navigation avant disponible (c'est-à-dire, si l'utilisateur·ice a précédemment navigué vers d'autres emplacements, puis a utilisé le bouton de retour pour revenir dans l'historique avant d'initier la navigation qui a provoqué la redirection).

replace

Remplace la valeur de Navigation.currentEntry par le nouvel objet NavigationHistoryEntry résultant.

Note : La méthode redirect() peut convertir le comportement de l'historique entre auto, push et replace, mais elle ne peut pas transformer une navigation traverse en une navigation push/replace et inversement.