在前端开发中，我们经常需要使用一些特定的工具来完成一些功能。一些常见的功能可能已经有现成的 npm 包可以使用，但在特定的操作系统或平台上，可能需要使用一些特定的工具。@nodert-win8.1/windows.applicationmodel.contacts.provider 就是这样一款特定的 npm 包，它为开发者提供了在 Windows 平台上访问联系人信息的功能。下面是详细的使用教程。
安装
在项目中安装 @nodert-win8.1/windows.applicationmodel.contacts.provider：
npm install @nodert-win8.1/windows.applicationmodel.contacts.provider
用法
使用 @nodert-win8.1/windows.applicationmodel.contacts.provider 的第一步是创建一个新的实例对象：
const contactsProvider = require("@nodert-win8.1/windows.applicationmodel.contacts.provider");
const provider = new contactsProvider.Provider();查询联系人信息
获取所有联系人信息：
let contacts = await provider.getContacts();
获取在特定时间后添加到联系人列表中的联系人信息：
let startDate = new Date(2019,5,5);
let contacts = await provider.getContacts(new contactsProvider.ContactQueryOptions({
queryFilter: contactsProvider.ContactQuerySearchFields.displayName,
sortOrder: contactsProvider.ContactQuerySearchFields.givenName
},
startDate
));获取特定联系人 ID 的联系人信息：
let id = "contact:id"; let contacts = await provider.getContactById(id);
创建联系人信息
创建一个新的联系人信息：
let contact = new contactsProvider.Contact();
设置联系人的属性：
-- -------------------- ---- ------- --- ---- - --- ------------------------------- ---------------- - ----- -------------- - ---- --------------- - ---- ------------ - ----- --- ----- - --- -------------------------------- ------------- - ----------------------- ---------- - ------------------------------------------- ----------------------------- --- ----- - --- -------------------------------- ------------ - -------------- ---------- - ----------------------------------------- ----------------------------- --- ------- - --- ---------------------------------- --------------------- - ----- ------------ ------ ---------------- - ---------- ----------------------------------
将联系人信息保存到系统联系人列表中：
await provider.saveContact(contact);
删除联系人信息
删除特定联系人 ID 的联系人信息：
let id = "contact:id"; await provider.deleteContactById(id);
示例代码
-- -------------------- ---- -------
----- ---------------- - ---------------------------------------------------------------------
----- -------- - --- ----------------------------
----- -------- ------------- -
--- --------- - --- ---------------
--- -------- - ----- ------------------------ --------------------------------------
------------ ------------------------------------------------------
---------- ---------------------------------------------------
--
---------
---
----------------------
-
----- -------- --------------- -
--- ------- - --- ---------------------------
--- ---- - --- -------------------------------
---------------- - -----
-------------- - ----
--------------- - ----
------------ - -----
--- ----- - --- --------------------------------
------------- - -----------------------
---------- - -------------------------------------------
-----------------------------
--- ----- - --- --------------------------------
------------ - --------------
---------- - -----------------------------------------
-----------------------------
--- ------- - --- ----------------------------------
--------------------- - ----- ------------ ------
---------------- - ----------
----------------------------------
----- ------------------------------
-
----- -------- --------------- -
--- -- - -------------
----- -------------------------------
-
--------------
----------------
----------------总结
使用 @nodert-win8.1/windows.applicationmodel.contacts.provider 可以方便地访问 Windows 平台上的联系人信息，不论是查询联系人还是创建、删除联系人，都可以轻松完成。但由于它是特定于 Windows 平台的，所以在不同的操作系统上使用时需要注意兼容性问题。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bce967216659e244c18