CKTIS / JavaScript
history.replaceState — het huidige geschiedenisitem bijwerken
history.replaceState werkt de status en eventueel de URL van het huidige geschiedenisitem bij zonder de pagina opnieuw te laden. Het voegt geen item toe en maakt dus geen extra stap voor de knop Vorige.
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.replaceState(data, unused)
history.replaceState(data, unused, url)history.replaceState(data, unused, url) vervangt de status van het huidige item; history.pushState voegt een item toe. Dit is een browser-API die door HTML is gedefinieerd, geen functie van een bepaalde ECMAScript-editie. Dat Node 24 beschikbaar is, bewijst niet dat de API in de browser beschikbaar is.
Geef "" mee als het verplichte historische argument unused; het stelt de titel niet in. Als url ontbreekt, blijft het adres behouden. De methode geeft undefined terug. De methode laadt het document niet opnieuw en veroorzaakt zelf geen popstate of hashchange.
data wordt voor opslag gestructureerd gekloond, niet als JSON geserialiseerd. Lees de opgeslagen waarde via history.state; latere wijzigingen aan het invoerobject veranderen de opgeslagen waarde niet. Functies en DOM-knooppunten kunnen niet op deze manier worden opgeslagen en veroorzaken DataCloneError.
De regels voor het herschrijven van de URL vergelijken de voorgestelde URL met de huidige URL van het document, niet met de origin van het document. Zo kan een document op about:blank het fragment van zijn URL wijzigen, ook als het zijn origin erft. Een niet-toegestane URL, een document dat niet volledig actief is of beperkingen aan de oproepfrequentie kunnen SecurityError veroorzaken. Gebruik deze methode om de huidige weergave aan te passen, niet om een nieuwe navigatiestap te maken.
Voorbeelden
(() => {
const previousState = history.state;
const previousURL = location.href;
const previousLength = history.length;
const data = { tab: "details" };
const url = new URL(location.href);
url.hash = "details";
try {
history.replaceState(data, "", url.href);
data.tab = "changed";
console.log(history.state.tab);
console.log(location.hash);
console.log(history.length === previousLength);
} finally {
history.replaceState(previousState, "", previousURL);
}
})();Resultaat
details #details 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.