CKTIS / HTML
onbeforeunload — gérer un événement avant de quitter une page
L’attribut onbeforeunload sur body définit un gestionnaire pour l’événement beforeunload de l’objet Window. Il peut demander un avertissement avant de quitter la page, mais ne garantit ni l’affichage d’une boîte de dialogue ni l’annulation de la navigation.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<body onbeforeunload="event.preventDefault()">onbeforeunload est un attribut de gestionnaire d’événement sur body. Sa valeur est du code JavaScript, pas un nom d’événement ni une valeur booléenne. Il gère l’événement beforeunload de l’objet Window, et non un événement ciblant body lui-même. La propriété JavaScript correspondante est window.onbeforeunload.
Lors d’un véritable départ de la page, le gestionnaire peut appeler event.preventDefault() pour demander une confirmation. Un mécanisme historique consiste à définir event.returnValue sur une chaîne non vide. Une règle spéciale à onbeforeunload permet aussi de renvoyer une valeur autre que null et undefined pour annuler l’événement ; ne transposez pas ici le modèle habituel return false. La valeur de retour d’une fonction passée à addEventListener() ne fonctionne pas ainsi.
L’annulation de l’événement ne garantit pas l’arrêt de la navigation : le navigateur décide s’il affiche une confirmation, et l’utilisateur peut choisir de partir. Une boîte de dialogue nécessite une activation préalable de l’utilisateur et peut être supprimée en raison des restrictions du navigateur. Il est impossible de définir un texte d’avertissement personnalisé. N’activez le gestionnaire qu’en cas de modifications non enregistrées et supprimez-le après l’enregistrement ; ne le considérez pas comme un mécanisme garanti de sauvegarde des données.
L’exemple déclenche sur window un événement synthétique et annulable, puis vérifie event.defaultPrevented. Le résultat attendu est true. Il ne teste ni une navigation réelle ni une boîte de dialogue ; il supprime ensuite l’attribut afin qu’aucun gestionnaire actif ne subsiste.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onbeforeunload wiring test</title>
</head>
<body onbeforeunload="event.preventDefault()">
<p>See the browser console.</p>
<script>
const event = new Event('beforeunload', { cancelable: true });
window.dispatchEvent(event);
console.log(event.defaultPrevented);
document.body.removeAttribute('onbeforeunload');
</script>
</body>
</html>Résultat
true
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.