CKTIS / JavaScript
PopStateEvent.state — stan wpisu historii
Właściwość PopStateEvent.state pozwala odczytać stan powiązany z aktywowanym wpisem historii podczas zdarzenia popstate. Poznaj znaczenie null oraz różnicę między zapisaniem stanu a nawigacją w historii.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.statePopStateEvent.state to właściwość tylko do odczytu, dostępna jako event.state. Dla zdarzenia nawigacji zawiera kopię danych zapisanych przez history.pushState() lub history.replaceState() we wpisie, który właśnie aktywowano, a nie w opuszczanym wpisie. Brak zapisanego stanu oznacza null; sprawdź tę wartość przed odczytem pól.
Samo wywołanie history.pushState() lub history.replaceState() nie emituje popstate. Zdarzenie wiąże się z przechodzeniem po historii, na przykład przyciskiem Wstecz. Przeglądarka może wymagać wcześniejszej interakcji ze stroną. W aplikacji odbieraj je przez window.addEventListener("popstate", handler) i odtwarzaj widok na podstawie event.state.
Przykład celowo tworzy dwa obiekty PopStateEvent i przekazuje je bezpośrednio do funkcji. Nie emituje zdarzeń ani nie zmienia historii. Opcja state ustawia dane pierwszego obiektu; jej pominięcie daje null. Oczekiwane wiersze to {"page":2} oraz null.
To przeglądarkowy Web API określony w standardzie HTML, nie funkcja konkretnej edycji ECMAScript. MDN wskazuje szeroką dostępność właściwości od lipca 2015, a konstruktora użytego w przykładzie od sierpnia 2016. Obecność Node 24 w repozytorium nie potwierdza obsługi tych interfejsów.
Przykłady
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Wynik
{"page":2}
nullWyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.