Evento onbeforeunload

Definição e uso

O evento onbeforeunload ocorre quando o documento está prestes a ser desfeito.

Este evento permite que você mostre uma mensagem no diálogo de confirmação, notificando o usuário se ele deve permanecer ou sair da página atual.

A mensagem padrão que aparece no caixa de diálogo de confirmação é diferente em diferentes navegadores. No entanto, a mensagem padrão é semelhante a "Você tem certeza de que deseja sair dessa página?" Esta mensagem não pode ser excluída.

Mas, você pode escrever a mensagem personalizada juntamente com a mensagem padrão. Veja o primeiro exemplo nesta página. Comentário: Aplica-se apenas ao Internet Explorer.

Comentário:Se o evento onbeforeunload não for atribuído ao elemento <body>, deve ser atribuído/adicionado ao objeto window e usar o atributo returnValue para criar uma mensagem personalizada (veja o exemplo de sintaxe abaixo).

Exemplo

Execute JavaScript ao encerrar a página:

<body onbeforeunload="return myFunction()">

Experimente pessoalmente

Sintaxe

No HTML:

<elemento onbeforeunload="myScript">

Experimente pessoalmente

No JavaScript:

objeto.onbeforeunload = function(){myScript};

Experimente pessoalmente

No JavaScript, use o método addEventListener():

objeto.addEventListener("beforeunload", myScript);

Experimente pessoalmente

Comentário:Internet Explorer 8 ou versões anteriores não suportam Método addEventListener()

Detalhes técnicos

Bubbling: Não suportado
Cancelável: Suporte
Tipo de evento: Se gerado a partir da interface do usuárioUiEvento。Caso contrário Evento
Etiquetas HTML suportadas: <body>
Versão DOM: Eventos de Nível 2

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta completamente o evento.

Eventos Chrome IE Firefox Safari Opera
onbeforeunload Suporte Suporte Suporte Suporte 15.0