Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Dogodki DOMContentLoaded, pagehide in resize

Izberi dogodek glede na namen: `DOMContentLoaded`, ko je DOM pripravljen, `pagehide` ob zapustitvi strani in `resize` ob spremembi velikosti prikaznega območja.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);

DOMContentLoaded, pagehide in resize so dogodki spletne platforme, ne del ECMAScripta 2024. Poslušalce registriraj z addEventListener(): prvega na document, druga dva na window. Razpoložljivost je odvisna od izvajalnega okolja. Ne predpostavljaj, da worker ali Node.js ponuja te brskalniške cilje dogodkov.

DOMContentLoaded je dogodek tipa Event, ki ga ni mogoče preklicati in se iz document širi navzgor. Brskalnik ga sproži, ko razčleni HTML, izvede klasične skripte z defer in začne vrednotiti modulske skripte, predvidene za izvajanje po razčlenjevanju (brez async). Ne čaka na konec asinhronega vrednotenja modulov: modul je lahko še vedno začasno ustavljen pri await na vrhnji ravni ali pa izvajanje njegovega telesa še čaka na asinhrono odvisnost. Za razliko od load ne čaka neposredno na slike, okvirje ali skripte async. Če potrebuješ le DOM po razčlenitvi HTML-ja, pri document.readyState === "loading" registriraj poslušalca z { once: true }; sicer izvedi inicializacijo takoj. "interactive" ne dokazuje, da se je dogodek že sprožil ali da so odložene skripte pripravile stanje, od katerega je odvisna tvoja koda.

pagehide je PageTransitionEvent, ki ga poslušaš na window ob zapustitvi strani, ne že ob preklopu zavihka. event.persisted === true pomeni, da se stran lahko ohrani v predpomnilniku za pomikanje nazaj in naprej (bfcache); false pomeni, da dokument ne bo obnovljen na ta način. true ne zagotavlja vrnitve: dejansko obnovitev zaznaš z pageshow in persisted === true, brez novega DOMContentLoaded. preventDefault() ne ustavi navigacije. pagehide se včasih ne sproži, zlasti v mobilnih napravah, zato pomembne podatke shrani prej. Prehod v ozadje zaznaj z visibilitychange in preverjanjem document.visibilityState === "hidden".

resize na window je dogodek tipa Event, ki ga ni mogoče preklicati in se ne širi navzgor. Sporoča spremembo velikosti prikaznega območja, ne poljubnega elementa. Trenutne mere preberi iz window.innerWidth in window.innerHeight; velikost elementa spremljaj z ResizeObserver. Spremembe si lahko hitro sledijo, zato omeji pogostost zahtevnih izračunov postavitve.

Primeri

(() => {
  const documentTarget = globalThis.document ?? new EventTarget();
  const windowTarget = globalThis.window ?? new EventTarget();
  const controller = new AbortController();
  const options = { signal: controller.signal };

  documentTarget.addEventListener("DOMContentLoaded", (event) => {
    console.log(event.type);
  }, options);
  windowTarget.addEventListener("pagehide", (event) => {
    console.log(`${event.type}: persisted=${event.persisted}`);
  }, options);
  windowTarget.addEventListener("resize", (event) => {
    console.log(event.type);
  }, options);

  try {
    documentTarget.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
    const pagehide = typeof PageTransitionEvent === "function"
      ? new PageTransitionEvent("pagehide", { persisted: true })
      : Object.assign(new Event("pagehide"), { persisted: true });
    windowTarget.dispatchEvent(pagehide);
    windowTarget.dispatchEvent(new Event("resize"));
  } finally {
    controller.abort();
  }
})();

Rezultat

DOMContentLoaded
pagehide: persisted=true
resize

Zaženi kodo v konzoli brskalnika na novem zavihku `about:blank` ali pa jo shrani kot `main.js` in v okolju Node.js 24 zaženi `node main.js`. V okolju Node.js primer namesto `document` in `window` uporablja samostojne primerke `EventTarget`. Sintetični dogodki preverijo povezavo s poslušalci; ne spremenijo stanja pripravljenosti dokumenta ali velikosti prikaznega območja, ne sprožijo navigacije in ne preizkusijo bfcache. `abort()` odstrani vse tri poslušalce.

Povezane lekcije

  • JavaScript · Lekcija 34 · Napredna · Različica: 4

Viri