The NetworkInformation
interface of the Network Information API 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
interface cannot be instantiated. It is instead accessed through the connection
property of the Navigator
interface.
EventTarget
NetworkInformation
Instance properties
This interface also inherits properties of its parent, EventTarget
.
NetworkInformation.downlink
Read only Experimental
Returns the effective bandwidth estimate in megabits per second, rounded to the nearest multiple of 25 kilobits per seconds.
NetworkInformation.downlinkMax
Read only Experimental
Returns the maximum downlink speed, in megabits per second (Mbps), for the underlying connection technology.
NetworkInformation.effectiveType
Read only Experimental
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 Experimental
Returns the estimated effective round-trip time of the current connection, rounded to the nearest multiple of 25 milliseconds.
NetworkInformation.saveData
Read only Experimental
Returns true
if the user has set a reduced data usage option on the user agent.
NetworkInformation.type
Read only Experimental
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
Instance methods
This interface also inherits methods of its parent, EventTarget
.
Events
change
Experimental
The event that's fired when connection information changes.
Specifications
Browser compatibility
Desktop
Mobile
Chrome
Edge
Firefox
Internet Explorer
Opera
Safari
WebView Android
Chrome Android
Firefox for Android
Opera Android
Safari on IOS
Samsung Internet
NetworkInformation
61
79
31–32
No
48
No
50
38
31–99
25
No
3.0
change_event
61
79
No
No
48
No
50
38
No On Firefox, the event handler property corresponding to the change
event is ontypechange
.
45
No
3.0
downlink
61 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
79 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
No
No
48 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
No
50 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
38 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
No
25 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
No
3.0 The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
downlinkMax
61 Only supported in Chrome OS
No
No
No
No
No
50
38
No
45
No
3.0
effectiveType
61
79
No
No
48
No
50
38
No
45
No
3.0
rtt
61 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
79 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
No
No
48 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
No
50 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
38 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
No
25 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
No
3.0 The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
saveData
65
79
No
No
52
No
65
65
No
47
No
9.0
type
61 Only supported in Chrome OS
No
31–32
No
No
No
50
38
31–99
45
No
3.0
typechange_event
No
No
31–32
No
No
No
50
38 Removal proposed in bug 699892 .
31–99
25 Removal proposed in bug 699892 .
No
3.0 Removal proposed in bug 699892 .
worker_support
61
79
31–32
No
48
No
50
38
53–99
45
No
3.0
See also