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 ggf. bereitgestellten Zustand in der Liste der Verlaufseinträge.
Syntax
reload()
reload(options)
Parameter
optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
stateOptional-
Vom Entwickler definierte Informationen, die im zugehörigen
NavigationHistoryEntrygespeichert werden, sobald die Navigation abgeschlossen ist und übergetState()abrufbar sind. Dies kann beliebiger Datentyp sein. Sie könnten zum Beispiel eine Seitenaufrufanzahl für Analysezwecke speichern oder UI-Zustandsdetails speichern, damit die Ansicht genau so angezeigt werden kann, wie der Benutzer sie zuletzt verlassen hat. Alle imstategespeicherten Daten müssen strukturierte-klonbar sein. infoOptional-
Vom Entwickler definierte Informationen, die an das
navigate-Ereignis übergeben werden und inNavigateEvent.infoverfügbar sind. Dies kann beliebiger Datentyp sein. Sie könnten zum Beispiel den neu navigierten Inhalt mit einer anderen Animation anzeigen, je nachdem, wie er navigiert wurde (nach links wischen, nach rechts wischen oder zur Startseite gehen). Eine Zeichenkette, die 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 alleintercept()-Handler-Promises erfüllt sind. Dies entspricht dem Erfüllen desNavigationTransition.finishedPromise, wenn dasnavigatesuccess-Ereignis ausgelöst wird.
Einer dieser Promises wird abgelehnt, wenn die Navigation aus irgendeinem Grund fehlgeschlagen ist.
Ausnahmen
DataCloneErrorDOMException-
Wird ausgelöst, wenn der
state-Parameter Werte enthält, die nicht strukturierte-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 einen neuen Zustandselement 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 |