Network Information API

Experimental: Esta es una tecnología experimental
Comprueba la Tabla de compabilidad de navegadores cuidadosamente antes de usarla en producción.

La Network Information (Información de red) API provee información sobre el sistema de conexión en términos genéricos de tipos de conexión (ej., 'wifi', 'cellular', etc.). Esta puede ser usada para elegir contenido en alta definición o contenido baja definición basándose en la conexión del usuario. Toda la API consiste en la adición de la NetworkInformation (en-US) interfaz y una única propiedad para la Navigator interfaz: Navigator.connection (en-US).

Nota: Esta característica está disponible en Web Workers.

Examples

Detectar cambios de conexión

js
var connection =
  navigator.connection || navigator.mozConnection || navigator.webkitConnection;
var tipo = connection.effectiveType;

function updateConnectionStatus() {
  console.log(
    "Connection type changed from " + tipo + " to " + connection.effectiveType,
  );
  tipo = connection.effectiveType;
}

connection.addEventListener("change", updateConnectionStatus);

Precargar recursos grandes

El objeto de conexión es muy útil por ir decidiendo entre precargar recursos que ocupan mucho ancho de banda o memoria. Este ejemplo puede ser llamado justo después de que la página cargue para verificar el tipo de conexión donde precargar un video tal vez no sea lo deseado.Si se detecta la conexión de un celular, entonces el preloadVideo flag está seteado en false. Para simplificación y claridad, este ejemplo sólo testea un tipo de conexión. Una real-word usa case probablemente una declaración de switch o otro método para verificar todos los posibles valores de NetworkInformation.type (en-US).

en caso usaría una declaración de switch o algún otro método para verificar todos los valores posibles de use case would likely use a switch statement or some other method to check all of the possible values of NetworkInformation.type (en-US). Independientemente del valor de tipo, puede obtener una estimación de la velocidad de conexión a través de la propiedad NetworkInformation.effectiveType (en-US).

js
let preloadVideo = true;
var connection =
  navigator.connection || navigator.mozConnection || navigator.webkitConnection;
if (connection) {
  if (connection.effectiveType === "slow-2g") {
    preloadVideo = false;
  }
}

Interfaces

NetworkInformation (en-US)

Provee información sobre la conexión de un dispositivo si está usándose para cominicarse con la red y proveer un tipo de scripts para ser notificado si el tipo de conexión cambia. La intefaz de NetworkInformation no puede ser inicializada. En lugar de esto, se accede a través de la interfaz Navigator.

Especificaciones

Specification
Network Information API

Compatibilidad con navegadores

api.NetworkInformation

BCD tables only load in the browser

api.Navigator.connection

BCD tables only load in the browser

Véase también