NetworkInformation

Note: This feature is available in Web Workers.

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 or the WorkerNavigator interface.

EventTarget NetworkInformation

Instance properties

This interface also inherits properties of its parent, EventTarget.

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.saveData Read only

Returns true if the user has set a reduced data usage option on the user agent.

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

Instance methods

This interface also inherits methods of its parent, EventTarget.

Events

change

The event that's fired when connection information changes.

Specifications

Specification
Network Information API
# networkinformation-interface

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
NetworkInformation 61 79 31–32 48 No 38 31–99 25 No 3.0 50
change_event 61 79 No 48 No 38
NoOn Firefox, the event handler property corresponding to the change event is ontypechange.
 45 No 3.0 50
downlink
61The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
79The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
 No
48The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
 No
38The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
 No
25The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
 No
3.0The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
50The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
downlinkMax
61Only supported on ChromeOS
 No No No No 38 No 45 No 3.0 50
effectiveType 61 79 No 48 No 38 No 45 No 3.0 50
rtt
61The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
79The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
 No
48The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
 No
38The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
 No
25The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
 No
3.0The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
50The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
saveData 65 79 No 52 No 65 No 47 No 9.0 65
type
61Only supported on ChromeOS
 No 31–32 No No 38 31–99 45 No 3.0 50
typechange_event No No 31–32 No No
38Removal proposed in bug 699892.
 31–99
25Removal proposed in bug 699892.
 No
3.0Removal proposed in bug 699892.
 50
worker_support 61 79 31–32 48 No 38 53–99 45 No 3.0 50

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation