W3cubDocs

/Web APIs

NetworkInformation

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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.

Note: This feature is available in Web Workers

Instance properties

This interface also inherits properties of its parent, EventTarget.

NetworkInformation.downlink Read only Experimental

Returns the effective bandwidth estimate in megabits per second, rounded to the nearest multiple of 25 kilobits per seconds.

NetworkInformation.downlinkMax Read only Experimental

Returns the maximum downlink speed, in megabits per second (Mbps), for the underlying connection technology.

NetworkInformation.effectiveType Read only Experimental

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 Experimental

Returns the estimated effective round-trip time of the current connection, rounded to the nearest multiple of 25 milliseconds.

NetworkInformation.saveData Read only Experimental

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

NetworkInformation.type Read only Experimental

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 Experimental: The event that's fired when connection information changes.

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	31–32	No	48	No	50	38	31–99	25	No	3.0
`change_event`	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
`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.	No	25 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	No	45	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	25 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	52	No	65	65	No	47	No	9.0
`type`	61 Only supported in Chrome OS	No	31–32	No	No	No	50	38	31–99	45	No	3.0
`typechange_event`	No	No	31–32	No	No	No	50	38 Removal proposed in bug 699892.	31–99	25 Removal proposed in bug 699892.	No	3.0 Removal proposed in bug 699892.
`worker_support`	61	79	31–32	No	48	No	50	38	53–99	45	No	3.0

Instance properties

Instance methods

Events

Specifications

Browser compatibility

See also