NetworkInformation

The NetworkInformation interface provides information about the connection a device is using to commuinicate 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.

Properties

This interface also inherits properties of its parent, EventTarget.

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

NetworkInformation.downlinkMax Read only

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

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 API The definition of 'NetworkInformation' in that specification.	Editor's Draft	Initial definition

Browser compatibility

[1] The Network API can be disabled using the dom.network.enabled preference. From Gecko 12.0 to Gecko 30.0 included, this interface was called Connection and had different members. As of Gecko 12.0, the Network API is implemented for Android systems only. Support for Linux (bug 712442) and Windows (bug 721306) systems is in progress.

See also

• Network Information API
• Online and offline events
• The Navigator interface that implements it.