Page: DOMContentLoaded, load, beforeunload, unload


Le cycle de vie d’une page HTML comporte trois événements importants:

  1. DOMContentLoaded – le navigateur a complètement chargé le HTML et l’arborescence DOM est construite, mais les ressources externes telles que les images <img> et les feuilles de style peuvent ne pas être encore chargées.
  2. load – non seulement le HTML est chargé, mais également toutes les ressources externes : images, styles, etc.
  3. beforeunload / unload – l’utilisateur quitte la page.

Chaque événement peut être utile:

Explorons les détails de ces événements.

DOMContentLoaded

L’événement DOMContentLoaded se produit sur l’objet document.
Nous devons utiliser addEventListener pour l’attraper:

Exemple

Demo

Dans l’exemple, le gestionnaire DOMContentLoaded s’exécute lorsque le document est chargé, afin qu’il puisse voir tous les éléments, y compris <img> dessous. Mais il n’attend pas que l’image se charge. Ainsi, alert n’affiche aucune taille.

À première vue, l’événement DOMContentLoaded est très simple. L’arbre DOM est prêt – voici l’événement. Il y a cependant quelques particularités.

DOMContentLoaded et les scripts

Lorsque le navigateur traite un document HTML et rencontre une balise <script>, il doit exécuter le script avant de continuer à construire le DOM. C’est une précaution, car les scripts peuvent vouloir modifier DOM, avec document.write par exemple, donc DOMContentLoaded doit attendre.

Donc DOMContentLoaded se produit définitivement après de tels scripts:

Demo

Dans l’exemple ci-dessus, nous voyons d’abord “Library loaded…”, puis “DOM ready!” (tous les scripts sont exécutés).

Les scripts qui ne bloquent pas DOMContentLoaded

Il existe deux exceptions à cette règle:
*. Les scripts avec l’attribut async, que nous aborderons un peu plus tard, ne bloquent pas DOMContentLoaded.
*. Les scripts qui sont générés dynamiquement avec document.createElement('script') puis ajoutés à la page Web ne bloquent pas non plus cet événement.

DOMContentLoaded et les styles

Les feuilles de style externes n’affectent pas le DOM, donc DOMContentLoaded ne les attend pas. Mais il y a une embûche. Si nous avons un script après le style, ce script doit attendre que la feuille de style se charge:

La raison en est que le script peut souhaiter obtenir des coordonnées et d’autres propriétés d’éléments dépendant du style, comme dans l’exemple ci-dessus. Naturellement, il doit attendre le chargement des styles. Comme DOMContentLoaded attend les scripts, il attend maintenant les styles avant eux également.

Saisie automatique intégrée du navigateur

Firefox, Chrome et Opera remplissent automatiquement les formulairs sur DOMContentLoaded.

Par exemple, si la page a un formulaire avec login et mot de passe, et que le navigateur se souvient des valeurs, alors sur DOMContentLoaded, il peut essayer de les remplir automatiquement (si approuvé par l’utilisateur).

Donc, si DOMContentLoaded est reporté par des scripts à chargement long, le remplissage automatique attend également. Vous l’avez probablement vu sur certains sites (si vous utilisez le remplissage automatique du navigateur) – les champs de login/mot de passe ne sont pas remplis automatiquement immédiatement, mais il y a un délai jusqu’à ce que la page se charge complètement. C’est en fait le délai jusqu’à l’événement DOMContentLoaded.

window.onload

L’événement load sur l’objet window se déclenche lorsque la page entière est chargée, y compris les styles, images et autres ressources. Cet événement est disponible via la propriété onload.

L’exemple ci-dessous montre correctement les tailles d’image, car window.onload attend toutes les images:

Demo

window.onunload

Lorsqu’un visiteur quitte la page, l’événement unload se déclenche sur window. Nous pouvons y faire quelque chose qui n’implique pas de retard, comme la fermeture des fenêtres contextuelles associées.
L’exception notable est l’envoi d’analyses.
Imaginons que nous recueillons des données sur la façon dont la page est utilisée: clics de souris, défilements, zones de page visualisées, etc.
Naturellement, l’événement unload est lorsque l’utilisateur nous quitte, et nous aimerions sauvegarder les données sur notre serveur.
Il existe une méthode spéciale navigator.sendBeacon(url, data) pour de tels besoins, décrite dans la spécification https://w3c.github.io/beacon/.
Il envoie les données en arrière-plan. La transition vers une autre page n’est pas retardée: le navigateur quitte la page, mais exécute toujours sendBeacon.

Voici comment l’utiliser:

Lorsque la demande sendBeacon est terminée, le navigateur a probablement déjà quitté le document, donc il n’y a aucun moyen d’obtenir une réponse du serveur (qui est vide habituellement pour l’analyse).
Si nous voulons annuler la transition vers une autre page, nous ne pouvons pas le faire ici. Mais nous pouvons utiliser un autre événement – onbeforeunload.

window.onbeforeunload

Si un visiteur a lancé la navigation hors de la page ou tente de fermer la fenêtre, le gestionnaire beforeunload demande une confirmation supplémentaire.
Si nous annulons l’événement, le navigateur peut demander au visiteur s’il en est sûr.
Vous pouvez l’essayer en exécutant ce code, puis en rechargeant la page:

Demo

Il n’y a aucun moyen de personnaliser le message affiché à l’utilisateur

readyState

Que se passe-t-il si nous définissons le gestionnaire DOMContentLoaded après le chargement du document?

Naturellement, il ne fonctionne jamais.
Il y a des cas où nous ne savons pas si le document est prêt ou non. Nous aimerions que notre fonction s’exécute lorsque le DOM est chargé, que ce soit maintenant ou plus tard.
La propriété document.readyState nous renseigne sur l’état de chargement actuel.
Il y a 3 valeurs possibles:

  1. "loading" – le document est en cours de chargement.
  2. "interactive" – le document a été entièrement lu.
  3. "complete" – le document a été entièrement lu et toutes les ressources (comme les images) sont également chargées.

Nous pouvons donc vérifier document.readyState et configurer un gestionnaire ou exécuter le code immédiatement s’il est prêt.

Comme ceci:

Il y a aussi l’événement readystatechange qui se déclenche lorsque l’état change, nous pouvons donc afficher tous ces états comme ceci:

L’événement readystatechange est un mécanisme alternatif de suivi de l’état de chargement du document, il est apparu il y a longtemps. De nos jours, il est rarement utilisé.
Voyons le flux complet des événements pour l’exhaustivité.
Voici un document avec <iframe>, <img> et des gestionnaires qui consignent les événements:

Demo

La sortie typique:

[1] readyState:loading initiale
[2] readyState:interactive
[2] DOMContentLoaded
[3] iframe onload
[4] img onload
[4] readyState:complete
[4] window onload

Les nombres entre crochets indiquent l'ordre d'exécution.
Les événements étiquetés avec le même chiffre se produisent à peu près au même moment (± quelques ms).

document.readyState devient interactive juste avant DOMContentLoaded. Ces deux choses signifient en fait la même chose.
document.readyState devient complete lorsque toutes les ressources (iframe et img) sont chargées.

Ici, nous pouvons voir que cela se produit à peu près en même temps que img.onload (img est la dernière ressource) et window.onload. Passer à l’état complete signifie la même chose que window.onload. La différence est que window.onload fonctionne toujours après tous les autres gestionnaires de load.

Résumé

Événements de chargement de page: