CKTIS / JavaScript
PopStateEvent.state — status van het geschiedenisitem
Met PopStateEvent.state lees je de status die hoort bij het geschiedenisitem dat tijdens een popstate-gebeurtenis wordt geactiveerd. Lees wat null betekent en waarom status opslaan iets anders is dan door de geschiedenis navigeren.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.statePopStateEvent.state is een alleen-lezen eigenschap die je uitleest als event.state. Bij een navigatiegebeurtenis bevat deze een kopie van de gegevens die met history.pushState() of history.replaceState() zijn opgeslagen in het item dat wordt geactiveerd, niet in het item dat wordt verlaten. Ontbreekt opgeslagen status, dan is de waarde null; controleer dit voordat je velden uitleest.
Alleen history.pushState() of history.replaceState() aanroepen veroorzaakt geen popstate. De gebeurtenis hoort bij het doorlopen van de geschiedenis, bijvoorbeeld wanneer je op de knop Vorige klikt. Een browser kan vereisen dat de gebruiker eerder met de pagina heeft geïnteracteerd. Luister in een toepassing met window.addEventListener("popstate", handler) naar de gebeurtenis en herstel de weergave aan de hand van event.state.
Het voorbeeld maakt bewust twee PopStateEvent-objecten en geeft die rechtstreeks door aan een functie. Het verstuurt geen gebeurtenissen en verandert de geschiedenis niet. De optie state geeft de gegevens van het eerste object mee; als je deze weglaat, is de waarde null. De verwachte regels zijn {"page":2} en null.
Dit is een browser-Web-API die is vastgelegd in de HTML-standaard, geen functie van een specifieke ECMAScript-editie. MDN vermeldt dat de eigenschap sinds juli 2015 breed beschikbaar is en dat de constructor uit het voorbeeld sinds augustus 2016 beschikbaar is. Dat Node 24 in een repository aanwezig is, bewijst niet dat deze interfaces worden ondersteund.
Voorbeelden
(() => {
function describeState(event) {
console.log(JSON.stringify(event.state));
}
describeState(new PopStateEvent("popstate", { state: { page: 2 } }));
describeState(new PopStateEvent("popstate"));
})();Resultaat
{"page":2}
nullDe getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.