Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

ononline — gestire l’evento online

L’attributo ononline di body specifica il codice JavaScript che gestisce l’evento online dell’oggetto Window. Segnala un cambiamento nella valutazione del browser sulla disponibilità della rete, ma non conferma che un server specifico sia raggiungibile.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<body ononline="JavaScript statements">

ononline è un attributo di contenuto che definisce un gestore per l’evento online. Se scritto su body, imposta un gestore su Window, anziché gestire un normale evento diretto a body. Il valore dell’attributo è codice JavaScript; il parametro event disponibile rappresenta l’evento.

Il browser attiva online quando navigator.onLine cambia da false a true. Questo non significa che un server specifico sia raggiungibile o che una richiesta di rete andrà a buon fine. La sola registrazione del gestore non lo invoca per lo stato iniziale della connessione.

La proprietà JavaScript corrispondente è window.ononline. Assegnarle un valore sostituisce il gestore precedente di quella proprietà. Un’alternativa è window.addEventListener('online', handler), che consente di registrare funzioni listener indipendenti. Non inserire dati non attendibili nel codice dell’attributo.

L’esempio invia intenzionalmente un evento sintetico a window per verificare il collegamento dell’attributo senza modificare la connessione. Il testo atteso nel paragrafo è online. Questo test non cambia navigator.onLine e non dimostra l’accesso a Internet. Una Content Security Policy può bloccare i gestori scritti direttamente negli attributi.

Esempi

<!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>

Risultato

online

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti