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

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.

Zdroje