NavigationPrecommitController: redirect() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Die redirect() Methode der NavigationPrecommitController Schnittstelle leitet den Browser zu einer angegebenen URL um und spezifiziert das Verhalten der Historie sowie gewünschte Zustandsinformationen.

Syntax

redirect(url, options)

Parameter

url

Die URL, zu der umgeleitet werden soll.

options Optional

Ein Optionsobjekt, dessen Eigenschaften Folgendes beinhalten können:

state Optional

Enthält beliebige Zustandsinformationen, die Sie zusammen mit der Navigation übergeben möchten; zum Beispiel für Protokollierungs- oder Verfolgungszwecke. Dies kann durch jeden Werttyp dargestellt werden. Der Zustand der Navigation kann anschließend über die NavigationHistoryEntry.getState() Methode des resultierenden Historieneintrags abgerufen werden.

history Optional

Ein enumerierter Wert, der angibt, wie dieser Redirect zur Navigation-Historie hinzugefügt werden soll. Er kann einen der folgenden Werte annehmen:

auto

Der Standardwert, der es dem Browser überlässt, wie damit umgegangen wird:

Wenn die ursprüngliche Navigation durch einen Aufruf von Navigation.navigate() erfolgt ist, wird der Wert verwendet, der in der navigate() Aufrufoption history angegeben wurde.
Andernfalls wird normalerweise push verwendet, aber es wird replace, wenn der Redirect auf dieselbe URL verweist wie die vor der Navigation.

push

Fügt einen neuen NavigationHistoryEntry zur Navigation-Historie hinzu und löscht jegliche verfügbare Vorwärtsnavigation (d.h. wenn der Benutzer zuvor zu anderen Orten navigiert und dann die Zurück-Taste verwendet hat, um durch die Historie zur Navigation zurückzukehren, die die Umleitung verursacht hat).

replace

Ersetzt den Navigation.currentEntry durch den resultierenden neuen NavigationHistoryEntry.

Hinweis: Die redirect() Methode kann das Historieverhalten zwischen auto, push und replace umwandeln, aber sie kann keine traverse-Navigation in eine push/replace-Navigation und umgekehrt umwandeln.