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).

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

Compatibilidad con los navegadores

No compatibility data found for api.WindowEventHandlers.onbeforeunload.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

Especificaciones

{{Specifications}}

Ver también