CKTIS / JavaScript
Události DOMContentLoaded, pagehide a resize
Zvolte událost podle účelu: `DOMContentLoaded` pro připravený DOM, `pagehide` při opuštění stránky a `resize` při změně velikosti zobrazovací oblasti.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide a resize patří do webové platformy, nikoli do ECMAScriptu 2024. Posluchače registrujte pomocí addEventListener(): první na document, zbývající dva na window. Dostupnost závisí na prostředí; nepředpokládejte, že worker nebo Node.js poskytuje tyto cíle událostí prohlížeče.
DOMContentLoaded je nezrušitelná událost typu Event, která probublává z document. Prohlížeč ji vyvolá po zpracování HTML, provedení klasických skriptů s defer a zahájení vyhodnocování modulových skriptů určených ke spuštění po parsování (bez async). Nečeká na dokončení asynchronního vyhodnocování modulů: modul může být stále pozastavený na await na nejvyšší úrovni nebo spuštění jeho těla může stále čekat na asynchronní závislost. Na rozdíl od load nečeká přímo na obrázky, rámce ani skripty async. Pokud potřebujete jen DOM po zpracování HTML, při document.readyState === "loading" zaregistrujte posluchač s { once: true }; jinak inicializujte ihned. "interactive" nedokazuje, že už událost nastala ani že odložené skripty připravily stav, na kterém váš kód závisí.
pagehide je událost typu PageTransitionEvent, kterou sledujete na window při opuštění stránky, ne při pouhém přepnutí karty. event.persisted === true znamená, že stránka může zůstat v mezipaměti pro navigaci zpět/vpřed (bfcache); false znamená, že takto dokument obnoven nebude. true nezaručuje návrat: skutečné obnovení poznáte podle pageshow s persisted === true, bez nového DOMContentLoaded. preventDefault() navigaci nezastaví. pagehide nemusí nastat, zvlášť na mobilních zařízeních, proto ukládejte důležitá data dříve. Přechod na pozadí zjistíte pomocí visibilitychange a kontroly document.visibilityState === "hidden".
resize na window je nezrušitelná událost typu Event, která neprobublává. Oznamuje změnu velikosti zobrazovací oblasti, nikoli libovolného prvku. Aktuální rozměry čtěte z window.innerWidth a window.innerHeight; pro sledování velikosti prvku použijte ResizeObserver. Změny mohou přicházet rychle za sebou, proto omezte četnost náročných výpočtů rozvržení.
Pří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ýsledek
DOMContentLoaded pagehide: persisted=true resize
Spusťte kód v konzoli prohlížeče na nové kartě `about:blank`, nebo ho uložte jako `main.js` a spusťte `node main.js` v Node.js 24. V Node.js příklad používá samostatné instance `EventTarget` místo `document` a `window`. Syntetické události ověří připojení posluchačů; nemění stav připravenosti dokumentu ani velikost zobrazovací oblasti, nezpůsobí navigaci a netestují bfcache. `abort()` odstraní všechny tři posluchače.
Související lekce
- JavaScript · Lekce 34 · Pokročilá · Verze: 4