CKTIS / JavaScript
history.pushState() — záznam v histórii bez opätovného načítania
history.pushState() zvyčajne pridá záznam do histórie relácie, uloží stav a voliteľne zmení URL bez načítania nového dokumentu. Rozhranie treba aktualizovať samostatne.
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.pushState(state, unused[, url]);history.pushState() je API prehliadača definované štandardom HTML, nie ECMAScriptom; súčasné prehliadačové enginy ho podporujú. Dostupnosť Node 24 nedokazuje jeho dostupnosť. Metóda zvyčajne pridá záznam do histórie relácie, ale pri počiatočnom dokumente about:blank nahradí aktuálny záznam namiesto pridania nového. V oboch prípadoch vráti undefined bez načítania nového dokumentu. Na rozdiel od nej history.replaceState() aktualizuje aktuálny záznam a nový nepridáva.
state sa serializuje, neuchováva sa ako referencia; prečítať ho možno cez history.state. Funkcie sa takto ukladať nedajú a spôsobia DataCloneError. Povinný parameter unused zvyčajne dostáva hodnotu ''; nenastavuje názov stránky.
Voliteľná url môže byť relatívna; ak ju vynecháte, adresa zostane nezmenená. Na stránkach HTTP(S) musí zachovať rovnaký pôvod: schému, hostiteľa a port. Nepovolená URL, dokument, ktorý nie je úplne aktívny, alebo príliš časté volania môžu spôsobiť SecurityError.
Volanie nevyvolá popstate ani hashchange, a to ani pri zmene fragmentu. Rozhranie aktualizujte sami; pri navigácii Späť/Vpred spracujte popstate a event.state. Príklad ukazuje, že neskoršia zmena vstupného objektu uložený stav nezmení.
Prí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ýsledok
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.