CKTIS / JavaScript
history.pushState() — een geschiedenisvermelding zonder herladen
history.pushState() voegt normaal gesproken een vermelding toe aan de sessiegeschiedenis, slaat een status op en wijzigt optioneel de URL zonder een nieuw document te laden. Je moet de interface zelf bijwerken.
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
history.pushState(state, unused[, url]);history.pushState() is een browser-API die door HTML wordt gedefinieerd, niet door ECMAScript; huidige browserengines ondersteunen deze API. De beschikbaarheid van Node 24 bewijst niet dat de API daar beschikbaar is. De methode voegt normaal gesproken een vermelding toe aan de sessiegeschiedenis, maar bij een initieel about:blank-document vervangt ze de huidige vermelding in plaats van een nieuwe toe te voegen. In beide gevallen geeft de methode undefined terug zonder een nieuw document te laden. history.replaceState() daarentegen werkt de huidige vermelding bij zonder een nieuwe toe te voegen.
state wordt geserialiseerd en niet als verwijzing bewaard; je kunt de waarde uitlezen via history.state. Functies kunnen niet op deze manier worden opgeslagen en veroorzaken DataCloneError. De verplichte parameter unused krijgt gewoonlijk ''; deze stelt de paginatitel niet in.
De optionele url mag relatief zijn; als je deze weglaat, blijft het adres ongewijzigd. Op HTTP(S)-pagina’s moet dezelfde origin behouden blijven: schema, host en poort. Een niet-toegestane URL, een document dat niet volledig actief is of te frequente aanroepen kunnen SecurityError veroorzaken.
De aanroep activeert noch popstate noch hashchange, ook niet als het fragment verandert. Werk de interface zelf bij; verwerk popstate en event.state voor navigatie met Vorige/Volgende. Het voorbeeld laat zien dat een latere wijziging van het invoerobject de opgeslagen status niet verandert.
Voorbeelden
(() => {
const state = { page: 2 };
const url = new URL(location.href);
url.hash = 'cktis-page-2';
const result = history.pushState(state, '', url.href);
state.page = 99;
console.log(JSON.stringify({
page: history.state.page,
hash: location.hash,
returnsUndefined: result === undefined
}));
})();Resultaat
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}De 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.