Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

PopStateEvent.state — stav položky historie

PopStateEvent.state umožňuje přečíst stav spojený s položkou historie aktivovanou během události popstate. Zjistěte, co znamená null a proč se ukládání stavu liší od procházení historie.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.state

PopStateEvent.state je vlastnost pouze pro čtení, ke které se přistupuje jako k event.state. Při navigační události obsahuje kopii dat uložených pomocí history.pushState() nebo history.replaceState() v právě aktivované položce, nikoli v opouštěné položce. Pokud žádný stav uložen není, hodnota je null; před čtením polí to ověřte.

Samotné volání history.pushState() nebo history.replaceState() událost popstate nevyvolá. Tato událost souvisí s procházením historie, například s použitím tlačítka Zpět. Prohlížeč může vyžadovat předchozí interakci se stránkou. V aplikaci událost zachyťte pomocí window.addEventListener("popstate", handler) a obnovte zobrazení podle event.state.

Příklad záměrně vytvoří dva objekty PopStateEvent a předá je přímo funkci. Události neodesílá ani nemění historii. Možnost state poskytuje data prvního objektu; pokud ji vynecháte, výsledná hodnota je null. Očekávané řádky jsou {"page":2} a null.

Jde o webové API prohlížeče definované standardem HTML, nikoli o funkci konkrétní edice ECMAScriptu. MDN uvádí širokou dostupnost vlastnosti od července 2015 a konstruktoru použitého v příkladu od srpna 2016. Přítomnost Node 24 v repozitáři nedokládá podporu těchto rozhraní.

Příklady

(() => {
  function describeState(event) {
    console.log(JSON.stringify(event.state));
  }

  describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
  describeState(new PopStateEvent("popstate"));
})();

Výsledek

{"page":2}
null

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje