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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android Full support 31Opera Android Full support 37Safari iOS No support NoSamsung Internet Android ?
Available in workers
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE ? Opera Full support 48Safari ? WebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android Full support 53Opera Android Full support 37Safari iOS ? Samsung Internet Android ?
downlink
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE ? Opera Full support 48Safari ? WebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android ? Opera Android Full support 37Safari iOS ? Samsung Internet Android ?
downlinkMax
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android No support NoOpera Android Full support 37Safari iOS No support NoSamsung Internet Android ?
effectiveType
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android Full support YesOpera Android Full support 37Safari iOS ? Samsung Internet Android ?
onchange
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android No support No
Notes
No support No
Notes
Notes On Firefox, the event handler property corresponding to the change event is ontypechange.
Opera Android Full support 37Safari iOS No support NoSamsung Internet Android ?
rtt
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android No support NoOpera Android Full support 37Safari iOS No support NoSamsung Internet Android ?
type
Experimental
Chrome Full support 61Edge No support NoFirefox No support NoIE No support NoOpera Full support 48Safari No support NoWebView Android Full support 50Chrome Android Full support 38Edge Mobile ? Firefox Android No support NoOpera Android Full support 37Safari iOS No support NoSamsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.

See also

Document Tags and Contributors

Last updated by: Vanilagy,