MozMobileConnection.getCallForwardingOption()

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 getCallForwardingOption method is used to query current options for call forwarding.

Syntax

var request = navigator.mozMobileConnection.getCallForwardingOption(reason);

Parameters

reason
This parameter is a number that indicates the reason the call is being forwarded. It is one of:
  • 0: unconditional
  • 1: mobile busy
  • 2: no reply
  • 3: not reachable
  • 4: forwarding all calls
  • 5: conditionally forwarding all calls
All these values are available as constants in the MozMobileCFInfo interface.

Return

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

If the request is successful, the request's result is an array of MozMobileCFInfo objects.

Otherwise, the request's error is one of:

  • RadioNotAvailable
  • RequestNotSupported
  • GenericFailure

Example

var request = navigator.mozMobileConnection.getCallForwardingOption(MozMobileCFInfo.CALL_FORWARD_REASON_NO_REPLY);

request.onsuccess = function () {
  this.result.forEach(function (CFInfo) {
    console.log(CFInfo);
  });
}

request.onerror = function () {
  console.log('operation failed: ' + this.error.name);
}

Specification

Not part of any specification.

See also

Document Tags and Contributors

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