跳到主要内容

Notification

创建操作系统桌面通知

进程：主进程

渲染进程通知

如果您想从渲染进程显示通知，则应使用 web Notifications API

类：Notification​

创建操作系统桌面通知

进程：主进程

Notification 是一个 EventEmitter。

它使用 options 设置的本机属性创建一个新的 Notification。

静态方法​

Notification 类具有以下静态方法

Notification.isSupported()​

返回 boolean - 桌面通知是否在当前系统上受支持

new Notification([options])​

  • options 对象 (可选)
    • title 字符串 (可选) - 通知的标题，显示时将显示在通知窗口的顶部。
    • subtitle 字符串 (可选) macOS - 通知的副标题，将显示在标题下方。
    • body 字符串 (可选) - 通知的正文文本，将显示在标题或副标题下方。
    • silent 布尔值 (可选) - 是否在显示通知时禁止操作系统通知声音。
    • icon (字符串 | NativeImage) (可选) - 通知中使用的图标。 如果传递字符串，则它必须是本地图标文件的有效路径。
    • hasReply 布尔值 (可选) macOS - 是否向通知添加内联回复选项。
    • timeoutType 字符串 (可选) Linux Windows - 通知的超时持续时间。 可以是“default”或“never”。
    • replyPlaceholder 字符串 (可选) macOS - 要写入内联回复输入字段的占位符。
    • sound 字符串 (可选) macOS - 显示通知时播放的声音文件的名称。
    • urgency 字符串 (可选) Linux - 通知的紧急程度级别。 可以是“normal”、“critical”或“low”。
    • actions NotificationAction[] (可选) macOS - 要添加到通知的操作。 请阅读 NotificationAction 文档中提供的操作和限制。
    • closeButtonText 字符串 (可选) macOS - 警报的关闭按钮的自定义标题。 空字符串将导致使用默认的本地化文本。
    • toastXml 字符串 (可选) Windows - Windows 上 Notification 的自定义描述，取代上面的所有属性。 提供通知的设计和行为的完全自定义。

实例事件​

使用 new Notification 创建的对象会发出以下事件

信息

某些事件仅在特定的操作系统上可用，并已如此标记。

事件：'show'​

返回

  • event 事件

当通知显示给用户时发出。 请注意，此事件可能会多次触发，因为可以通过 show() 方法多次显示通知。

事件：'click'​

返回

  • event 事件

当用户单击通知时发出。

事件：'close'​

返回

  • event 事件

当用户手动干预关闭通知时发出。

并非在所有通知关闭的情况下都保证会发出此事件。

在 Windows 上，close 事件可以通过以下三种方式之一发出：通过 notification.close() 以编程方式关闭、由用户关闭通知或通过系统超时。 如果通知在初始 close 事件发出后仍在操作中心，则调用 notification.close() 将从操作中心删除通知，但不会再次发出 close 事件。

事件：'reply' macOS​

返回

  • event 事件
  • reply 字符串 - 用户在内联回复字段中输入的字符串。

当用户单击 hasReply: true 的通知上的“回复”按钮时发出。

事件：'action' macOS​

返回

  • event 事件
  • index 数字 - 已激活的操作的索引。

事件：'failed' Windows​

返回

  • event 事件
  • error 字符串 - 在执行 show() 方法期间遇到的错误。

当在创建和显示本机通知时遇到错误时发出。

实例方法​

使用 new Notification() 构造函数创建的对象具有以下实例方法

notification.show()​

立即向用户显示通知。 与 web notification API 不同，实例化 new Notification() 不会立即向用户显示通知。 相反，您需要在操作系统显示通知之前调用此方法。

如果通知之前已显示，则此方法将关闭先前显示的通知，并创建一个具有相同属性的新通知。

notification.close()​

关闭通知。

在 Windows 上，当通知在屏幕上可见时调用 notification.close() 将关闭通知并将其从操作中心删除。 如果在通知不再在屏幕上可见后调用 notification.close()，则调用 notification.close() 将尝试将其从操作中心删除。

实例属性​

notification.title​

一个 string 属性，表示通知的标题。

notification.subtitle​

一个 string 属性，表示通知的副标题。

notification.body​

一个 string 属性，表示通知的正文。

notification.replyPlaceholder​

一个 string 属性，表示通知的回复占位符。

notification.sound​

一个 string 属性，表示通知的声音。

notification.closeButtonText​

一个 string 属性，表示通知的关闭按钮文本。

notification.silent​

一个 boolean 属性，表示通知是否静音。

notification.hasReply​

一个 boolean 属性，表示通知是否具有回复操作。

notification.urgency Linux​

一个 string 属性，表示通知的紧急程度级别。 可以是“normal”、“critical”或“low”。

默认为 'low' - 有关更多信息，请参阅 NotifyUrgency。

notification.timeoutType Linux Windows​

一个 string 属性，表示通知的超时持续时间类型。 可以是“default”或“never”。

如果 timeoutType 设置为“never”，则通知永不过期。 它会一直保持打开状态，直到被调用 API 或用户关闭。

notification.actions​

一个 NotificationAction[] 属性，表示通知的操作。

notification.toastXml Windows​

一个 string 属性，表示通知的自定义 Toast XML。

播放声音​

在 macOS 上，您可以指定要在显示通知时播放的声音的名称。 除了自定义声音文件外，还可以使用任何默认声音（在“系统偏好设置”>“声音”下）。 确保声音文件已复制到应用捆绑包下（例如，YourApp.app/Contents/Resources），或以下位置之一

  • ~/Library/Sounds
  • /Library/Sounds
  • /Network/Library/Sounds
  • /System/Library/Sounds

有关更多信息，请参阅 NSSound 文档。