BeforeUnloadEvent

L'évènement beforeunload est déclenché quand la fenêtre, le document et ses ressources sont sur le point d'être déchargées.

Si une chaine non vide est assignée à la propriété returnValue de l'évènement, une boite de confirmation apparait pour demander à l'utilisateur de valider le changement d'adresse (voir les exemples ci-dessous). Si aucune valeur n'est fournise, l'évènement est traité silencieusement. Certaines implantations ne demandent confirmation que si le cadre ou tout cadre embarqué reçoit une action utilisateur. Voir Browser compatibility pour plus d'informations.

Bouillonne No
Annulable Yes
Cibles defaultView
Interface Event

Exemples

window.addEventListener("beforeunload", function(event) {
  event.returnValue = "\o/";
});

// est équivalent à
window.addEventListener("beforeunload", function(event) {
  event.preventDefault();
});

Les navigateurs basés sur WebKit ne suivent pas la spécification concernant la demande de confirmation. Un exemple similaire fonctionnant sur presque tous les navigateurs serait plutôt comme :

window.addEventListener("beforeunload", function (e) {
  var confirmationMessage = "\o/";

  (e || window.event).returnValue = confirmationMessage;     // Gecko + IE
  return confirmationMessage;                                /* Safari, Chrome, and other
                                                              * WebKit-derived browsers */
});

Spécifications

Spécification État Commentaire
HTML Living Standard
La définition de 'BeforeUnloadEvent' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi