前言
在开发前端应用程序时，我们通常需要向用户发送推送通知来获取他们的注意。而极光推送就是一个非常好的推送通知框架。getui-promise 是一款用于推送通知的 Node.js 库，它是一个对 GeTui（GTPush）推送 API 做出的异步封装，它使用 Promise 来提供更加方便、优雅的 API。
在本篇文章中，我们将介绍 getui-promise 的基本用法，以及如何使用它来实现推送通知的功能。并提供示例代码，帮助读者更好地理解和使用它。
模块安装
在使用 getui-promise 之前，我们首先需要在项目中安装它。因为该库是一个 npm 包，因此，我们可以使用下面的命令在我们的项目中安装 getui-promise：
$ npm install getui-promise
库的初始化
在使用 getui-promise 库之前，我们还需要引入它，并初始化它。我们可以使用下面的代码初始化 getui-promise：
const GeTui = require('getui-promise')
const config = {
appId: '', // 应用 appid
appKey: '', // 应用 appkey
appSecret: '', // 应用 appsecret
masterSecret: '' // 秘钥（master secret）
}
const geTui = new GeTui(config)在这个例子中，我们需要把 appId、appKey、appSecret 和 masterSecret 替换为我们应用程序的实际值。这些值都可以在 GeTui 后台管理系统中找到。
向单个设备发送通知
要向单个设备发送通知，我们需要使用 geTui.pushMessageToSingle() 方法。该方法需要一个 PushMessageToSingleRequest 类型的参数。该类型包含以下属性：
message: 这是一个IGtSingleMessage对象，它存放着要发送的消息内容。target: 这是一个IGtTarget对象，它指定了消息要发送的目标设备，可以是设备 ID 或别名。
下面是使用 geTui.pushMessageToSingle() 方法向单个设备发送推送通知的代码示例：
-- -------------------- ---- -------
----- ----------- - -
-------- --- ---------------------
------- -
------ -------
-------- ------ -------
-------- ------
-
---
------- --- --------------
------ -------------
--------- ----------------------------------
--
-
---------------------------------------------------- -- -
---------------------
-------------- -- -
--------------------
--在这个例子中，我们向设备 ID 为 "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 的设备发送了一条推送通知。通知内容为 "hello world"，标题为 "推送通知"。当该设备收到通知时，它将会携带 payload 为 "test" 的数据。
向指定列表设备批量发送通知
要向指定列表设备批量发送通知，我们需要使用 geTui.pushMessageToList() 方法。该方法需要一个 PushMessageToListRequest 类型的参数。该类型包含以下属性：
message: 这是一个IGtListMessage对象，它存放着要发送的消息内容。targets: 这是一个List对象，包含了消息要发送的目标设备，可以是设备 ID 或别名。
下面是使用 geTui.pushMessageToList() 方法向指定列表设备批量发送推送通知的代码示例：
-- -------------------- ---- -------
----- ----------- - -
-------- --- -------------------
------- -
------ -------
-------- ------ -------
-------- ------
-
---
-------- - --- --------------
------ -------------
--------- ----------------------------------
---
-
-------------------------------------------------- -- -
---------------------
-------------- -- -
--------------------
--在这个例子中，我们向设备 ID 为 "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 的设备发送了一条推送通知。通知内容为 "hello world"，标题为 "推送通知"。当该设备收到通知时，它将会携带 payload 为 "test" 的数据。
总结
本文详细介绍了 npm 包 getui-promise 的使用教程，包括库的初始化、向单个设备发送通知以及向指定列表设备批量发送通知等。我们希望本文能够帮助读者更好地理解和使用 getui-promise，以实现在前端应用程序中发送推送通知的功能。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055dc081e8991b448db7fa