mozilla
Your Search Results

    MozMobileConnection.selectNetwork()

    This article is in need of a technical review.

    Non-standard
    This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.

    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: Sheppy, jswisher, kscarfone, fscholz, Jeremie
    Last updated by: fscholz,
    Hide Sidebar