CKTIS / HTML
onunload — gérer le déchargement d’un document
L’attribut onunload de l’élément body définit un gestionnaire pour l’événement unload de l’objet Window, et non un gestionnaire ciblant l’élément lui-même. Ce n’est ni un moyen fiable d’enregistrer des données ni une façon d’empêcher de quitter une page.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload est un attribut de contenu gestionnaire d’événement pour unload. Sur l’élément body, sa valeur contient du JavaScript exécuté comme gestionnaire sur l’objet Window associé. Ce n’est pas un attribut global ordinaire destiné à n’importe quel élément HTML.
Son équivalent JavaScript est window.onunload, auquel on peut affecter une fonction ou null. L’attribut body et cette propriété contrôlent le même gestionnaire : une nouvelle affectation remplace la précédente, et null le supprime. Dans le code de l’attribut, le paramètre event fournit l’événement.
unload concerne le déchargement d’un document, mais ne supposez pas qu’il se déclenche chaque fois qu’on quitte une page. L’algorithme de la norme l’ignore lorsque le document est conservé pour être restauré ultérieurement depuis l’historique. N’en faites pas le seul moyen d’enregistrer des données importantes et ne comptez pas sur l’achèvement d’un traitement asynchrone à ce moment-là. Pour observer le cycle de vie, envisagez pagehide ou visibilitychange, selon votre objectif.
Ne confondez pas onunload avec onbeforeunload : unload n’est pas annulable, et return false n’interrompt pas la navigation et n’affiche pas de demande de confirmation avant de quitter la page. L’exemple déclenche volontairement un événement synthétique pour montrer le lien entre l’attribut et Window sans fermer la page ; il ne reproduit pas le déchargement réel d’un document.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onunload demonstration</title>
<body onunload="document.getElementById('result').textContent = event.type">
<output id="result">pending</output>
<script>
window.dispatchEvent(new Event('unload'));
window.onunload = null;
</script>
</body>
</html>Résultat
unload
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.