CKTIS / JavaScript
Eventi DOMContentLoaded, pagehide e resize
Scegli l’evento adatto: `DOMContentLoaded` per il DOM pronto, `pagehide` quando si lascia la pagina e `resize` quando cambia la dimensione dell’area di visualizzazione.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide e resize appartengono alla piattaforma web, non a ECMAScript 2024. Registra i listener con addEventListener(): su document per il primo e su window per gli altri due. La disponibilità dipende dall’ambiente di esecuzione; non presumere che un worker o Node.js offra questi oggetti del browser come destinatari degli eventi.
DOMContentLoaded è un Event non annullabile che risale da document nella fase di bubbling. Il browser lo genera dopo aver analizzato l’HTML, eseguito gli script classici con defer e avviato la valutazione degli script di tipo modulo previsti dopo l’analisi (senza async). Non attende che la valutazione asincrona dei moduli termini: un modulo può essere ancora sospeso su un await al livello più esterno, oppure il suo corpo può non essere ancora stato eseguito perché attende una dipendenza asincrona. A differenza di load, non attende direttamente immagini, frame o script async. Se ti serve solo il DOM risultante dall’analisi, registra un listener con { once: true } quando document.readyState === "loading"; altrimenti inizializza subito. "interactive" non dimostra che l’evento sia già avvenuto né che gli script differiti abbiano preparato lo stato da cui dipende il tuo codice.
pagehide è un PageTransitionEvent da ascoltare su window quando si lascia la pagina, non quando si cambia semplicemente scheda. event.persisted === true indica che la pagina può essere conservata nella cache di navigazione avanti/indietro (bfcache); false indica che quel documento non sarà ripristinato così. true non garantisce il ritorno: rileva il ripristino effettivo con pageshow e persisted === true, senza un nuovo DOMContentLoaded. preventDefault() non blocca la navigazione. pagehide può non scattare, soprattutto su dispositivi mobili: salva prima i dati importanti. Per rilevare il passaggio in secondo piano, usa visibilitychange e controlla document.visibilityState === "hidden".
Il resize di window è un Event non annullabile che non risale nella fase di bubbling. Segnala variazioni di dimensione dell’area di visualizzazione, non di un elemento qualsiasi. Leggi le dimensioni correnti da window.innerWidth e window.innerHeight; per osservare le dimensioni di un elemento, usa ResizeObserver. Le variazioni possono susseguirsi rapidamente: limita la frequenza dei calcoli di layout più costosi.
Esempi
(() => {
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();
}
})();Risultato
DOMContentLoaded pagehide: persisted=true resize
Esegui il codice nella console del browser in una nuova scheda `about:blank`, oppure salvalo come `main.js` ed esegui `node main.js` con Node.js 24. In Node.js, l’esempio usa istanze autonome di `EventTarget` al posto di `document` e `window`. Gli eventi sintetici verificano il collegamento dei listener; non modificano lo stato di caricamento del documento o le dimensioni dell’area di visualizzazione, non avviano una navigazione e non mettono alla prova la bfcache. `abort()` rimuove tutti e tre i listener.
Lezioni correlate
- JavaScript · Lezione 34 · Avanzato · Versione: 4