Samsung Electronics logo

Getting Address Books



To create engaging applications with various contacts features, you must learn to access the address books in which the contacts are listed:

  1. To get the default address book, use the getDefaultAddressBook() method of the ContactManager interface to retrieve the default address book as an AddressBook object:

    var myAddressbook;
    
    /* Get the default address book */
    myAddressbook = webapis.contact.getDefaultAddressBook();
    
  2. To get all available address books, use the getAddressBooks() method. This method returns an array of AddressBook objects to the success event handler.

    var addressBook;
    
    function addressBooksCB(addressBooks) 
    {
       if (addressBooks.length > 0)
       addressBook = addressBooks[0];
       console.log("The addressbook type is " + addressbook.type 
                   + " and name " + addressbook.name);
    }
    
    /* Get the list of available address books */
    webapis.contact.getAddressBooks(addressBooksCB, errorCallback);
    
  3. All available address books on the device are retrieved. You can use an AddressBook object name to select a specific address book from the array with the getAddressBook() method.