Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

history.pushState() — záznam v histórii bez opätovného načítania

history.pushState() zvyčajne pridá záznam do histórie relácie, uloží stav a voliteľne zmení URL bez načítania nového dokumentu. Rozhranie treba aktualizovať samostatne.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

history.pushState(state, unused[, url]);

history.pushState() je API prehliadača definované štandardom HTML, nie ECMAScriptom; súčasné prehliadačové enginy ho podporujú. Dostupnosť Node 24 nedokazuje jeho dostupnosť. Metóda zvyčajne pridá záznam do histórie relácie, ale pri počiatočnom dokumente about:blank nahradí aktuálny záznam namiesto pridania nového. V oboch prípadoch vráti undefined bez načítania nového dokumentu. Na rozdiel od nej history.replaceState() aktualizuje aktuálny záznam a nový nepridáva.

state sa serializuje, neuchováva sa ako referencia; prečítať ho možno cez history.state. Funkcie sa takto ukladať nedajú a spôsobia DataCloneError. Povinný parameter unused zvyčajne dostáva hodnotu ''; nenastavuje názov stránky.

Voliteľná url môže byť relatívna; ak ju vynecháte, adresa zostane nezmenená. Na stránkach HTTP(S) musí zachovať rovnaký pôvod: schému, hostiteľa a port. Nepovolená URL, dokument, ktorý nie je úplne aktívny, alebo príliš časté volania môžu spôsobiť SecurityError.

Volanie nevyvolá popstate ani hashchange, a to ani pri zmene fragmentu. Rozhranie aktualizujte sami; pri navigácii Späť/Vpred spracujte popstate a event.state. Príklad ukazuje, že neskoršia zmena vstupného objektu uložený stav nezmení.

Príklady

(() => {
  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
  }));
})();

Výsledok

{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje