CKTIS / JavaScript
Udalosti DOMContentLoaded, pagehide a resize
Vyberte udalosť podľa účelu: `DOMContentLoaded` pre pripravený DOM, `pagehide` pri opustení stránky a `resize` pri zmene veľkosti zobrazovacej oblasti.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide a resize patria do webovej platformy, nie do ECMAScriptu 2024. Poslucháče registrujte pomocou addEventListener(): prvý na document, ďalšie dva na window. Dostupnosť závisí od prostredia; nepredpokladajte, že worker alebo Node.js poskytuje tieto ciele udalostí prehliadača.
DOMContentLoaded je nezrušiteľná udalosť typu Event, ktorá prebubláva z document. Prehliadač ju vyvolá po spracovaní HTML, vykonaní klasických skriptov s defer a začatí vyhodnocovania modulových skriptov naplánovaných na čas po parsovaní (bez async). Nečaká na dokončenie asynchrónneho vyhodnocovania modulov: modul môže byť stále pozastavený na await na najvyššej úrovni alebo spustenie jeho tela môže stále čakať na asynchrónnu závislosť. Na rozdiel od load nečaká priamo na obrázky, rámce ani skripty async. Ak potrebujete len DOM po spracovaní HTML, pri document.readyState === "loading" zaregistrujte poslucháča s { once: true }; inak inicializujte hneď. "interactive" nedokazuje, že udalosť už nastala ani že odložené skripty pripravili stav, od ktorého závisí váš kód.
pagehide je udalosť typu PageTransitionEvent, ktorú sledujete na window pri opustení stránky, nie pri obyčajnom prepnutí karty. event.persisted === true znamená, že stránka môže zostať vo vyrovnávacej pamäti pre navigáciu späť/vpred (bfcache); false znamená, že tento dokument sa takto neobnoví. true nezaručuje návrat: skutočné obnovenie spoznáte podľa pageshow s persisted === true, bez nového DOMContentLoaded. preventDefault() navigáciu nezastaví. pagehide nemusí nastať, najmä na mobilných zariadeniach, preto ukladajte dôležité údaje skôr. Prechod na pozadie zistíte pomocou visibilitychange a kontrolou document.visibilityState === "hidden".
resize na window je nezrušiteľná udalosť typu Event, ktorá neprebubláva. Oznamuje zmenu veľkosti zobrazovacej oblasti, nie ľubovoľného prvku. Aktuálne rozmery čítajte z window.innerWidth a window.innerHeight; na sledovanie veľkosti prvku použite ResizeObserver. Zmeny môžu prichádzať tesne po sebe, preto obmedzte frekvenciu náročných výpočtov rozloženia.
Príklady
(() => {
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();
}
})();Výsledok
DOMContentLoaded pagehide: persisted=true resize
Spustite kód v konzole prehliadača na novej karte `about:blank`, alebo ho uložte ako `main.js` a spustite `node main.js` v Node.js 24. V Node.js príklad používa samostatné inštancie `EventTarget` namiesto `document` a `window`. Syntetické udalosti overia pripojenie poslucháčov; nemenia stav pripravenosti dokumentu ani veľkosť zobrazovacej oblasti, nespôsobia navigáciu a netestujú bfcache. `abort()` odstráni všetky tri poslucháče.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Pokročilá · Verzia: 4