CKTIS / HTML
ononline — tratar o evento online
O atributo ononline de body especifica o código JavaScript que trata o evento online do objeto Window. Indica uma alteração na avaliação do navegador sobre a disponibilidade da rede, mas não confirma que um servidor específico esteja acessível.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body ononline="JavaScript statements">ononline é um atributo de conteúdo que define um processador para o evento online. Quando é escrito em body, define um processador em Window, em vez de tratar um evento comum dirigido a body. O valor do atributo é código JavaScript; o parâmetro event disponível representa o evento.
O navegador dispara online quando navigator.onLine muda de false para true. Isto não significa que um servidor específico esteja acessível nem que um pedido de rede tenha sucesso. Registar o processador, por si só, não faz com que seja chamado para o estado inicial da ligação.
A propriedade JavaScript correspondente é window.ononline. Atribuir-lhe um valor substitui o processador anterior dessa propriedade. Uma alternativa é window.addEventListener('online', handler), que permite registar funções de escuta independentes. Não insira dados não fiáveis no código de um atributo.
O exemplo dispara deliberadamente um evento sintético em window para verificar a associação do atributo sem alterar a ligação. O texto esperado no parágrafo é online. Este teste não altera navigator.onLine nem comprova o acesso à Internet. Uma Content Security Policy pode bloquear processadores escritos diretamente nos atributos.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ononline demo</title>
</head>
<body ononline="document.getElementById('status').textContent = event.type">
<p id="status">waiting</p>
<script>
window.dispatchEvent(new Event('online'));
</script>
</body>
</html>Resultado
online
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.