Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti