ServiceWorkerRegistration: getNotifications() Methode

Baseline 2023
Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die getNotifications()-Methode der ServiceWorkerRegistration-Schnittstelle gibt eine Liste der Benachrichtigungen in der Reihenfolge zurück, in der sie vom aktuellen Ursprung über die aktuelle Service Worker-Registrierung erstellt wurden. Ursprünge können viele aktive, aber unterschiedlich gescopte Service Worker-Registrierungen haben. Benachrichtigungen, die von einem Service Worker am selben Ursprung erstellt wurden, werden anderen aktiven Service Workern an demselben Ursprung nicht zur Verfügung stehen.

Syntax

js
getNotifications()
getNotifications(options)

Parameter

options Optional

Ein Objekt, das Optionen zum Filtern der zurückgegebenen Benachrichtigungen enthält. Die verfügbaren Optionen sind:

tag Optional

Ein String, der einen Benachrichtigungstag darstellt. Wenn angegeben, werden nur Benachrichtigungen zurückgegeben, die dieses Tag haben.

Rückgabewert

Ein Promise, das zu einer Liste von Notification-Objekten aufgelöst wird.

Beispiele

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
  });
});

Spezifikationen

Specification
Notifications API
# dom-serviceworkerregistration-getnotifications

Browser-Kompatibilität