Network Information API

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

The Network Information API provides information about the system's connection, which is in term of general connection type (e.g., 'wifi', 'cellular', etc.). This can be used to select high definition content or low definition content based on the user's connection. The entire API consists of the addition of the domxref("NetworkInformation") interface and a single property to the Navigator interface: Navigator.connection.

Detecting connection changes

This example watches for changes to the user's connection.

var connection = navigator.connection || navigator.webkitConnection;
var type = connection.type;

function updateConnectionStatus() {
  alert("Connection type is change from " + type + " to " + connection.type);
}

connection.addEventListener('typechange', updateConnectionStatus);

Specifications

Specification Status Comment
Network Information API Working Draft Initial specification

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support Not supported 12.0 moz Not supported Not supported Not supported
Feature Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support 2.2 webkit 12.0 moz 1.0.1 moz Not supported Not supported Not supported

Gecko notes

  • The Network API can be disabled using the dom.network.enabled preference.

See also

Document Tags and Contributors

Contributors to this page: Sheppy, Jeremie, johnshih, teoli, esprehn
Last updated by: johnshih,