大网数据广告活动
Web 标准与前端开发

Notifications API

· 52CE 我爱测

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

Web Notifications

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

概念和用法

在受支持的平台上,显示系统通知通常涉及两件事。首先,用户需要授予当前来源显示系统通知的权限,这通常在应用或网站初始化时使用 Notification.requestPermission_static 方法完成。仅应在处理用户手势(例如处理鼠标点击时)时调用此方法。例如:

btn.addEventListener("click", () => {
  let promise = Notification.requestPermission();
  // 等待授权
});

这将产生一个请求对话框,内容如下:

一个对话框,要求用户允许来自该源的通知。有一些选项可以禁止或允许通知

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

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

此外,Notifications API 规范对 ServiceWorker API 指定了多个扩展,以允许 Service Worker 发送通知。

[!NOTE] 想了解怎么在你的应用里使用通知接口,请阅读使用 Notifications API。

接口

  • Notification
    • : 定义的通知对象。
  • NotificationEvent
    • : 表示在 ServiceWorker 的 ServiceWorkerGlobalScope 上下文中触发的通知事件。

其他接口的扩展

  • ServiceWorkerGlobalScope/notificationclick_event 事件
    • : 当用户单击显示的通知时触发。
  • ServiceWorkerGlobalScope/notificationclose_event 事件
    • : 当用户关闭显示的通知时触发。
  • ServiceWorkerRegistration.getNotifications()
    • : 按照通过当前 Service Worker 从当前源创建的通知的顺序返回通知列表。
  • ServiceWorkerRegistration.showNotification()
    • : 显示带有请求的标题的通知。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。