Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

ononline — gestionar el evento online

El atributo ononline de body especifica el código JavaScript que gestiona el evento online del objeto Window. Indica un cambio en la evaluación del navegador sobre la disponibilidad de la red, pero no confirma que se pueda acceder a un servidor concreto.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<body ononline="JavaScript statements">

ononline es un atributo de contenido que define un gestor para el evento online. Cuando se escribe en body, establece un gestor en Window, en lugar de gestionar un evento ordinario dirigido a body. El valor del atributo es código JavaScript; el parámetro event disponible representa el evento.

El navegador dispara online cuando navigator.onLine cambia de false a true. Esto no significa que se pueda acceder a un servidor concreto ni que una solicitud de red vaya a tener éxito. Registrar el gestor, por sí solo, no hace que se invoque para el estado inicial de la conexión.

La propiedad JavaScript correspondiente es window.ononline. Asignarle un valor sustituye el gestor anterior de esa propiedad. Otra opción es window.addEventListener('online', handler), que permite registrar funciones de escucha independientes. No insertes datos que no sean de confianza en el código de un atributo.

El ejemplo dispara deliberadamente un evento sintético en window para comprobar la conexión del atributo sin cambiar la conexión de red. El texto esperado del párrafo es online. Esta prueba no cambia navigator.onLine ni demuestra que haya acceso a Internet. Una Content Security Policy puede bloquear los gestores escritos directamente en atributos.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes