CKTIS / JavaScript
history.replaceState — ažuriranje trenutačnog unosa povijesti
history.replaceState ažurira stanje i po želji URL trenutačnog unosa povijesti bez ponovnog učitavanja stranice. Ne dodaje unos pa ne stvara dodatni korak za gumb Natrag.
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.replaceState(data, unused)
history.replaceState(data, unused, url)history.replaceState(data, unused, url) zamjenjuje stanje trenutačnog unosa; history.pushState dodaje unos. To je API preglednika definiran standardom HTML, a ne značajka određenog izdanja ECMAScripta. Dostupnost Nodea 24 ne dokazuje da je API dostupan u pregledniku.
Kao obvezni povijesni argument unused proslijedi ""; on ne postavlja naslov. Ako izostaviš url, adresa ostaje nepromijenjena. Metoda vraća undefined. Ne učitava dokument ponovno i sama ne pokreće popstate ni hashchange.
data se za pohranu strukturirano klonira, a ne serijalizira kao JSON. Pohranjenu vrijednost pročitaj putem history.state; naknadna promjena ulaznog objekta ne mijenja pohranjenu vrijednost. Funkcije i DOM čvorovi ne mogu se pohraniti na ovaj način i uzrokuju DataCloneError.
Pravila za prepisivanje URL-a uspoređuju predloženi URL s trenutačnim URL-om dokumenta, a ne s njegovim ishodištem (origin). Primjerice, dokument na adresi about:blank može promijeniti fragment svojeg URL-a čak i ako nasljeđuje svoje ishodište. Nedopušten URL, dokument koji nije potpuno aktivan ili ograničenja učestalosti poziva mogu uzrokovati SecurityError. Ovu metodu upotrijebi za ispravak trenutačnog prikaza, a ne za stvaranje novog koraka navigacije.
Primjeri
(() => {
const previousState = history.state;
const previousURL = location.href;
const previousLength = history.length;
const data = { tab: "details" };
const url = new URL(location.href);
url.hash = "details";
try {
history.replaceState(data, "", url.href);
data.tab = "changed";
console.log(history.state.tab);
console.log(location.hash);
console.log(history.length === previousLength);
} finally {
history.replaceState(previousState, "", previousURL);
}
})();Rezultat
details #details true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.