CKTIS / JavaScript
history.pushState() — vnos v zgodovini brez ponovnega nalaganja
history.pushState() praviloma doda vnos v zgodovino seje, shrani stanje in po želji spremeni URL, ne da bi naložil nov dokument. Uporabniški vmesnik moraš posodobiti posebej.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
history.pushState(state, unused[, url]);history.pushState() je brskalniški API, opredeljen v HTML, ne v ECMAScriptu; podpirajo ga sodobni brskalniški pogoni. Razpoložljivost Node 24 ne dokazuje, da je ta API tam na voljo. Metoda praviloma doda vnos v zgodovino seje, v začetnem dokumentu about:blank pa namesto dodajanja novega vnosa nadomesti trenutnega. V obeh primerih vrne undefined, ne da bi naložila nov dokument. Nasprotno history.replaceState() posodobi trenutni vnos, ne da bi dodal novega.
state se serializira in se ne ohrani kot sklic; prebereš ga lahko prek history.state. Funkcij na ta način ni mogoče shraniti in povzročijo DataCloneError. Obvezni parameter unused običajno prejme vrednost ''; ne nastavi naslova strani.
Izbirni url je lahko relativni; če ga izpustiš, naslov ostane nespremenjen. Na straneh HTTP(S) mora ohraniti isti izvor: shemo, gostitelja in vrata. Nedovoljen URL, dokument, ki ni povsem aktiven, ali prepogosti klici lahko povzročijo SecurityError.
Klic ne sproži ne popstate ne hashchange, tudi če se fragment spremeni. Uporabniški vmesnik posodobi sam; pri premikanju Nazaj/Naprej obravnavaj popstate in event.state. Primer pokaže, da poznejša sprememba vhodnega objekta ne spremeni shranjenega stanja.
Primeri
(() => {
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
}));
})();Rezultat
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.