ContactFindOptions

Contains properties that can be used to filter the results of a [contacts.find](../contacts.find.html) operation.

Properties

  • filter: The search string used to find contacts. (DOMString) (Default: "")
  • multiple: Determines if the find operation should return multiple contacts. (Boolean) (Default: false)

Supported Platforms

  • Android
  • BlackBerry WebWorks (OS 5.0 and higher)
  • iOS
  • Bada 1.2 & 2.0
  • Windows Phone 7 and 8
  • Windows 8

Quick Example

// success callback
function onSuccess(contacts) {
	for (var i=0; i<contacts.length; i++) {
		alert(contacts[i].displayName);
	}
};

// error callback
function onError(contactError) {
    alert('onError!');
};

// specify contact search criteria
var options = new ContactFindOptions();
options.filter="";			// empty search string returns all contacts
options.multiple=true;		// return multiple results
filter = ["displayName"];	// return contact.displayName field

// find contacts
navigator.contacts.find(filter, onSuccess, onError, options);

Full Example

<!DOCTYPE html>
<html>
  <head>
    <title>Contact Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova-x.x.x.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for Cordova to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova is ready
    //
    function onDeviceReady() {
		// specify contact search criteria
	    var options = new ContactFindOptions();
		options.filter="";			// empty search string returns all contacts
		options.multiple=true;		// return multiple results
		filter = ["displayName"];	// return contact.displayName field

		// find contacts
	    navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
	function onSuccess(contacts) {
		for (var i=0; i<contacts.length; i++) {
			alert(contacts[i].displayName);
		}
	};

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Bada Quirks

filter: Property can only apply to the following: "firstName", "lastName", "nickname", "phoneNumber", "email", "address"