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.