This is an experimental technologyCheck 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.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
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 APIThe definition of 'NetworkInformation' in that specification. | Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
Full support 31 |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 |
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
? |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Chrome Full support 61 Full support 61 Notes' Only supported in Chrome OS |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
No support No |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
Full support Yes |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android No support No No support No Notes' On Firefox, the event handler property corresponding to the |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
? |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
? |
Opera Android
? |
Safari iOS
No support No |
Samsung Internet Android
No support No | |
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
No support No |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Chrome
Full support 65 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support Yes |
Safari
No support No |
WebView Android
Full support 65 |
Chrome Android
Full support 65 |
Firefox Android
? |
Opera Android
Full support Yes |
Safari iOS
No support No |
Samsung Internet Android
Full support 9.0 | |
Chrome Full support 61 Full support 61 Notes' Only supported in Chrome OS |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
No support No |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 | |
Available in workers |
Chrome
Full support 61 |
Edge
Full support 79 |
Firefox
No support No |
IE
No support No |
Opera
Full support 48 |
Safari
No support No |
WebView Android
Full support 50 |
Chrome Android
Full support 38 |
Firefox Android
Full support 53 |
Opera Android
Full support 45 |
Safari iOS
No support No |
Samsung Internet Android
Full support 3.0 |
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
- Network Information API
- Online and offline events
- The
Navigator
interface that implements it.
NetworkInformation by Mozilla Contributors is licensed under CC-BY-SA 2.5.