Navigation: back() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die back() Methode der
Navigation Schnittstelle navigiert um einen Eintrag rückwärts in der Navigationshistorie.
Syntax
back(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
infoOptional-
Entwicklerdefinierte Informationen, die an das
navigate-Ereignis übergeben werden und inNavigateEvent.infoverfügbar gemacht werden. Dies kann jeder Datentyp sein. Sie könnten zum Beispiel neu navigierte Inhalte mit einer anderen Animation anzeigen, je nachdem, wie sie navigiert wurden (nach links wischen, nach 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, 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 Versprechen, die vomintercept()-Handler zurückgegeben werden, erfüllt sind. Dies entspricht dem Erfüllen desNavigationTransition.finished-Versprechens, wenn dasnavigatesuccess-Ereignis ausgelöst wird.
Eines dieser Versprechen wird abgelehnt, wenn die Navigation aus irgendeinem Grund fehlgeschlagen ist.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn der
Navigation.currentEntry'sNavigationHistoryEntry.index-Wert -1 oder 0 ist, d.h. entweder ist das aktuelleDocumentnoch nicht aktiv oder der aktuelle Historieneintrag ist der erste in der Historie, was bedeutet, dass rückwä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-back-dev |