ContactAddress

Интерфейс ContactAddress API выбора контактов представляет физический адрес. Экземпляры этого интерфейса извлекаются из свойства address объектов, возвращаемых ContactsManager.getProperties().

Полезно ознакомиться с материалами стандарта Addressing S42 на сайте Всемирного почтового союза, которые предоставляют информацию об международных стандартах почтовых адресов.

ContactAddress.addressLine Только для чтения Экспериментальная

Массив строк, представляющий каждую строку адреса, не включенную в другие свойства. Точный размер и содержание варьируются в зависимости от страны или местоположения и может включать, например, название улицы, номер дома, номер квартиры, маршрут доставки по сельской местности, описательные инструкции или почтовый ящик.

ContactAddress.country Только для чтения Экспериментальная

Строка, определяющая страну, в которой находится адрес, используя стандарт ISO-3166-1 alpha-2. Строка всегда представлена в верхнем регистре. Некоторые примеры допустимых country значений: "US", "GB", "CN", или "JP".

ContactAddress.city Только для чтения Экспериментальная

Строка, содержащая город или поселок в адресе.

ContactAddress.dependentLocality Только для чтения Экспериментальная

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

ContactAddress.organization Только для чтения Экспериментальная

Строка, определяющая название организации, фирмы, компании или учреждения по указанному адресу.

ContactAddress.phone Только для чтения Экспериментальная

Строка, определяющая номер телефона получателя или контактного лица.

ContactAddress.postalCode Только для чтения Экспериментальная

Строка, определяющая код, используемый юрисдикцией для маршрутизации почты, например, почтовый индекс в США или PIN-код в Индии.

ContactAddress.recipient Только для чтения Экспериментальная

Строка, содержащая имя получателя, покупателя или контактного лица по указанному адресу.

ContactAddress.region Только для чтения Экспериментальная

Строка, содержащая высшую административную единицу страны, например, штат, провинцию, область или префектуру.

ContactAddress.sortingCode Только для чтения Экспериментальная

Строка, предоставляющая почтовый сортировочный код, например, используемый во Франции.

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

Стандартный сериализатор, который возвращает JSON-представление свойств объекта ContactAddress.

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

const props = ["address"];
const opts = { multiple: true };

async function getContacts() {
  try {
    const contacts = await navigator.contacts.select(props, opts);
    const contactAddress = contacts[0].address[0];
    console.log(contactAddress);
  } catch (ex) {
    // Handle any errors here.
  }
}