NavigationHistoryEntry: getState()-Methode
Baseline
2026
Neu verfügbar
Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die getState()-Methode der NavigationHistoryEntry-Schnittstelle gibt eine Kopie des vom Entwickler bereitgestellten Zustands zurück, der mit diesem Historie-Eintrag verknüpft ist.
Syntax
js
getState()
Parameter
Keine.
Rückgabewert
Ein Wert, der den Zustand darstellt. Dies kann jeder structurable-klonbare Datentyp sein.
Wenn kein Zustand definiert ist oder das aktuelle Dokument nicht vollständig aktiv ist, wird undefined zurückgegeben.
Ausnahmen
Keine.
Beispiele
js
async function handleReload() {
// Update existing state via reload()
await navigation.reload({
state: { ...navigation.currentEntry.getState(), newState: 3 },
});
// Print current state to the console
const current = navigation.currentEntry;
console.log(current.getState());
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-navigationhistoryentry-getstate-dev |
Browser-Kompatibilität
Siehe auch
- Modernes clientseitiges Routing: die Navigation API
- Erklärungsdokument zur Navigation API
- Methoden, die es erlauben, den Zustand zu aktualisieren —
Navigation.navigate(),Navigation.reload()undNavigation.updateCurrentEntry()