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

CKTIS / JavaScript

history.pushState() — záznam v historii bez opětovného načtení

history.pushState() obvykle přidá záznam do historie relace, uloží stav a volitelně změní URL, aniž by načetlo nový dokument. Rozhraní je třeba aktualizovat samostatně.

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.pushState(state, unused[, url]);

history.pushState() je API prohlížeče definované standardem HTML, nikoli ECMAScriptem; současné prohlížečové enginy ho podporují. Dostupnost Node 24 nedokazuje jeho dostupnost. Metoda obvykle přidá záznam do historie relace, ale u počátečního dokumentu about:blank nahradí aktuální záznam, místo aby přidala nový. V obou případech vrátí undefined, aniž by načetla nový dokument. Naproti tomu history.replaceState() aktualizuje aktuální záznam a nový nepřidává.

state se serializuje, neuchovává jako reference; přečíst ho lze přes history.state. Funkce takto ukládat nelze a způsobí DataCloneError. Povinný parametr unused obvykle dostává hodnotu ''; nenastavuje název stránky.

Volitelná url může být relativní; pokud ji vynecháte, adresa zůstane beze změny. Na stránkách HTTP(S) musí zachovat stejný původ: schéma, hostitele a port. Nepovolená URL, dokument, který není plně aktivní, nebo příliš častá volání mohou způsobit SecurityError.

Volání nevyvolá popstate ani hashchange, a to ani při změně fragmentu. Rozhraní aktualizujte sami; při navigaci Zpět/Vpřed zpracujte popstate a event.state. Příklad ukazuje, že pozdější změna vstupního objektu uložený stav nezmění.

Příklady

(() => {
  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
  }));
})();

Výsledek

{"page":2,"hash":"#cktis-page-2","returnsUndefined":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