Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori