ContactsManager: phương thức getProperties()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Phương thức getProperties() của giao diện ContactsManager trả về một Promise được giải quyết với một Array gồm các chuỗi cho biết những thuộc tính liên hệ nào hiện có sẵn.

Syntax

getProperties()

Return value

Trả về một Promise được giải quyết với một Array gồm các chuỗi đặt tên cho các thuộc tính liên hệ mà hệ thống hiện tại có thể trả về.

Các thuộc tính có thể bao gồm:

'name': Tên của liên hệ.
'tel': (Các) số điện thoại của liên hệ.
'email': Địa chỉ email của liên hệ.
'address': Địa chỉ bưu chính của liên hệ.
'icon': Ảnh đại diện của liên hệ.

Examples

Verify Property Support

Hàm bất đồng bộ sau sử dụng phương thức getProperties() để kiểm tra xem hệ thống hiện tại có hỗ trợ thuộc tính icon hay không.

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

Select Using Only Supported Properties

Ví dụ sau tương tự như ví dụ cho phương thức select(). Thay vì mã hóa cứng các thuộc tính truyền vào select(), ví dụ này dùng getProperties() để đảm bảo rằng chỉ những thuộc tính được hỗ trợ mới được truyền vào. Nếu không, select() có thể ném ra TypeError. handleResults() là một hàm do nhà phát triển định nghĩa.

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