Navigation: reload() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die reload() Methode der Navigation Schnittstelle lädt die aktuelle URL neu und aktualisiert dabei alle im Verlaufseinträge enthaltenen Zustände.
Beachten Sie, dass reload() nicht das popstate Ereignis auslöst, da dieses nur bei "weichen" Navigationen ausgelöst wird, die ein „Durchlaufen“ der Verlaufseinträge verursachen.
Syntax
reload()
reload(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
stateOptional-
Entwicklerdefinierte Informationen, die im zugehörigen
NavigationHistoryEntrygespeichert werden, sobald die Navigation abgeschlossen ist und die übergetState()abgerufen werden können. Dies kann jeder Datentyp sein. Sie möchten beispielsweise möglicherweise die Anzahl der Seitenbesuche zu Analysezwecken speichern oder UI-Statusdetails speichern, damit die Ansicht genau so angezeigt werden kann, wie der Benutzer sie zuletzt verlassen hat. Alle instategespeicherten Daten müssen struktur-klonbar sein. infoOptional-
Entwicklerdefinierte Informationen, die an das
navigateEreignis übergeben und inNavigateEvent.infoverfügbar gemacht werden. Dies kann jeder Datentyp sein. Sie möchten beispielsweise den neu navigierten Inhalt mit einer anderen Animation anzeigen, je nachdem, wie er navigiert wurde (nach links wischen, nach rechts wischen oder nach Hause gehen). Eine Zeichenfolge, die angibt, welche Animation verwendet werden soll, kann alsinfoübergeben werden.
Rückgabewert
Ein Objekt mit den folgenden Eigenschaften:
committed-
Ein
Promise, das erfüllt wird, wenn die sichtbare URL geändert wurde und ein neuerNavigationHistoryEntryerstellt wurde. finished-
Ein
Promise, das erfüllt wird, wenn alle von demintercept()Handler zurückgegebenen Versprechen erfüllt sind. Dies entspricht der Erfüllung desNavigationTransition.finishedVersprechens, wenn dasnavigatesuccessEreignis ausgelöst wird.
Eines dieser Versprechen wird abgelehnt, wenn die Navigation aus irgendeinem Grund fehlgeschlagen ist.
Ausnahmen
DataCloneErrorDOMException-
Wird ausgelöst, wenn der
stateParameter Werte enthalten hatte, die nicht struktur-klonbar sind.
Beispiele
Verwendung von info und state
async function handleReload() {
await navigation.reload({
info: { animation: "fade-in" },
state: { infoPaneOpen: true },
}).finished;
// Update application state
// …
}
Seite neu laden und ein neues Statusobjekt hinzufügen:
async function handleReload() {
await navigation.reload({
state: { ...navigation.currentEntry.getState(), newState: 3 },
}).finished;
// Update application state
// …
}
Spezifikationen
| Specification |
|---|
| HTML # dom-navigation-reload-dev |