Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

history.replaceState — aktualizácia aktuálnej položky histórie

history.replaceState aktualizuje stav a prípadne URL aktuálnej položky histórie bez opätovného načítania stránky. Nepridáva položku, takže nevytvára ďalší krok pre tlačidlo Späť.

Verzia: 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) nahradí stav aktuálnej položky; history.pushState pridá položku. Ide o rozhranie prehliadača definované štandardom HTML, nie o funkciu konkrétnej edície ECMAScriptu. Prítomnosť Node 24 nepotvrdzuje dostupnosť v prehliadači.

Ako povinný historický argument unused odovzdajte ""; názov stránky nenastavuje. Ak vynecháte url, adresa zostane zachovaná. Metóda vracia undefined. Dokument znova nenačíta a sama nevyvolá popstate ani hashchange.

Hodnota data sa na uloženie klonuje štruktúrovaným klonovaním, neserializuje sa ako JSON. Uloženú hodnotu načítajte cez history.state; neskoršia zmena vstupného objektu uloženú hodnotu nezmení. Funkcie a uzly DOM sa takto ukladať nedajú a spôsobia DataCloneError.

Pravidlá prepisovania URL porovnávajú navrhovanú URL s aktuálnou URL dokumentu, nie s jeho pôvodom (origin). Napríklad dokument na adrese about:blank môže zmeniť fragment svojej URL, aj keď svoj pôvod zdedil. Nepovolená URL, dokument, ktorý nie je úplne aktívny, alebo obmedzenia frekvencie volaní môžu spôsobiť SecurityError. Túto metódu používajte na úpravu aktuálneho zobrazenia, nie na vytvorenie nového kroku navigácie.

Prí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ýsledok

details
#details
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje