CKTIS / JavaScript
Les événements DOMContentLoaded et pagehide
Utilisez `DOMContentLoaded` pour initialiser le code une fois le DOM construit, et `pagehide` pour suspendre le travail en quittant le document. Une restauration depuis le bfcache n’est pas un nouveau chargement.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded est un Event déclenché sur document lorsque le navigateur a fini d’analyser le HTML, exécuté les scripts classiques avec defer et lancé l’évaluation des scripts modules sans async prévus pour la fin de l’analyse. L’événement n’attend pas la fin de l’évaluation des modules : si l’exécution d’une dépendance est suspendue par un await de premier niveau, il peut se produire avant même que le corps du module qui l’importe commence à s’exécuter. Il n’attend ni les images, ni les cadres, ni la fin des scripts async. Les feuilles de style peuvent le retarder indirectement en bloquant l’exécution des scripts. Utilisez load sur window pour attendre les ressources qui retardent le chargement de la page.
Si l’initialisation peut démarrer tard, vérifiez document.readyState : tant qu’il vaut "loading", enregistrez un écouteur à usage unique pour DOMContentLoaded ; sinon, utilisez le DOM déjà disponible. "interactive" indique que l’analyse est terminée, mais pas que l’événement s’est déjà produit ni que les autres scripts ont fini leur initialisation. Si votre code en dépend, fixez explicitement l’ordre d’initialisation.
Écoutez pagehide sur window pour réagir au départ du document, par exemple lors d’un retour à la page précédente. Ce PageTransitionEvent ne signale pas un simple changement d’onglet et ne permet pas d’annuler la navigation. event.persisted === true indique que le document peut être conservé dans le cache de navigation arrière/avant (bfcache), sans garantie de restauration. false indique qu’il n’est pas conservé pour cette navigation. Suspendez le travail sur pagehide et reprenez-le sur pageshow si persisted === true : un document restauré garde son DOM et ne déclenche pas de nouveau DOMContentLoaded.
Enregistrez les données importantes au fil de l’eau : pagehide peut ne pas se produire, notamment lors de la fermeture forcée d’un navigateur mobile, et un traitement asynchrone lancé à ce moment peut rester inachevé. Pour réagir au masquage de la page, écoutez visibilitychange sur document et vérifiez l’état "hidden". Ces API relèvent de la plateforme web, pas d’ECMAScript 2024.
Exemples
<!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>Résultat
DOM ready
Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Activez la conservation du journal dans la console et rechargez la page. `DOM ready` s’affiche lorsque `DOMContentLoaded` se déclenche. Les messages suivants dépendent de la navigation et de la conservation du document par le navigateur.
Leçons associées
- JavaScript · Leçon 40 · Avancé · Version : 4
- JavaScript · Leçon 41 · Avancé · Version : 4