ContactAddress

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

ContactAddress 接口是 联系人选择器 API 的一部分,代表一个物理地址。此接口的实例是从 ContactsManager.getProperties() 返回的对象中的 address 属性中检索到的。

引用万国邮政联盟网站的 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 只读 实验性

一个字符串,指定管辖区用于邮件路由的代码,例如,美国的 ZIP 代码或印度的 PIN 代码。

ContactAddress.recipient 只读 实验性

一个字符串,表示地址中的收件人、购买者或联系人的姓名。

ContactAddress.region 只读 实验性

一个字符串,包含国家/地区的高级行政区划,例如州、省、州(俄罗斯)或县(日本)。

ContactAddress.sortingCode 只读 实验性

一个字符串,提供邮政分拣代码,例如在法国使用的代码。

实例方法

ContactAddress.toJSON() 实验性

一个标准的序列化器,返回 ContactAddress 对象属性的 JSON 表示。

示例

以下示例提示用户选择联系人,然后将返回的第一个地址打印到控制台。

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

规范

规范
联系人选择器 API
# contactaddress

浏览器兼容性