CKTIS / HTML
onunload — gestionar la descarga de un documento
El atributo onunload del elemento body establece un controlador para el evento unload del objeto Window, no un controlador dirigido al propio elemento. No es un lugar fiable para guardar datos ni una forma de impedir que se abandone una página.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload es un atributo de contenido de controlador de eventos para unload. En el elemento body, su valor contiene JavaScript que se ejecuta como controlador en el objeto Window asociado. No es un atributo global ordinario para cualquier elemento HTML.
Su equivalente en JavaScript es window.onunload, que acepta una función o null. El atributo body y esta propiedad controlan el mismo controlador: una asignación posterior sustituye el valor anterior y null lo elimina. En el código del atributo, el parámetro event proporciona el evento.
unload tiene que ver con la descarga de un documento, pero no des por hecho que se produce cada vez que se abandona una página. El algoritmo del estándar lo omite cuando el documento se conserva para restaurarlo más adelante desde el historial. No lo uses como único lugar para guardar datos importantes ni confíes en que allí termine el trabajo asíncrono. Para observar el ciclo de vida, considera pagehide o visibilitychange, según tu objetivo.
No confundas onunload con onbeforeunload: unload no se puede cancelar, y return false ni detiene la navegación ni muestra un aviso para confirmar que se abandona la página. El ejemplo despacha deliberadamente un evento sintético para mostrar la conexión del atributo con Window sin cerrar la página; no reproduce la descarga real de un documento.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onunload demonstration</title>
<body onunload="document.getElementById('result').textContent = event.type">
<output id="result">pending</output>
<script>
window.dispatchEvent(new Event('unload'));
window.onunload = null;
</script>
</body>
</html>Resultado
unload
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.