Notification.Notification()

这篇翻译不完整。请帮忙从英语翻译这篇文章

Notification() 构造函数创建一个新的Notification对象实例。

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

语法

let myNotification = new Notification(title, options);

参数

title
定义一个通知的标题,当它被触发时,它将显示在通知窗口的顶部。
options 可选
options对象包含应用于通知的任何自定义设置选项。选项有:
  • dir: 显示通知的方向。默认是auto,跟随浏览器语言设置行为,你也可以通过设置ltr和rtl的值来覆盖该行为(虽然大多数浏览器似乎忽略这些设置)
  • lang: 通知的语言,如使用代表一个BCP 47语言标签的  DOMString 指定的。请参阅Sitepoint ISO 2字母语言代码页面,以获得简单的参考。
  • badge: 一个 USVString 包含用于表示通知的图像的URL, 当没有足够的空间来显示通知本身时。
  • body: 一个 DOMString 表示通知的正文,将显示在标题下方。
  • tag:  一个 DOMString 代表通知的 一个识别标签。
  • icon:  一个 USVString 包含要在通知中显示的图标的URL。
  • image: 一个 USVSTring包含要在通知中显示的图像的URL。
  • data: 您想要与通知相关联的任意数据。这可以是任何数据类型。
  • vibrate: 一个振动模式 vibration pattern 设备的振动硬件在通知触发时发出。
  • renotify: 一个 Boolean 指定在新通知替换旧通知后是否应通知用户。默认值为false,这意味着它们不会被通知。
  • requireInteraction: 表示通知应保持有效,直到用户点击或关闭它,而不是自动关闭。默认值为false。

以下选项列在最新规范中,但在任何浏览器中都不支持. It is advisable to keep checking back regularly to see if the status of these has updated, and let us know if you find any out of date information.

  • silent: 一个 Boolean 指明通知是否应该是无声的,即,不需要发出声音或振动,无论设备设置如何。默认值为false,这意味着它不会保持静默。
  • sound:一个 USVString 包含通知触发时要播放的音频文件的URL。
  • noscreen: 一个 Boolean 指定通知触发是否应启用设备的屏幕。 默认值为false,这意味着它将启用屏幕。
  • sticky: 一个 Boolean 指明通知是否应该是“粘”, 即不易被用户清理。默认值为false,这意味着它不会粘。

 

Example

In our Emogotchi demo (see source code), we run a simple spawnNotification() function when we want to fire a notification — this is passed arguments to specify the body, icon and title we want, then it creates the necessary options object and fires the notification using the Notification() constructor.

function spawnNotification(theBody,theIcon,theTitle) {
  var options = {
      body: theBody,
      icon: theIcon
  }
  var n = new Notification(theTitle,options);

}

Specifications

Specification Status Comment
Notifications API
Notification()
Living Standard Initial definition.

Browser compatibility

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!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 5 webkit (see notes)
22
4.0 moz (see notes)
22
未实现 25 6 (see notes)
Available in workers ? 41.0 (41.0) ? ? ?
icon option 5 webkit (see notes)
22
4.0 moz (see notes)
22
未实现 25 未实现
vibrate 45.0 未实现 未实现 未实现 未实现
requireInteraction 47.0     32  
renotify 50.0        
badge 53.0     39.0  
image 55.0     ?  
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ?

(Yes)

4.0 moz (see notes)
22
1.0.1 moz (see notes)
1.2
未实现 ? 未实现

(Yes)

Available in workers ? ? 41.0 (41.0) ? ? ? ? ?
icon option ? (Yes) 4.0 moz (see notes)
22
1.0.1 moz (see notes)
1.2
未实现 ? 未实现 (Yes)
vibrate 未实现 45.0 未实现 未实现 未实现 32 未实现 45.0
requireInteraction 未实现 未实现           未实现
renotify 未实现 未实现           50.0
badge 未实现 53.0       39.0   53.0
image 未实现 未实现       ?   55.0

Firefox OS notes

Chrome notes

Starting in Chrome 49, notifications do not work in incognito mode.

Safari notes

See also

文档标签和贡献者

此页面的贡献者: xgqfrms-GitHub, Jiang-Xuan, fengwuxin
最后编辑者: xgqfrms-GitHub,