Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://developer.mozilla.org/zh-CN/docs/Web/API/Notification/Notification below:

Notification：Notification() æž„é€ å‡½æ•° - Web API

Limited availability

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

备注： 此特性在 Web Worker 中可用。

Notification() 构造函数创建一个新的代表用户通知的 Notification 对象实例。

备注： 尝试在 ServiceWorkerGlobalScope 中使用 Notification() 构造函数创建通知将抛出 TypeError，应该使用 ServiceWorkerRegistration.showNotification()。

new Notification(title)
new Notification(title, options)

title

定义一个通知的标题，它将显示在通知窗口的顶部。

options 可选

一个包含要应用于通知的任何自定义设置的选项对象。可能的选项有：

actions 可选

必须未指定或为空数组。actions 仅支持使用 ServiceWorkerRegistration.showNotification() 从 service worker 触发的持久通知。

badge 可选

一个包含图像 URL 的字符串，用于在没有足够空间显示通知本身时表示通知；例如，Android 通知栏。在 Android 设备上，徽章应适应高达 4 倍分辨率的设备，大约 96x96px，并且图像将被自动遮罩。

body 可选

一个表示通知正文的字符串，显示在标题下方，默认值是一个空字符串。

data 可选

任意你想要与通知关联的数据。它可以是任何可结构化克隆的数据类型。默认值为 null。

dir 可选

显示通知的方向。它默认为 auto，即只采用浏览器的语言设置行为，但你可以通过设置 ltr 和 rtl 的值来覆盖该行为（尽管大多数浏览器似乎忽略这些设置）。

icon 可选

一个包含要在通知中显示的图标的 URL 的字符串。

image 可选

一个包含要在通知中显示的图像的 URL 的字符串。

lang 可选

指定通知的语言，根据 RFC 5646: 识别语言的标签（也被称为 BCP47）使用表示语言标签的字符串指定。请参阅 Sitepoint ISO 2 字母语言代码页面以获取简单参考。默认值为空字符串。

renotify 可选

一个布尔值，指定在新通知替换旧通知后是否应通知用户。默认值为 false，这意味着用户不会收到通知。如果该值被指定为 true，那么必须同时设置 tag 参数。

requireInteraction 可选

指示通知应保持活动状态，直到用户单击或关闭它，而不是自动关闭。默认值为 false。

silent 可选

一个布尔值，指定通知是否应为静音，即，无论设备设置如何，都不应发出声音或振动。如果设置为 true，则通知为静音；如果设置为 null（默认值），则遵循设备的默认设置。

tag 可选

一个表示通知的识别标签的字符串，默认值是一个空字符串。

timestamp 可选

一个以毫秒为单位表示为 Unix 时间的时间戳，表示与通知相关的时间。当通知用于发送由于设备离线而无法立即发送的消息时，该时间戳可能是过去的时间，或者用于即将开始的会议的未来时间。

vibrate 可选

设备振动硬件随通知一起发出的振动模式。当该值被指定时，silent 参数不得设置为 true。

一个 Notification 实例对象。

TypeError

如果满足以下条件之一，则抛出该异常：

• 构造函数在 ServiceWorkerGlobalScope 上下文中调用。
• actions 选项被指定且不为空。
• silent 选项是 true 且 vibrate 选项被同时指定。
• renotify 选项是 true 但是 tag 选项为空值。

DataCloneError DOMException

若由于某种原因序列化 data 选项失败，则抛出该异常。

这是一个最基本的示例，仅在已授予权限时才显示通知。有关更完整的示例，请参阅 Notification 页面。

if (Notification.permission === "granted") {
  const notification = new Notification("你好呀！");
}

从 Chrome 49 开始，通知在无痕模式下不起作用。

Android 版 Chrome 会在调用 Notification 构造函数时抛出 TypeError。它仅支持从 Service Worker 中创建通知。有关更多详细信息，请参阅 Chromium 问题跟踪器。

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4