CKTIS / HTML
onunload — gerir o descarregamento de um documento
O atributo onunload do elemento body define um processador para o evento unload do objeto Window, não um processador dirigido ao próprio elemento. Não é um local fiável para guardar dados nem uma forma de impedir que se saia de uma página.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onunload="/* JavaScript */">
window.onunload = handler;
window.onunload = null;onunload é um atributo de conteúdo processador de eventos para unload. No elemento body, o seu valor contém JavaScript executado como processador no objeto Window associado. Não é um atributo global comum para qualquer elemento HTML.
O seu equivalente em JavaScript é window.onunload, que aceita uma função ou null. O atributo body e esta propriedade controlam o mesmo processador: uma atribuição posterior substitui o valor anterior e null remove-o. No código do atributo, o parâmetro event disponibiliza o evento.
unload diz respeito ao descarregamento de um documento, mas não presuma que ocorre sempre que se sai de uma página. O algoritmo da norma ignora-o quando o documento é mantido para ser restaurado mais tarde a partir do histórico. Não o use como único local para guardar dados importantes nem conte com a conclusão de trabalho assíncrono nesse momento. Para observar o ciclo de vida, considere pagehide ou visibilitychange, consoante o objetivo.
Não confunda onunload com onbeforeunload: unload não pode ser cancelado, e return false não impede a navegação nem apresenta uma confirmação antes de sair da página. O exemplo envia deliberadamente um evento sintético para demonstrar a ligação do atributo a Window sem fechar a página; não reproduz o descarregamento real do documento.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.