CKTIS / JavaScript
Eventi DOMContentLoaded e pagehide
Usa `DOMContentLoaded` per inizializzare il codice quando il DOM è pronto e `pagehide` per sospendere le attività quando lasci il documento. Un ripristino dalla bfcache non è un nuovo caricamento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded è un Event emesso su document dopo che il browser ha completato l’analisi dell’HTML, eseguito gli script classici con defer e avviato la valutazione degli script di tipo modulo senza async previsti per la fine dell’analisi. L’evento non attende il completamento della valutazione dei moduli: se l’esecuzione di una dipendenza si sospende a un await al livello più esterno, l’evento può verificarsi prima ancora che inizi l’esecuzione del corpo del modulo che la importa. Non attende immagini, frame o il completamento degli script async. I fogli di stile possono ritardarlo indirettamente bloccando l’esecuzione degli script. Usa load su window se devi attendere le risorse che ritardano il caricamento della pagina.
Se l’inizializzazione può partire in ritardo, controlla document.readyState: con "loading", registra un listener monouso per DOMContentLoaded; altrimenti usa il DOM già disponibile. "interactive" indica che l’analisi è terminata, non che l’evento sia già stato emesso o che gli altri script abbiano finito di inizializzarsi. Se dipendi da questi script, stabilisci esplicitamente l’ordine di inizializzazione.
Ascolta pagehide su window quando il browser lascia il documento, per esempio con il pulsante Indietro. Questo PageTransitionEvent non segnala un semplice cambio di scheda e non consente di annullare la navigazione. event.persisted === true significa che il documento può essere conservato nella cache di navigazione indietro/avanti (bfcache), non che il ripristino sia garantito. false significa che il documento non viene conservato per quella navigazione. Sospendi le attività su pagehide e riprendile su pageshow se persisted === true: il documento ripristinato mantiene il proprio DOM e non emette di nuovo DOMContentLoaded.
Salva man mano i dati importanti. pagehide può non verificarsi, soprattutto in caso di chiusura forzata di un browser mobile, e le operazioni asincrone avviate in quel momento potrebbero non terminare. Per reagire quando la pagina diventa nascosta, ascolta visibilitychange su document e controlla lo stato "hidden". Sono API della piattaforma web, non funzionalità aggiunte in ECMAScript 2024.
Esempi
<!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>Risultato
DOM ready
Salva l’esempio come file HTML e aprilo in un browser. Attiva l’opzione per conservare il log della console e ricarica la pagina. `DOM ready` compare quando viene emesso `DOMContentLoaded`. I messaggi successivi dipendono dalla navigazione e dal fatto che il browser conservi o meno il documento.
Lezioni correlate
- JavaScript · Lezione 40 · Avanzato · Versione: 4
- JavaScript · Lezione 41 · Avanzato · Versione: 4