ContactsManager

Интерфейс ContactsManager API Выбор контактов позволяет пользователям выбирать записи из своего списка контактов и делиться ограниченными данными выбранных записей с веб-сайтом или приложением.

Функция ContactsManager доступна через глобальное свойство navigator.contacts.

select() Экспериментальная

Возвращает Promise, который, при разрешении, предоставляет пользователю средство выбора контакта, позволяющее выбрать контакт(ы), который(е) они хотят поделиться.

getProperties() Экспериментальная

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

Следующий код проверяет, поддерживается ли API выбора контактов.

const supported = "contacts" in navigator && "ContactsManager" in window;

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

async function checkProperties() {
  const supportedProperties = await navigator.contacts.getProperties();
  if (supportedProperties.includes("name")) {
    // run code for name support
  }
  if (supportedProperties.includes("email")) {
    // run code for email support
  }
  if (supportedProperties.includes("tel")) {
    // run code for telephone number support
  }
  if (supportedProperties.includes("address")) {
    // run code for address support
  }
  if (supportedProperties.includes("icon")) {
    // run code for avatar support
  }
}

В этом примере задается массив свойств, которые необходимо получить для каждого контакта, а также устанавливается объект параметров, позволяющий выбрать несколько контактов.

Затем определяется асинхронная функция, которая использует метод select() для отображения пользователю интерфейса выбора контактов и обработки выбранных результатов.

const props = ["name", "email", "tel", "address", "icon"];
const opts = { multiple: true };

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

handleResults() - это функция, определенная разработчиком.

• Выбор контактов для веб-приложений
• Демонстрация выбора контактов на glitch