NetworkInformation
Experimental: 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.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 |
---|
Network Information API # networkinformation-interface |
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 |
No |
No |
48 |
No |
50 |
38 |
31 |
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.
|
? |
45
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 |
Yes |
45 |
No |
3.0 |
onchange |
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 |
ontypechange |
No |
No |
No |
No |
? |
No |
No |
38 |
31 |
? |
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 |
45
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 |
Yes |
No |
65 |
65 |
? |
Yes |
No |
9.0 |
type |
61
Only supported in Chrome OS
|
No |
No |
No |
No |
No |
50 |
38 |
31 |
45 |
No |
3.0 |
worker_support |
61 |
79 |
No |
No |
48 |
No |
50 |
38 |
53 |
45 |
No |
3.0 |
See also
- Network Information API
- Online and offline events
- The
Navigator
interface that implements it.
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation