CKTIS / JavaScript
Događaji DOMContentLoaded i pagehide
Koristi `DOMContentLoaded` za inicijalizaciju koda nakon izgradnje DOM-a, a `pagehide` za privremenu obustavu rada pri napuštanju dokumenta. Vraćanje iz bfcachea nije novo učitavanje.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded je događaj tipa Event koji se aktivira na objektu document nakon što preglednik dovrši raščlambu HTML-a, izvrši klasične skripte s defer i započne evaluaciju modulskih skripti bez async predviđenih za kraj raščlambe. Događaj ne čeka dovršetak evaluacije modula: ako se izvršavanje modula koji se uvozi zaustavi na izrazu await na najvišoj razini, događaj se može aktivirati prije nego što se tijelo modula koji ga uvozi uopće počne izvršavati. Ne čeka slike, okvire ni dovršetak skripti async. Stilske ga tablice mogu posredno odgoditi ako blokiraju izvršavanje skripti. Upotrijebi load na objektu window ako trebaš pričekati resurse koji odgađaju učitavanje stranice.
Ako se inicijalizacijski kôd može pokrenuti kasno, provjeri document.readyState: pri vrijednosti "loading" registriraj jednokratni slušatelj za DOMContentLoaded, a inače koristi već dostupan DOM. "interactive" znači da je raščlamba gotova, ne da je događaj nužno već aktiviran ili da su druge skripte dovršile inicijalizaciju. Ako ovisiš o njima, izričito odredi redoslijed inicijalizacije.
Slušaj pagehide na objektu window pri napuštanju dokumenta, primjerice pri povratku na prethodnu stranicu. Taj PageTransitionEvent ne označava običnu promjenu kartice i ne može otkazati navigaciju. event.persisted === true znači da se dokument možda zadržava u predmemoriji za navigaciju natrag i naprijed (bfcache), a ne da je njegovo vraćanje zajamčeno. false znači da se dokument pri toj navigaciji ne zadržava. Obustavi rad na pagehide i nastavi ga na pageshow uz persisted === true: vraćeni dokument zadržava svoj DOM i ne pokreće DOMContentLoaded ponovno.
Važne podatke spremaj tijekom rada. pagehide se možda neće aktivirati, osobito pri prisilnom zatvaranju mobilnog preglednika, a asinkroni rad pokrenut u tom trenutku možda neće završiti. Za reakciju na skrivanje stranice slušaj visibilitychange na objektu document i provjeri stanje "hidden". To su API-ji web-platforme, a ne značajke uvedene u ECMAScriptu 2024.
Primjeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMContentLoaded and pagehide</title>
<script>
(() => {
const init = () => console.log("DOM ready");
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
window.addEventListener("pagehide", (event) => {
console.log(`pagehide persisted=${event.persisted}`);
});
window.addEventListener("pageshow", (event) => {
if (event.persisted) console.log("pageshow restored");
});
})();
</script>
</head>
<body>
<p>Open the browser console to see the event log.</p>
</body>
</html>Rezultat
DOM ready
Spremi primjer kao HTML datoteku i otvori je u pregledniku. U konzoli uključi zadržavanje zapisa i ponovno učitaj stranicu. `DOM ready` pojavljuje se kad se aktivira `DOMContentLoaded`. Kasnije poruke ovise o navigaciji i o tome hoće li preglednik zadržati dokument.
Povezane lekcije
- JavaScript · Lekcija 40 · Napredno · Verzija: 4
- JavaScript · Lekcija 41 · Napredno · Verzija: 4