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

CKTIS / HTML

onoffline: gestionar el evento de paso al modo sin conexión

El atributo onoffline de body establece un controlador para el evento offline del objeto Window. Permite que una página reaccione cuando el navegador informa de una pérdida de conexión, pero no comprueba si se puede acceder a un servidor concreto.

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

Sintaxis

<body onoffline="JavaScript statements">

onoffline es un atributo de controlador de eventos: su valor es código JavaScript, no un valor booleano. Cuando se coloca en body, gestiona el evento offline del objeto Window, no un evento que afecte únicamente al elemento body.

El navegador pone en cola un evento offline cuando navigator.onLine cambia de true a false. Establecer el atributo no comprueba el estado inicial. Lee navigator.onLine durante la inicialización; usa ononline para reaccionar al cambio opuesto.

Esta señal no comprueba si un servidor es accesible. Un valor true no garantiza el acceso a Internet, y los errores de las solicitudes deben gestionarse por separado. No desactives funciones esenciales basándote únicamente en este indicador.

Una alternativa al atributo es window.addEventListener('offline', handler), que separa JavaScript de HTML y permite registrar varios escuchadores. Una Content Security Policy puede bloquear el código del controlador escrito directamente en un atributo.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onoffline demonstration</title>
</head>
<body onoffline="document.getElementById('status').textContent = 'offline event received'">
  <p id="status" role="status">waiting</p>
  <button id="simulate" type="button">Simulate offline event</button>
  <script>
    document.getElementById('simulate').addEventListener('click', () => {
      window.dispatchEvent(new Event('offline'));
    });
  </script>
</body>
</html>

Resultado

offline event received

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