ContactsManager: getProperties() method

None.

Returns a Promise that resolves with an Array of strings naming the contact properties that can be returned by the current system.

Properties can include the following:

• 'name': The contact's name.
• 'tel': The telephone number(s) of the contact.
• 'email': The email address of the contact.
• 'address': The contact's postal address.
• 'icon': The avatar of the contact.

No exceptions are thrown.

The following asynchronous function uses the getProperties() method to check whether the current system supports the icon property.

async function checkProperties() {
  const supportedProperties = await navigator.contacts.getProperties();
  if (!supportedProperties.includes("icon")) {
    console.log("Your system does not support getting icons.");
  }
}

The following example is similar to one for the select() method. Instead of hard-coding the properties passed to select(), it uses getProperties() to ensure that only supported properties are passed. Otherwise, select() might throw a TypeError. handleResults() is a developer defined function.

const supportedProperties = await navigator.contacts.getProperties();

async function getContacts() {
  try {
    const contacts = await navigator.contacts.select(supportedProperties);
    handleResults(contacts);
  } catch (ex) {
    // Handle any errors here.
  }
}