• Skip to main content
  • Select language
  • Skip to search
MDN Web Docs
  • Technologies
    • HTML
    • CSS
    • JavaScript
    • Graphics
    • HTTP
    • APIs / DOM
    • WebExtensions
    • MathML
  • References & Guides
    • Learn web development
    • Tutorials
    • References
    • Developer Guides
    • Accessibility
    • Game development
    • ...more docs
B2G OS
  1. MDN
  2. Archive of obsolete content
  3. B2G OS
  4. B2G OS APIs
  5. Telephony
  6. Telephony.dial()

Telephony.dial()

In This Article
  1. Syntax
    1. Parameters
    2. Returns
  2. Examples
  3. Specifications
  4. Browser compatibility
  5. See also

This API is available on Firefox OS for internal applications only.

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

Specification Status Comment
Web Telephony Draft Draft

Browser compatibility

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

  • Desktop
  • Mobile
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support No support No support No support No support No support
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support No support 12.0 (12.0) 1.0.1 No support No support No support
Promise version No support 30.0 (30.0) 1.4 No support No support No support

See also

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

Document Tags and Contributors

Tags: 
  • API
  • B2G
  • Certified
  • dial
  • DOM
  • Firefox OS
  • Method
  • Mobile
  • Non-standard
  • Reference
  • Référence
  • Telephony
  • WebAPI
 Contributors to this page: chrisdavidmills, teoli, fscholz, kollishivagangadhar, kscarfone, Jeremie, Sheppy
 Last updated by: chrisdavidmills, Feb 27, 2017, 2:32:27 AM
See also
  1. Web Telephony API
  2. Archive
  3. Events
    1. incoming
  4. Related pages for Web Telephony API
    1. CallEvent
    2. CallGroup
    3. MMICall
    4. Telephony
    5. TelephonyCall
    6. TelephonyCallGroup