CKTIS / JavaScript
history.replaceState — aktualizace aktuální položky historie
history.replaceState aktualizuje stav a případně URL aktuální položky historie, aniž by znovu načetl stránku. Nepřidává položku, takže nevytváří další krok pro tlačítko Zpět.
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
history.replaceState(data, unused)
history.replaceState(data, unused, url)history.replaceState(data, unused, url) nahradí stav aktuální položky; history.pushState položku přidá. Jde o rozhraní prohlížeče definované standardem HTML, nikoli o funkci konkrétní edice ECMAScriptu. Přítomnost Node 24 nepotvrzuje dostupnost v prohlížeči.
Jako povinný historický argument unused předejte ""; název stránky nenastavuje. Pokud url vynecháte, adresa zůstane zachována. Metoda vrací undefined. Dokument znovu nenačte a sama nevyvolá popstate ani hashchange.
Hodnota data se pro uložení klonuje strukturovaným klonováním, nikoli serializuje jako JSON. Uloženou hodnotu načtěte přes history.state; následná změna vstupního objektu uloženou hodnotu nezmění. Funkce a uzly DOM takto ukládat nelze a způsobí DataCloneError.
Pravidla pro přepisování URL porovnávají navrhovanou URL s aktuální URL dokumentu, nikoli s jeho původem (origin). Například dokument na adrese about:blank může změnit fragment své URL, i když svůj původ zdědil. Nepovolená URL, dokument, který není plně aktivní, nebo omezení četnosti volání mohou způsobit SecurityError. Tuto metodu používejte k úpravě aktuálního zobrazení, nikoli k vytvoření nového kroku navigace.
Příklady
(() => {
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);
}
})();Výsledek
details #details true
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.