NetworkInformation

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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
WebView on iOS
NetworkInformation
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox 31 – 31 (Release date: 2014-07-22)
footnote Removed in 32 and later
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote Full support
Safari – No support
Safari
footnote
footnote See bug 185697
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android 31 – 98 (Release date: 2014-07-22)
footnote Removed in 99 and later
Opera Android – Full support
Opera Android 25 (Release date: 2014-10-16)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote
footnote See bug 185697
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote
footnote See bug 185697
change event
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote Full support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android
footnote
footnote On Firefox, the event handler property corresponding to the change event is ontypechange.
Opera Android – Full support
Opera Android 45 (Release date: 2018-02-15)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
downlink
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – Full support
Opera Android 25 (Release date: 2014-10-16)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote
footnote The value is never greater than 10 Mbps, as a non-standard anti-fingerprinting measure.
WebView on iOS – No support
WebView on iOS
footnote No support
downlinkMax
Experimental
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote
footnote Only supported on ChromeOS
Edge – No support
Edge
footnote No support
Firefox – No support
Firefox
footnote No support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – Full support
Opera Android 45 (Release date: 2018-02-15)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
effectiveType
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote Full support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – Full support
Opera Android 45 (Release date: 2018-02-15)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
rtt
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – Full support
Opera Android 25 (Release date: 2014-10-16)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote
footnote The value is never greater than 3000 ms, as a non-standard anti-fingerprinting measure.
WebView on iOS – No support
WebView on iOS
footnote No support
saveData
Chrome – Full support
Chrome 65 (Release date: 2018-03-06)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 52 (Release date: 2018-03-22)
footnote Full support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 65 (Release date: 2018-03-06)
footnote Full support
Firefox for Android – No support
Firefox for Android
footnote No support
Opera Android – Full support
Opera Android 47 (Release date: 2018-07-23)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 9 (Release date: 2018-09-15)
footnote Full support
WebView Android – Full support
WebView Android 65 (Release date: 2018-03-06)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
type
Experimental
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote
footnote Only supported on ChromeOS
Edge – No support
Edge
footnote No support
Firefox – No support
Firefox 31 – 31 (Release date: 2014-07-22)
footnote Removed in 32 and later
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android 31 – 98 (Release date: 2014-07-22)
footnote Removed in 99 and later
Opera Android – Full support
Opera Android 45 (Release date: 2018-02-15)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
typechange event
Deprecated Non-standard
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – No support
Firefox 31 – 31 (Release date: 2014-07-22)
footnote Removed in 32 and later
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote
footnote Removal proposed in bug 40509974.
Firefox for Android – No support
Firefox for Android 31 – 98 (Release date: 2014-07-22)
footnote Removed in 99 and later
Opera Android – Full support
Opera Android 25 (Release date: 2014-10-16)
footnote
footnote Removal proposed in bug 40509974.
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote
footnote Removal proposed in bug 40509974.
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support
Available in workers
Chrome – Full support
Chrome 61 (Release date: 2017-09-05)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox 31 – 31 (Release date: 2014-07-22)
footnote Removed in 32 and later
Opera – Full support
Opera 48 (Release date: 2017-09-27)
footnote Full support
Safari – No support
Safari
footnote No support
Chrome Android – Full support
Chrome Android 38 (Release date: 2014-10-08)
footnote Full support
Firefox for Android – No support
Firefox for Android 53 – 98 (Release date: 2017-04-19)
footnote Removed in 99 and later
Opera Android – Full support
Opera Android 45 (Release date: 2018-02-15)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support
Samsung Internet – Full support
Samsung Internet 3 (Release date: 2015-04-10)
footnote Full support
WebView Android – Full support
WebView Android 50 (Release date: 2016-04-13)
footnote Full support
WebView on iOS – No support
WebView on iOS
footnote No support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

See also