ContactManager

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

Summary

The ContactManager interface is used to access and manage the contact available on the device.

Note: This interface cannot be instantiated; it is accessed through the navigator.mozContacts property.

Properties

None

Event Handlers

ContactManager.oncontactchange
A handler for the contactchange event. It is fired each time a contact is created, updated, or deleted.

Methods

ContactManager.clear()
Allows to remove ALL contacts. Returns a DOMRequest.
ContactManager.find()
Allows to retrieve a finished unsorted list of contacts. Returns a DOMRequest.
ContactManager.getAll()
Allows to retrieve a full sorted list of contacts. Returns a DOMCursor.
ContactManager.getCount()
Allows to get the number of contacts available. Returns a DOMRequest.
ContactManager.getRevision()
Allows to get the revision number of the contact's database. Returns a DOMRequest.
ContactManager.remove()
Allows to remove a single contact. Returns a DOMRequest.
ContactManager.save()
Allows to save a contact (it can be a new contact or an updated contact). Returns a DOMRequest.

Specifications

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

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 Not supported Not supported Not supported

See also

Document Tags and Contributors

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