Window.onbeforeunload

Introducción

Evento que se ejecuta antes de abandonar la página, justo antes de que se ejecute window.onunload (en-US). El documento aún está visible y el evento aún se puede cancelar.

Sintaxis

window.onbeforeunload = funcRef

funcRef es una referencia a una función o una función anónima.
La función debe asignar una cadena de texto como propiedad returnValue del objeto Event y devolver la misma cadena.
Nota: en Firefox 4 y superiores la cadena de texto no se muestra al usuario (ver Error 588292 en Firefox).

Ejemplo

window.onbeforeunload = function(e) {
  return 'Texto de aviso';
};

Cuando este evento devuelve un valor que no sea nulo, se solicita al usuario que confirme que quiere abandonar la página. En la mayoría de los navegadores, el valor de retorno del evento se muestra en este cuadro de diálogo.

Desde el 25 de mayo de 2011, los estados de la especificación HTML5 que llaman a los métodos window.showModalDialog(), window.alert(), window.confirm() y window.prompt() pueden ser ignorados en este evento.

Se puede y se debería controlar este evento con window.addEventListener() y el evento beforeunload (en-US) (más información en los enlaces).