CKTIS / JavaScript
Događaji DOMContentLoaded, pagehide i resize
Odaberi događaj prema namjeni: `DOMContentLoaded` kad je DOM spreman, `pagehide` pri napuštanju stranice i `resize` pri promjeni veličine područja prikaza.
Verzija: 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 i resize pripadaju web-platformi, a ne ECMAScriptu 2024. Slušatelje registriraj pomoću addEventListener(): prvi na document, a druga dva na window. Dostupnost ovisi o izvršnom okruženju; ne pretpostavljaj da worker ili Node.js nudi te ciljne objekte događaja iz preglednika.
DOMContentLoaded je događaj tipa Event koji nije moguće otkazati i koji se širi prema gore iz document. Preglednik ga pokreće nakon što raščlani HTML, izvrši klasične skripte s defer i započne evaluaciju modulskih skripti predviđenih za izvođenje nakon raščlambe (bez async). Ne čeka završetak asinkrone evaluacije modula: modul može još biti zaustavljen na await na najvišoj razini ili izvođenje njegova tijela može još čekati asinkronu ovisnost. Za razliku od load, ne čeka izravno na slike, okvire ni skripte async. Ako ti treba samo DOM nakon raščlambe, pri document.readyState === "loading" registriraj slušatelja s { once: true }; inače odmah pokreni inicijalizaciju. "interactive" ne dokazuje da se događaj već dogodio ni da su odgođene skripte pripremile stanje o kojem tvoj kod ovisi.
pagehide je PageTransitionEvent koji slušaš na window pri napuštanju stranice, a ne pri pukom prebacivanju kartice. event.persisted === true znači da se stranica može zadržati u predmemoriji za kretanje natrag i naprijed (bfcache); false znači da se taj dokument neće tako vratiti. true ne jamči povratak: stvarno vraćanje prepoznaješ po pageshow uz persisted === true, bez novog DOMContentLoaded. preventDefault() ne zaustavlja navigaciju. pagehide može izostati, osobito na mobilnim uređajima, stoga važne podatke spremi ranije. Za otkrivanje prelaska u pozadinu upotrijebi visibilitychange i provjeri document.visibilityState === "hidden".
resize na window događaj je tipa Event koji se ne može otkazati i ne širi se prema gore. Označava promjenu veličine područja prikaza, ne proizvoljnog elementa. Trenutačne dimenzije očitaj iz window.innerWidth i window.innerHeight; za praćenje veličine elementa upotrijebi ResizeObserver. Promjene se mogu brzo nizati, pa ograniči učestalost zahtjevnih izračuna rasporeda.
Primjeri
(() => {
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
Pokreni kôd u konzoli preglednika na novoj kartici `about:blank` ili ga spremi kao `main.js` i pokreni `node main.js` u okruženju Node.js 24. U okruženju Node.js primjer upotrebljava samostalne instance `EventTarget` umjesto `document` i `window`. Sintetički događaji provjeravaju povezivanje slušatelja; ne mijenjaju stanje spremnosti dokumenta ni veličinu područja prikaza, ne pokreću navigaciju i ne testiraju bfcache. `abort()` uklanja sva tri slušatelja.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredno · Verzija: 4