CKTIS / JavaScript
history.replaceState — posodobitev trenutnega vnosa v zgodovini
history.replaceState posodobi stanje in po želji URL trenutnega vnosa v zgodovini, ne da bi znova naložil stran. Vnosa ne doda, zato ne ustvari dodatnega koraka za gumb Nazaj.
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.replaceState(data, unused)
history.replaceState(data, unused, url)history.replaceState(data, unused, url) zamenja stanje trenutnega vnosa; history.pushState doda vnos. To je API brskalnika, določen s standardom HTML, in ne funkcija določene izdaje ECMAScript. Prisotnost Node 24 ne dokazuje, da je API na voljo v brskalniku.
Kot obvezni zgodovinski argument unused podaj ""; ne nastavi naslova. Če url izpustiš, se naslov ohrani. Metoda vrne undefined. Dokumenta ne naloži znova in sama ne sproži dogodkov popstate ali hashchange.
data se za shranjevanje strukturirano klonira, ne serializira v JSON. Shranjeno vrednost preberi prek history.state; poznejša sprememba vhodnega objekta shranjene vrednosti ne spremeni. Funkcij in vozlišč DOM ni mogoče shraniti na ta način in povzročijo DataCloneError.
Pravila za prepisovanje URL-ja primerjajo predlagani URL s trenutnim URL-jem dokumenta, ne z njegovim izvorom (origin). Dokument na naslovu about:blank lahko na primer spremeni fragment svojega URL-ja, tudi če podeduje svoj izvor. Nedovoljen URL, dokument, ki ni v celoti aktiven, ali omejitve pogostosti klicev lahko povzročijo SecurityError. To metodo uporabi za popravek trenutnega prikaza, ne za ustvarjanje novega koraka navigacije.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.