ServiceWorkerGlobalScope: notificationclose-Ereignis

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

Hinweis: Dieses Feature ist nur verfügbar in Service Workers.

Das notificationclose-Ereignis des ServiceWorkerGlobalScope-Interfaces tritt ein, wenn ein Benutzer eine angezeigte Benachrichtigung schließt, die durch ServiceWorkerRegistration.showNotification() erzeugt wurde.

Benachrichtigungen, die im Haupt-Thread oder in Workern, die keine Service-Worker sind, mithilfe des Notification()-Konstruktors erstellt wurden, erhalten stattdessen ein close-Ereignis auf dem Notification-Objekt selbst.

Dieses Ereignis kann nicht abgebrochen werden und löst keine Bubbling-Effekte aus.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Event-Handler-Eigenschaft fest.

js
addEventListener("notificationclose", (event) => {});

onnotificationclose = (event) => {};

Ereignistyp

Ein NotificationEvent. Erbt von ExtendableEvent und Event.

Event ExtendableEvent NotificationEvent

Ereigniseigenschaften

Erbt Eigenschaften von seinen Vorfahren, ExtendableEvent und Event.

NotificationEvent.notification Nur lesbar

Gibt ein Notification-Objekt zurück, das die Benachrichtigung darstellt, die angeklickt wurde, um das Ereignis auszulösen.

NotificationEvent.action Nur lesbar

Gibt die stringbasierte ID des Benachrichtigungsbuttons zurück, den der Benutzer angeklickt hat. Dieser Wert ist ein leerer String, wenn der Benutzer die Benachrichtigung an einer Stelle angeklickt hat, die kein Aktionsbutton ist, oder wenn die Benachrichtigung keinen Button hat.

Beispiel

js
// Inside a service worker.
self.onnotificationclose = (event) => {
  console.log("On notification close: ", event.notification.tag);
};

Spezifikationen

Specification
Notifications API Standard
# dom-serviceworkerglobalscope-onnotificationclose

Browser-Kompatibilität

BCD tables only load in the browser