База знанияИзпитен център
BGБългарски
Избери език13

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.state

PopStateEvent.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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници