Telephony.dial()

The dial() method of the Telephony interface dials a phone number and returns a new TelephonyCall object representing the new call.

Syntax

The new syntax is promise-based, and resolves with the TelephonyCall object for the new call:

myTelephony.dial(number or MMICode,serviceId).then(function(myCall) {
  // do something with the new telephone or MMI call
});

The original syntax (Firefox 1.3 and below) was just a regular non-promise method.

var myTelephonyCall = myTelephony.dial(number or MMICode,serviceId);

Parameters

number

A string indicating the phone number to dial.

MMI code

A string indicating the MMI code to dial (e.g. *123#).

serviceId Optional

The id of the mobile service you want to use to make the call. If not specified, the default value for the device is used.

Returns

A promise that resolves with a TelephonyCall or MMICall object.

Examples

// Telephony object
var tel = navigator.mozTelephony;

// Place a call
tel.dial("123456789").then(function(call) {
  call.id;
});

Specifications

Browser compatibility

For obvious reasons, support is primarily expected on mobile browsers.

See also

• Using the Web Telephony API
• TelephonyCall
• CallEvent
• Navigator.mozTelephony