Navigation: updateCurrentEntry() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die updateCurrentEntry() Methode des Navigation Interface aktualisiert den state des currentEntry. Dies wird in Fällen verwendet, in denen die Statusänderung unabhängig von einer Navigation oder einem Neuladungsvorgang erfolgen soll.
Syntax
updateCurrentEntry(options)
Parameter
options-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
state-
Entwicklerdefinierte Informationen, die im zugehörigen
NavigationHistoryEntrygespeichert werden sollen, sobald die Navigation abgeschlossen ist, und die übergetState()abgerufen werden können. Dies kann jeder Datentyp sein. Sie könnten beispielsweise die Anzahl der Seitenbesuche für Analysezwecke speichern oder Details zum UI-Status speichern, sodass die Ansicht genau so angezeigt werden kann, wie der Benutzer sie zuletzt verlassen hat. Alle imstategespeicherten Daten müssen strukturierbar kopierbar sein.
Rückgabewert
Keiner (undefined).
Ausnahmen
DataCloneErrorDOMException-
Wird ausgelöst, wenn der
state-Parameter Werte enthält, die nicht strukturierbar kopierbar sind. InvalidStateErrorDOMException-
Wird ausgelöst, wenn der
Navigation.currentEntrynullist, d.h. es gibt keinen aktuellen Verlaufseintrag. Dies könnte zum Beispiel der Fall sein, wenn die aktuelle Seiteabout:blankist.
Beispiele
Sie könnten etwas wie das Folgende verwenden, um den offenen/geschlossenen Status eines <details>-Elements zu aktualisieren, sodass der Status beim Neuladen der Seite oder beim Zurücknavigieren von einem anderen Ort aus wiederhergestellt werden kann.
detailsElem.addEventListener("toggle", () => {
navigation.updateCurrentEntry({ state: { detailOpen: detailsElem.open } });
});
Spezifikationen
| Specification |
|---|
| HTML # dom-navigation-updatecurrententry-dev |