ServiceWorkerRegistration: getNotifications() 方法

安全上下文: 此功能仅在 安全上下文(HTTPS)中,以及部分或所有 支持的浏览器 中可用。

注意: 此功能在 Web Workers 中可用。

getNotifications() 方法是 ServiceWorkerRegistration 接口的方法,它返回一个列表,其中包含当前来源通过当前 Service Worker 注册创建的通知,按创建顺序排列。来源可以拥有许多处于活动状态但范围不同的 Service Worker 注册。一个 Service Worker 在同一来源创建的通知对同一来源的其他活动 Service Worker 是不可用的。

语法

js
getNotifications()
getNotifications(options)

参数

options 可选

包含用于筛选返回的通知的选项的对象。可用选项为

tag 可选

表示通知标签的字符串。如果指定,则仅返回具有此标签的通知。

返回值

一个 Promise,它解析为一个 Notification 对象列表。

示例

js
navigator.serviceWorker.register("sw.js");

const options = { tag: "user_alerts" };

navigator.serviceWorker.ready.then((registration) => {
  registration.getNotifications(options).then((notifications) => {
    // do something with your notifications
  });
});

规范

规范
通知 API 标准
# dom-serviceworkerregistration-getnotifications

浏览器兼容性

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