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 von der aktuellen Herkunft über die aktuelle Service Worker-Registrierung erstellt wurden. Herkünfte können viele aktive, aber unterschiedlich abgestufte Service Worker-Registrierungen haben. Benachrichtigungen, die von einem Service Worker auf derselben Herkunft erstellt wurden, stehen anderen aktiven Service Workern auf derselben Herkunft nicht zur Verfügung.

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 eine Benachrichtigungstag repräsentiert. Wenn angegeben, werden nur Benachrichtigungen mit diesem Tag zurückgegeben.

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