通知

使用底层操作系统的通知机制向用户显示通知。由于此 API 使用操作系统的通知机制,因此通知的显示方式和行为细节可能因操作系统和用户的设置而异。

在 macOS 上,通知看起来像这样

Example notification on macOS, located below the system clock, with a bold title reading "Click notification" followed by regular text reading "You clicked https://mdn.org.cn/en-US/docs/MDN". The notification has the Firefox Nightly logo on the left side, and a link icon on the right.

在 Windows 上,通知会保留在“操作中心”中,直到浏览器关闭。通知看起来像这样

Example notification on Windows 10, located above the system clock, with a bold title reading "Click notification" followed by regular text reading "You clicked https://mdn.org.cn/en-US/docs/MDN". The notification has a small Firefox logo in the top left corner that is followed by "Mozilla Firefox", and a link icon to the left of the primary notification text.

要使用此 API,您需要拥有“通知”权限

类型

notifications.NotificationOptions

定义通知的内容。

notifications.TemplateType

通知的类型。例如,这定义了通知是否可以包含图像。

函数

notifications.clear()

清除特定通知,给出其 ID。

notifications.create()

创建并显示新通知。

notifications.getAll()

获取所有通知。

notifications.update()

更新通知。

事件

notifications.onButtonClicked

当用户点击通知中的按钮时触发。

notifications.onClicked

当用户点击通知但不是按钮时触发。

notifications.onClosed

当通知关闭时触发,无论是系统关闭还是用户关闭。

notifications.onShown

通知显示后立即触发。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

示例扩展