ServiceWorkerRegistration: getNotifications() Methode

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

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 Standard
# dom-serviceworkerregistration-getnotifications

Browser-Kompatibilität

BCD tables only load in the browser