The connection object, exposed via navigator.connection, provides information about the device's cellular and wifi connection.
Android
app/res/xml/config.xml
app/AndroidManifest.xml
BlackBerry WebWorks
www/plugins.xml
iOS
config.xml
Windows Phone
Properties/WPAppManifest.xml
Tizen
config.xml
Checks the currently active network connection.
This property offers a fast way to determine the device's network
connection state, and type of connection.
iOS
Android
BlackBerry WebWorks (OS 5.0 and higher)
Tizen
Windows Phone 7 and 8
Windows 8
function checkConnection() {
var networkState = navigator.connection.type;
var states = {};
states[Connection.UNKNOWN] = 'Unknown connection';
states[Connection.ETHERNET] = 'Ethernet connection';
states[Connection.WIFI] = 'WiFi connection';
states[Connection.CELL_2G] = 'Cell 2G connection';
states[Connection.CELL_3G] = 'Cell 3G connection';
states[Connection.CELL_4G] = 'Cell 4G connection';
states[Connection.CELL] = 'Cell generic connection';
states[Connection.NONE] = 'No network connection';
alert('Connection type: ' + states[networkState]);
}
checkConnection();
navigator.connection.type Example// Wait for device API libraries to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// device APIs are available
//
function onDeviceReady() {
checkConnection();
}
function checkConnection() {
var networkState = navigator.connection.type;
var states = {};
states[Connection.UNKNOWN] = 'Unknown connection';
states[Connection.ETHERNET] = 'Ethernet connection';
states[Connection.WIFI] = 'WiFi connection';
states[Connection.CELL_2G] = 'Cell 2G connection';
states[Connection.CELL_3G] = 'Cell 3G connection';
states[Connection.CELL_4G] = 'Cell 4G connection';
states[Connection.CELL] = 'Cell generic connection';
states[Connection.NONE] = 'No network connection';
alert('Connection type: ' + states[networkState]);
}
A dialog box will report the network state.
Until Cordova 2.3.0, the navigator.network.connection, after which it was changed to
navigator.connection to match the W3C specification. It's still
available at its original location, but is deprecated and will
eventually be removed.
iOS cannot detect the type of cellular network connection.
When running in the emulator, always detects
Windows Phone cannot detect the type of cellular network connection.
Tizen can only detect a WiFi or cellular connection.