Window.onbeforeunload

Introducción

Evento que se ejecuta antes de abandonar la página, justo antes de que se ejecute window.onunload. 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 bug 588292).

Ejemplo

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

Notas

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 (más información en los enlaces).

Compatibilidad con los navegadores

Especificación

Este evento fue introducido originalmente por Microsoft en Internet Explorer 4 y estandarizado en la especificación HTML5.

• Especificación HTML5: <em>Browsing the Web, Unloading documents</em>LC (en inglés)

Ver también

• MSDN: evento onbeforeunload (en inglés)