NavigationPrecommitController: Methode redirect()

Eingeschränkt verfügbar

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

Want more browser support for this feature? Tell us why.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die Methode redirect() des Interfaces NavigationPrecommitController leitet den Browser zu einer angegebenen URL weiter und legt das Verlaufverhalten sowie gewünschte Statusinformationen fest.

Syntax

redirect(url, options)

Parameter

url

Die URL, zu der weitergeleitet werden soll.

options Optional

Ein Optionsobjekt, dessen Eigenschaften Folgendes umfassen können:

state Optional

Enthält Statusinformationen, die Sie zusammen mit der Navigation übergeben möchten, beispielsweise zu Protokollierungs- oder Tracking-Zwecken. Dies kann durch einen Wert eines beliebigen Typs dargestellt werden. Der Status der Navigation kann anschließend über die Methode NavigationHistoryEntry.getState() des resultierenden Verlaufseintrags abgerufen werden.

history Optional

Ein aufgezählter Wert, der angibt, wie diese Weiterleitung zum Navigationsverlauf hinzugefügt werden soll. Er kann einen der folgenden Werte annehmen:

auto

Der Standardwert, der den Browser entscheiden lässt, wie damit umgegangen wird:

Wenn die ursprüngliche Navigation infolge eines Aufrufs von Navigation.navigate() erfolgte, entspricht der Wert dem, der in der Option history des navigate()-Aufrufs angegeben wurde.
Andernfalls wird normalerweise der Wert push verwendet, aber er wird zu replace, wenn die Weiterleitung auf dieselbe URL wie die URL vor der Navigation verweist.

push

Fügt dem Navigationsverlauf einen neuen NavigationHistoryEntry hinzu und löscht alle verfügbaren Vorwärtsnavigationen (das heißt, wenn die Benutzerin oder der Benutzer zuvor zu anderen Orten navigiert und dann die Zurück-Schaltfläche verwendet hat, um im Verlauf zurückzukehren, bevor die Navigation ausgelöst wurde, die die Weiterleitung verursachte).

replace

Ersetzt den Navigation.currentEntry durch den resultierenden neuen NavigationHistoryEntry.

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