CKTIS / JavaScript
history.pushState() — unos u povijest bez ponovnog učitavanja
history.pushState() obično dodaje unos u povijest sesije, sprema stanje i po želji mijenja URL bez učitavanja novog dokumenta. Sučelje treba ažurirati zasebno.
Verzija: 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() API je preglednika definiran standardom HTML, a ne ECMAScriptom; podržavaju ga suvremeni preglednički mehanizmi. Dostupnost Node 24 ne dokazuje da je API ondje dostupan. Metoda obično dodaje unos u povijest sesije, ali u početnom dokumentu about:blank zamjenjuje trenutačni unos umjesto da doda novi. U oba slučaja vraća undefined bez učitavanja novog dokumenta. Za razliku od nje, history.replaceState() ažurira trenutačni unos bez dodavanja novog.
state se serijalizira i ne čuva kao referenca; možeš ga pročitati putem history.state. Funkcije se ne mogu spremiti na ovaj način i uzrokuju DataCloneError. Obavezni parametar unused obično dobiva vrijednost ''; ne postavlja naslov stranice.
Neobavezni url može biti relativan; ako ga izostaviš, adresa ostaje nepromijenjena. Na stranicama HTTP(S) mora zadržati isto podrijetlo: shemu, host i priključak. Nedopušten URL, dokument koji nije potpuno aktivan ili prečesti pozivi mogu uzrokovati SecurityError.
Poziv ne pokreće ni popstate ni hashchange, čak ni kad se fragment promijeni. Sučelje ažuriraj samostalno; za kretanje Natrag/Naprijed obradi popstate i event.state. Primjer pokazuje da naknadna promjena ulaznog objekta ne mijenja spremljeno stanje.
Primjeri
(() => {
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}Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.