Navigation: forward() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Die forward()
Methode des Navigation
-Interfaces navigiert vorwärts um einen Eintrag im Navigationsverlauf.
Syntax
forward(options)
Parameter
options
Optional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
info
Optional-
Entwicklerdefinierte Informationen, die an das
navigate
-Event übergeben werden und inNavigateEvent.info
verfügbar gemacht werden. Dies kann jeder Datentyp sein. Sie könnten beispielsweise wünschen, neu navigierte Inhalte mit einer anderen Animation anzuzeigen, je nachdem, wie zu ihnen navigiert wurde (nach links oder rechts wischen oder zur Startseite gehen). Ein String, der angibt, welche Animation verwendet werden soll, könnte alsinfo
übergeben werden.
Rückgabewert
Ein Objekt mit den folgenden Eigenschaften:
committed
-
Ein
Promise
, der erfüllt wird, wenn sich die sichtbare URL geändert hat und ein neuerNavigationHistoryEntry
erstellt wurde. finished
-
Ein
Promise
, der erfüllt wird, wenn alle von demNavigateEvent.intercept()
-Handler zurückgegebenen Promises erfüllt sind. Dies entspricht dem Erfüllen desNavigationTransition.finished
-Versprechens, wenn dasnavigatesuccess
-Ereignis ausgelöst wird.
Einer dieser Promises schlägt fehl, wenn die Navigation aus irgendeinem Grund fehlgeschlagen ist.
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn der
Navigation.currentEntry
'sNavigationHistoryEntry.index
-Wert -1 odernavigation.entries().length - 1
ist, d. h. entweder das aktuelleDocument
ist noch nicht aktiv oder der aktuelle Verlaufs-Eintrag ist der letzte im Verlauf, was bedeutet, dass eine Vorwärtsnavigation nicht möglich ist, oder wenn das aktuelleDocument
entladen wird.
Beispiele
async function backHandler() {
if (navigation.canGoBack) {
await navigation.back().finished;
// Handle any required clean-up after
// navigation has finished
} else {
displayBanner("You are on the first page");
}
}
async function forwardHandler() {
if (navigation.canGoForward) {
await navigation.forward().finished;
// Handle any required clean-up after
// navigation has finished
} else {
displayBanner("You are on the last page");
}
}
Spezifikationen
Specification |
---|
HTML Standard # dom-navigation-forward-dev |
Browser-Kompatibilität
BCD tables only load in the browser