MozMobileConnection.selectNetwork()

Summary

The selectNetwork method is used to manually select a network, overriding the radio's current selection.

Syntax

var request = navigator.mozMobileConnection.selectNetworks(network);

Parmeters

network

A MozMobileNetworkInfo object representing the nework to select.

Return

A DOMRequest object to handle the success or failure of the method call.

If the request fails, the request's error is one of:

• RadioNotAvailable
• RequestNotSupported
• IllegalSIMorME
• GenericFailure.

Example

var connection = navigator.mozMobileConnection;
var availableNetwork = connection.getNetworks();

availableNetwork.onsuccess = function () {
  var network = this.result[0];

  var switchNetwork = connection.selectNetwork(network);

  switchNetwork.onsuccess = function () {
    console.log('Successful switch to: ' + network.longName);
  }

  switchNetwork.onerror = function () {
    console.log('Unable to switch to: ' + network.longName);
  }
}

availableNetwork.onerror = function () {
  console.log('No network available: ' + this.error.name);
}

Specification

Not part of any specification.

See also

• MozMobileConnection
• MozMobileNetworkInfo
• DOMRequest