Notifications API - Web API 接口参考 编辑

Notifications API 允许网页控制向最终用户显示系统通知 —这些都在顶级浏览上下文视口之外，因此即使用户已经切换标签页或移动到不同的应用程序，也可以显示。该API被设计成与不同平台上的现有通知系统兼容。

概念和用法

在支持该接口的平台上，显示一个系统通知通常涉及两件事。首先，用户需要授予当前源的权限以显示系统通知，这通常在应用或站点初始化时, 使用Notification.requestPermission() 方法来完成。

这将产生一个请求对话框，沿着以下几行：

从这里，用户可以选择允许来自此来源的通知，阻止来自此来源的通知，或不选择此点。一旦做出选择，该设置通常将持续用于当前会话。

注：从Firefox 44开始， 通知（Notifications） 和推送（Push）的权限已合并。如果为通知授予权限，推送也将启用。

接下来，使用 Notification() 构造函数创建一个新通知。这个方法可以传入两个参数。这必须传递一个标题参数，并可以选择性地传递一个选项对象来指定选项，如文本方向，正文，显示图标，通知声音播放, 等等。

Note: 此特性在 Web Worker 中可用。

此外， Notifications API 规范对  ServiceWorker API指定了多个添加，以允许 service workers发送通知。

注：想了解怎么在你的应用里使用通知接口，请阅读  Using the Notifications API。

接口（Notifications interfaces）

Notification

定义的通知对象

附加参数（Service worker additions）

ServiceWorkerRegistration

该对象包含 ServiceWorkerRegistration.showNotification() 和 ServiceWorkerRegistration.getNotifications() 方法，用于控制通知的显示。

ServiceWorkerGlobalScope

该对象包含 ServiceWorkerGlobalScope.onnotificationclick 事件处理函数，用于通知被点击的时候触发绑定的事件处理函数。

NotificationEvent

该对象是功能明确的事件对象，表示一个通知事件被触发了，继承自ExtendableEvent。

官方文档

Specification	Status	Comment
Notifications API	Living Standard	Living standard

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	5webkit[1] 22	4.0 (2.0)moz[2] 22.0 (22.0)	未实现	25	6[3]
Available in workers	?	41.0 (41.0)	?	?	?
Service worker additions	42.0	42.0 (42.0)[4]	?	?	?

Feature	Android	Android Webview	Firefox Mobile (Gecko)	Firefox OS	IE Mobile	Opera Mobile	Safari Mobile	Chrome for Android
Basic support	?	(Yes)	4.0 (2.0)moz[2] 22.0 (22.0)	1.0.1moz[2] 1.2	未实现	?	未实现	(Yes)
Available in workers	?	?	41.0 (41.0)	(Yes)	?	?	?	?
Service worker additions	未实现	未实现	42.0 (42.0)[4]	(Yes)	?	?	?	42.0

[1] 在 Chrome 22 之前, 通知接口遵守一个旧版本的提案（an old prefixed version of the specification ）使用一个包含前缀符的navigator.webkitNotifications 对象来实例化一个通知对象。 在 Chrome 32之前， Notification.permission属性不支持。

[2] 在 Firefox 22 (Firefox OS <1.2)之前，通知对象的实例化需要使用navigator.mozNotification 对象的 createNotification() 方法。另外，通知对象需要使用 show() 方法来显示，并且仅支持 click 和 close 事件 (Nick Desaulniers 写了一个通知的兼容解决方法（ a Notification shim ）来覆盖旧浏览器和现代浏览器。)

[3] Safari 从Safari 6开始支持通知，但只在 Mac OSX 10.8+ (Mountain Lion)上。

[4] Firefox 42 has shipped with web notifications from Service Workers disabled.

Firefox OS permissions

当你在 Firefox OS app中使用通知时，请确保在manifest文件中添加了desktop-notification 权限 。 Notifications can be used at any permission level, hosted or above:

"permissions": {
  "desktop-notification": {}
}

See also

• Using the Notifications API