Navigator: contacts property

Limited availability

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

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

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

The contacts read-only property of the Navigator interface returns a ContactsManager interface which allows users to select entries from their contact list and share limited details of the selected entries with a website or application.

Value

A ContactsManager object. Two successive calls return the same object.

Examples

The following code checks whether the Contact Picker API is supported.

js
const supported = "contacts" in navigator && "ContactsManager" in window;

Specifications

Specification
Contact Picker API
# dom-navigator-contacts

Browser compatibility

desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
contacts
Experimental

See also