Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori