mozilla
Your Search Results

    FMRadio.setFrequency()

    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 or Firefox OS for installed or higher privileged applications.

    Summary

    The setFrequency method is used to change the frequency listened to by the radio.

    Each time this method is called successfully, the frequencychange event is fired.

    The frequency to set must be in the range defined by the frequencyLowerBound and the frequencyUpperBound properties.

    When set, the actual frequency used by the radio is the frequency passed as input but rounded according to the value of the channelWidth property.

    Syntax

    var request = instanceOfFMRadio.setFrequency(frequency);

    Parameters

    frequency
    The value of the new frequency to set, It's a number representing a value in MHz (MegaHertz).

    Returns

    It returns a DOMRequest to handle the success or error of the operation.

    Example

    var request = navigator.mozFMRadio.setFrequency(100.15);
     
    request.onsuccess = function () {
      console.log("The radio is now listening the frequency: " + navigator.mozFMRadio.frequency + "MHz");
    }
    
    request.onerror = function () {
      console.log("Something goes wrong!");
    }
    

    Specification

    Not part of any specification.

    See also

    Document Tags and Contributors

    Contributors to this page: kscarfone, teoli, Jeremie
    Last updated by: teoli,