This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The NetworkInformation interface provides information about the connection a device is using to communicate with the network and provides a means for scripts to be notified if the connection type changes. The NetworkInformation interfaces cannot be instantiated. It is instead accessed through the connection property of the Navigator interface.

Note: This feature is available in Web Workers.

Properties

This interface also inherits properties of its parent, EventTarget.

NetworkInformation.downlink Read only
Returns the effective bandwidth estimate in megabits per second, rounded to the nearest multiple of 25 kilobits per seconds.
NetworkInformation.downlinkMax Read only
Returns the maximum downlink speed, in megabits per second (Mbps), for the underlying connection technology.
NetworkInformation.effectiveType Read only
Returns the effective type of the connection meaning one of 'slow-2g', '2g', '3g', or '4g'. This value is determined using a combination of recently observed, round-trip time and downlink values.
NetworkInformation.rtt Read only
Returns the estimated effective round-trip time of the current connection, rounded to the nearest multiple of 25 milliseconds.
NetworkInformation.type Read only
Returns the type of connection a device is using to communicate with the network. It will be one of the following values:
  • bluetooth
  • cellular
  • ethernet
  • none
  • wifi
  • wimax
  • other
  • unknown

Event handlers

NetworkInformation.onchange
The event that's fired when connection information changes and the change is fired on this object.

Methods

This interface also inherits methods of its parent, EventTarget.

Specifications

Specification Status Comment
Network Information API
The definition of 'NetworkInformation' in that specification.
Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support61 ? No No48 No
Available in workers61 ? No ?48 ?
downlink61 ? ? ?48 ?
downlinkMax61 ? No No48 No
effectiveType61 ? ? ?48 ?
onchange61 ? No No48 No
rtt61 ? No No48 No
type61 ? No No48 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support5038 ?3137 No ?
Available in workers5038 ?5337 ? ?
downlink5038 ? ?37 ? ?
downlinkMax5038 ? No37 No ?
effectiveType5038 ? ?37 ? ?
onchange5038 ? No137 No ?
rtt5038 ? No37 No ?
type5038 ? No37 No ?

1. On Firefox, the event handler property corresponding to the change event is ontypechange.

See also

Document Tags and Contributors

Last updated by: fscholz,