Navigation: forward() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die forward() Methode des Navigation-Interfaces navigiert um einen Eintrag vorwärts in der Navigationshistorie.
Syntax
forward(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
infoOptional-
Vom Entwickler definierte Informationen, die an das
navigate-Ereignis übergeben werden und inNavigateEvent.infoverfügbar sind. Dies kann jeder Datentyp sein. Sie könnten beispielsweise den neu navigierten Inhalt mit einer anderen Animation anzeigen lassen, abhängig davon, wie dorthin navigiert wurde (nach links wischen, nach rechts wischen oder nach Hause 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, das erfüllt wird, wenn sich die sichtbare URL geändert hat und ein neuerNavigationHistoryEntryerstellt wurde. finished-
Ein
Promise, das erfüllt wird, wenn alle von demNavigateEvent.intercept()-Handler zurückgegebenen Versprechen erfüllt sind. Dies entspricht dem Erfüllen desNavigationTransition.finishedVersprechens, wenn dasnavigatesuccessEreignis eintritt.
Eines dieser Versprechen wird zurückgewiesen, falls die Navigation aus irgendeinem Grund fehlgeschlagen ist.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn der
Navigation.currentEntry'sNavigationHistoryEntry.indexWert -1 ist odernavigation.entries().length - 1, d.h. entweder ist das aktuelleDocumentnoch nicht aktiv, oder der aktuelle Historieneintrag ist der letzte in der Historie, was bedeutet, dass eine vorwärtige Navigation nicht möglich ist, oder wenn das aktuelleDocumententladen 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 # dom-navigation-forward-dev |