ContactsManager: getProperties()-Methode

Keine.

Gibt ein Promise zurück, das mit einem Array von strings aufgelöst wird, die die Kontakteigenschaften benennen, die vom aktuellen System zurückgegeben werden können.

Eigenschaften können Folgendes umfassen:

• 'name': Der Name des Kontakts.
• 'tel': Die Telefonnummer(n) des Kontakts.
• 'email': Die E-Mail-Adresse des Kontakts.
• 'address': Die Postanschrift des Kontakts.
• 'icon': Das Avatarbild des Kontakts.

Es werden keine Ausnahmen ausgelöst.

Die folgende asynchrone Funktion verwendet die getProperties()-Methode, um zu überprüfen, ob das aktuelle System die icon-Eigenschaft unterstützt.

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

Das folgende Beispiel ist ähnlich einem für die select()-Methode. Anstatt die an select() übergebenen Eigenschaften fest zu codieren, nutzt es getProperties(), um sicherzustellen, dass nur unterstützte Eigenschaften übergeben werden. Andernfalls könnte select() einen TypeError auslösen. handleResults() ist eine entwicklerdefinierte Funktion.

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