Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Événements DOMContentLoaded, pagehide et resize

Choisissez le bon événement : `DOMContentLoaded` pour un DOM prêt, `pagehide` lorsque l’on quitte la page et `resize` quand la zone d’affichage change de taille.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);

DOMContentLoaded, pagehide et resize relèvent de la plateforme web, pas d’ECMAScript 2024. Enregistrez les écouteurs avec addEventListener() : sur document pour le premier, sur window pour les deux autres. Leur disponibilité dépend de l’environnement d’exécution ; ne supposez pas qu’un worker ou Node.js fournit ces cibles d’événements du navigateur.

DOMContentLoaded est un Event non annulable qui remonte depuis document. Le navigateur le déclenche après avoir analysé le HTML, exécuté les scripts classiques avec defer et lancé l’évaluation des scripts de module prévus après l’analyse (sans async). Il n’attend pas la fin de l’évaluation asynchrone des modules : un module peut encore être suspendu sur un await au niveau supérieur, ou l’exécution de son corps peut encore être en attente d’une dépendance asynchrone. Contrairement à load, il n’attend pas directement les images, les cadres ni les scripts async. Si seul le DOM analysé vous intéresse, ajoutez un écouteur avec { once: true } lorsque document.readyState === "loading" ; sinon, initialisez immédiatement. "interactive" ne prouve ni que l’événement a déjà eu lieu ni que les scripts différés ont préparé l’état dont votre code dépend.

pagehide est un PageTransitionEvent à écouter sur window lorsque l’on quitte la page, et non lors d’un simple changement d’onglet. Avec event.persisted === true, la page peut être conservée dans le cache de navigation arrière/avant (bfcache) ; avec false, ce document ne sera pas restauré par ce moyen. true ne garantit pas le retour : une restauration effective se détecte avec pageshow et persisted === true, sans nouveau DOMContentLoaded. preventDefault() ne bloque pas la navigation. pagehide peut ne pas se déclencher, surtout sur mobile : enregistrez les données importantes plus tôt. Pour détecter le passage en arrière-plan, utilisez visibilitychange et vérifiez document.visibilityState === "hidden".

Sur window, resize est un Event non annulable qui ne remonte pas. Il signale un changement de taille de la zone d’affichage, pas d’un élément quelconque. Lisez les dimensions actuelles dans window.innerWidth et window.innerHeight ; pour surveiller la taille d’un élément, utilisez ResizeObserver. Les changements peuvent se succéder rapidement : limitez la fréquence des calculs de mise en page coûteux.

Exemples

(() => {
  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();
  }
})();

Résultat

DOMContentLoaded
pagehide: persisted=true
resize

Exécutez le code dans la console du navigateur, dans un nouvel onglet `about:blank`, ou enregistrez-le sous `main.js` et lancez `node main.js` avec Node.js 24. Dans Node.js, l’exemple utilise des instances autonomes d’`EventTarget` à la place de `document` et `window`. Les événements synthétiques vérifient le raccordement des écouteurs ; ils ne modifient ni l’état de préparation du document ni la taille de la zone d’affichage, ne déclenchent pas de navigation et ne testent pas le bfcache. `abort()` retire les trois écouteurs.

Leçons associées

  • JavaScript · Leçon 34 · Avancé · Version : 4

Sources