この記事はまだ日本語に翻訳されていません。MDN の翻訳はボランティアによって行われています。是非 MDN に登録し、私たちの力になって下さい。
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The Connection interface represents the connectivity of the device on which the browser runs.
An object of this type can be obtained via connection property, available on the Navigator object:
var connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;Properties
The Connection interface inherits properties from its parent, the EventTarget interface.
Connection.bandwidthRead only- Is a
doublerepresenting the estimated download bandwidth (in MB/s) of the current connection.0if the user is currently offline andinfinityif the bandwidth is unknown. Connection.meteredRead only- Is a
Booleanflag indicating if the connection is metered (e.g., pay-per-use).
Events handler
Connection.onchange- Is an
EventHandlerfor thechangeevent. This event is fired when the connection information changes.
Methods
The Connection interface doesn't implement any specific method, but inherits methods from its parent, the EventTarget interface.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Network Information API The definition of 'Connection' in that specification. |
Editor's Draft | Initial specification. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | Not supported | 12.0 moz | Not supported | Not supported | Not supported |
| Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | Not supported | 12.0 moz | Not supported | Not supported | Not supported |
Gecko notes
- The Network API can be disabled using the
dom.network.enabledpreference. - 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.
- Before Gecko 14.0,
navigator.mozConnectionwas not an instance ofEventTarget, meaning that you couldn't useaddEventListener()could be called. This has been fixed.