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.