This API is available on Firefox OS for privileged or certified applications only.


The getCount method is used to retrieve the total number of contacts available inside the device's contact database.


var instanceOfDomRequest = window.navigator.mozContacts.getCount();

Return value

A DOMRequest object to handle the success or error of the operation. In case of success, the request's result is a number.


var request = window.navigator.mozContacts.getCount();

request.onsuccess = function () {
  console.log('there are ' + this.result + ' contacts in the database.');

request.onerror = function () {
  console.log('Something goes wrong!');


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

Browser compatibility

Supported in Firefox Mobile 18 and Firefox OS 1.1.

See also