Contact Picker API：联系人选择与权限治理

---

title: Contact Picker API：联系人选择与权限治理

keywords:

• Contact Picker
• navigator.contacts.select
• properties
• multiple
• 隐私

description: 介绍选择设备联系人数据的流程与返回字段、属性过滤与多选、权限与隐私治理，并提供示例与回退策略。

categories:

• 文章资讯
• 技术教程

---

概述

Contact Picker API 允许在用户授权下选择联系人条目并返回指定属性（如姓名、邮箱、电话）。适用于表单自动填充与协作应用，需严格的隐私与权限控制。

示例

if ('contacts' in navigator && 'select' in navigator.contacts) {
  const contacts = await navigator.contacts.select(['name','email'], { multiple: true })
  console.log(contacts)
} else {
  // 回退到手动输入
}

工程建议

• 属性最小化：仅请求必要字段；避免过度采集。
• 透明与控制：明确用途并提供关闭入口；不持久化敏感数据。
• 兼容：仅在支持平台启用；保留表单路径。

参考与验证

• web.dev Contact Picker 指南：https://web.dev/articles/contact-picker
• Chrome 平台文档：https://developer.chrome.com/docs/web-platform/contact-picker/