CKTIS / HTML
onbeforeunload — gestionar un evento antes de salir de una página
El atributo onbeforeunload de body establece un controlador para el evento beforeunload del objeto Window. Puede solicitar una advertencia antes de salir de la página, pero no garantiza que se muestre un diálogo ni que se cancele la navegación.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onbeforeunload="event.preventDefault()">onbeforeunload es un atributo de controlador de eventos en body. Su valor es código JavaScript, no un nombre de evento ni un valor booleano. Gestiona el evento beforeunload del objeto Window, no un evento dirigido al propio body. La propiedad JavaScript correspondiente es window.onbeforeunload.
Al abandonar realmente una página, el controlador puede llamar a event.preventDefault() para solicitar confirmación. Un mecanismo heredado consiste en establecer event.returnValue en una cadena no vacía. Una regla especial de onbeforeunload también permite devolver un valor distinto de null y undefined para cancelar el evento; no traslades aquí el patrón habitual return false. El valor devuelto por una función pasada a addEventListener() no funciona de esta manera.
Cancelar el evento no garantiza que se detenga la navegación: el navegador decide si muestra una confirmación, y el usuario puede elegir salir. El diálogo requiere una activación previa del usuario y el navegador puede suprimirlo por sus restricciones. No se puede establecer un texto de advertencia personalizado. Activa el controlador solo cuando haya cambios sin guardar y quítalo después de guardar; no lo consideres un mecanismo garantizado para guardar datos.
El ejemplo envía a window un evento sintético y cancelable y comprueba event.defaultPrevented. El resultado esperado es true. No prueba una navegación real ni un diálogo; después elimina el atributo para que no quede ningún controlador activo.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>onbeforeunload wiring test</title>
</head>
<body onbeforeunload="event.preventDefault()">
<p>See the browser console.</p>
<script>
const event = new Event('beforeunload', { cancelable: true });
window.dispatchEvent(event);
console.log(event.defaultPrevented);
document.body.removeAttribute('onbeforeunload');
</script>
</body>
</html>Resultado
true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.