Événement onbeforeunload

Définition et utilisation

L'événement onbeforeunload se produit lorsque le document est en train d'être déchargé.

Cet événement vous permet d'afficher un message dans la boîte de confirmation pour informer l'utilisateur s'il doit rester ou quitter la page actuelle.

Le message par défaut qui apparaît dans la boîte de confirmation peut varier d'un navigateur à l'autre. Cependant, le message standard est similaire à «Voulez-vous vraiment quitter cette page?» Ce message ne peut pas être supprimé.

Mais vous pouvez écrire le message personnalisé avec le message par défaut. Voir le premier exemple sur cette page. Commentaires : cela ne s'applique qu'à Internet Explorer.

Commentaires :Si l'événement onbeforeunload n'est pas assigné à l'élément <body>, il doit être assigné/ajouté à l'objet window et l'attribut returnValue doit être utilisé pour créer un message personnalisé (voir l'exemple de syntaxe ci-dessous).

Exemple

Exécuter JavaScript lors du chargement de la page :

<body onbeforeunload="return myFunction()">

Essayez-le vous-même

Syntaxe

Dans HTML :

<élément onbeforeunload="myScript">

Essayez-le vous-même

En JavaScript :

objet.onbeforeunload = function(){myScript};

Essayez-le vous-même

En JavaScript, utilisez la méthode addEventListener() :

objet.addEventListener("beforeunload", myScript);

Essayez-le vous-même

Commentaires :Internet Explorer 8 ou versions antérieures ne prennent pas en charge Méthode addEventListener()

Détails techniques

Bubbling : Non pris en charge
Annulable : Support
Type d'événement : Si généré depuis l'interface utilisateur,UiÉvénementSinon Événement
Balises HTML prises en charge : <body>
Version DOM : Événements de niveau 2

Support du navigateur

Les numéros dans le tableau indiquent la version du navigateur qui prend en charge entièrement cet événement.

Événement Chrome IE Firefox Safari Opera
onbeforeunload Support Support Support Support 15.0