Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes