ContactsManager: метод getProperties()

Метод getProperties() интерфейса ContactsManager возвращает Promise, который разрешается массивом Array строк strings, указывающих, какие свойства контактов доступны.

Нет.

Возвращает Promise, который разрешается массивом Array строк strings, перечисляющих свойства контакта, которые может вернуть текущая система.

Свойства могут включать:

• 'name': Имя контакта.
• 'tel': Номер(а) телефона контакта.
• 'email': Электронный адрес контакта.
• 'address': Почтовый адрес контакта.
• 'icon': Аватар контакта.

Исключения не выбрасываются.

Следующая асинхронная функция использует метод getProperties() для проверки, поддерживает ли текущая система свойство icon.

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

Следующий пример похож на пример для метода select(). Вместо жестко заданных свойств, передаваемых в select(), он использует getProperties() для обеспечения передачи только поддерживаемых свойств. Иначе, select() может выбросить исключение TypeError. handleResults() — это функция, определённая разработчиком.

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.
  }
}