MozMobileConnection.selectNetwork()

This API is available on Firefox OS for internal applications only.

Summary

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

Note: If the network is actually changed by this request, the voicechange and datachange events are fired.

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

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, fscholz, kscarfone, Sheppy, jswisher, Jeremie
 Last updated by: chrisdavidmills,