BeforeUnloadEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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 Compatibilité des navigateurs pour plus d'informations.

must be a string

Bouillonne No
Annulable Yes
Cibles defaultView
Interface Event

Exemples

js
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 :

js
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

Specification
HTML Standard
# the-beforeunloadevent-interface

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi