This article is in need of a technical review.

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 privileged or certified applications only.


The tel property is a list of all the possible phone numbers for the contact.


var phone =


Return an Array of TelField objects.


Those objects are regular JavaScript objects, each representing a phone number with the following properties:

An Array of strings representing the type for that phone number (e.g., "home", "work").
A boolean indicating if it is the preferred phone number (true) or not (false).
A string representing the phone number itself.
A string representing the phone number's carrier.


Specification Status Comment
Contacts Manager API
The definition of 'Contacts Manager API' in that specification.
Working Draft First Working Draft (unstable)
vCard Format Specification RFC RFC6350

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
basic support Not supported Not supported Not supported Not supported Not supported
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
basic support Not supported Not supported 18.0 (non standard) Not supported Not supported Not supported

Gecko Note

As the specification is unstable, the Gecko implementation is completely non-standard.

See also

Document Tags and Contributors

Contributors to this page: fscholz, MHasan, kscarfone, Jeremie
Last updated by: fscholz,