CKTIS / JavaScript
PopStateEvent.state — състояние на запис в историята
PopStateEvent.state позволява да прочетете състоянието, свързано със записа в историята, активиран по време на събитие popstate. Научете какво означава null и защо запазването на състояние е различно от навигирането в историята.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.statePopStateEvent.state е свойство само за четене, достъпно чрез event.state. При събитие за навигация то съдържа копие на данните, запазени чрез history.pushState() или history.replaceState() в току-що активирания запис, а не в записа, който се напуска. Ако няма запазено състояние, стойността е null; проверете я, преди да четете полета.
Самото извикване на history.pushState() или history.replaceState() не задейства popstate. Събитието е свързано с преминаването през историята, например при използване на бутона Назад. Браузърът може да изисква предишно взаимодействие със страницата. В приложение приемайте събитието чрез window.addEventListener("popstate", handler) и възстановявайте изгледа въз основа на event.state.
Примерът умишлено създава два обекта PopStateEvent и ги подава директно на функция. Той не изпраща събития и не променя историята. Опцията state задава данните на първия обект; ако бъде пропусната, стойността е null. Очакваните редове са {"page":2} и null.
Това е уеб API на браузъра, дефиниран от стандарта HTML, а не функция на конкретно издание на ECMAScript. MDN посочва, че свойството е широко достъпно от юли 2015 г., а конструкторът, използван в примера — от август 2016 г. Наличието на Node 24 в хранилище не доказва поддръжка на тези интерфейси.
Примери
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Резултат
{"page":2}
nullПоказаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.