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 inWeb Workers.
TheNetworkInformation interface of theNetwork 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.TheNetworkInformation interface cannot be instantiated. It is instead accessed through theconnection property of theNavigator interface or theWorkerNavigator interface.
Instance properties
This interface also inherits properties of its parent,EventTarget.
NetworkInformation.downlinkRead onlyReturns the effective bandwidth estimate in megabits per second, rounded to the nearest multiple of 25 kilobits per seconds.
NetworkInformation.downlinkMaxRead onlyExperimentalReturns the maximum downlink speed, in megabits per second (Mbps), for the underlying connection technology.
NetworkInformation.effectiveTypeRead onlyReturns 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.rttRead onlyReturns the estimated effective round-trip time of the current connection, rounded to the nearest multiple of 25 milliseconds.
NetworkInformation.saveDataRead onlyReturns
trueif the user has set a reduced data usage option on the user agent.NetworkInformation.typeRead onlyExperimentalReturns the type of connection a device is using to communicate with the network. It will be one of the following values:
bluetoothcellularethernetnonewifiwimaxotherunknown
Instance methods
This interface also inherits methods of its parent,EventTarget.
Events
changeThe event that's fired when connection information changes.
Specifications
| Specification |
|---|
| Network Information API # networkinformation-interface |