Evento onbeforeunload
Exemplo
Execute um JavaScript quando a página estiver prestes a ser descarregada:
<body onbeforeunload="return myFunction()">
Definição e uso
O evento onbeforeunload ocorre quando o documento está prestes a ser descarregado.
Este evento permite exibir uma mensagem em uma caixa de diálogo de confirmação para informar ao usuário se deseja permanecer ou sair da página atual.
A mensagem padrão que aparece na caixa de confirmação é diferente em diferentes navegadores. No entanto, a mensagem padrão é algo como "Tem certeza de que deseja sair desta página?". Esta mensagem não pode ser removida.
No entanto, você pode escrever uma mensagem personalizada junto com a mensagem padrão. Veja o primeiro exemplo nesta página. Nota : Isso só funciona no Internet Explorer.
Nota: Se o evento onbeforeunload não for atribuído ao elemento <body>, você deve atribuir/anexar o evento no objeto window e usar a propriedade returnValue para criar uma mensagem personalizada (veja os exemplos de sintaxe abaixo).
Suporte ao navegador
Os números na tabela especificam a primeira versão do navegador que oferece suporte total ao evento.
Event | |||||
---|---|---|---|---|---|
onbeforeunload | Yes | Yes | Yes | Yes | 15.0 |
Sintaxe
Em HTML:
<element onbeforeunload="myScript">
Em JavaScript:
object.onbeforeunload = function(){myScript};
Em JavaScript, usando o método addEventListener():
object.addEventListener("beforeunload", myScript);
Observação: o método addEventListener() não é compatível com o Internet Explorer 8 e versões anteriores.
Detalhes técnicos
Bolhas: | Não |
---|---|
Cancelável: | sim |
Tipo de evento: | UiEvent se gerado a partir de uma interface de usuário, Event caso contrário |
Tags HTML suportadas: | <corpo> |
Versão DOM: | Eventos de Nível 2 |