NotificationEvent

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

Das NotificationEvent Interface der Notifications API repräsentiert ein Benachrichtigungsereignis, das im ServiceWorkerGlobalScope eines ServiceWorker ausgelöst wird.

Dieses Interface erbt vom ExtendableEvent Interface.

Hinweis: Nur persistente Benachrichtigungsereignisse, die im ServiceWorkerGlobalScope Objekt ausgelöst werden, implementieren das NotificationEvent Interface. Nicht-persistente Benachrichtigungsereignisse, die im Notification Objekt ausgelöst werden, implementieren das Event Interface.

Event ExtendableEvent NotificationEvent

Konstruktor

NotificationEvent()

Erstellt ein neues NotificationEvent-Objekt.

Instanz-Eigenschaften

Erbt auch Eigenschaften von seinem Eltern-Interface, ExtendableEvent.

NotificationEvent.notification Nur lesbar

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

NotificationEvent.action Nur lesbar

Gibt die Zeichenfolgen-ID des Benachrichtigungsschalters zurück, den der Benutzer angeklickt hat. Dieser Wert gibt eine leere Zeichenfolge zurück, wenn der Benutzer die Benachrichtigung an einer anderen Stelle als auf einer Aktionstaste angeklickt hat oder die Benachrichtigung keine Taste hat.

Instanz-Methoden

Erbt auch Methoden von seinem Eltern-Interface, ExtendableEvent.

Beispiel

js
self.addEventListener("notificationclick", (event) => {
  console.log(`On notification click: ${event.notification.tag}`);
  event.notification.close();

  // This looks to see if the current is already open and
  // focuses if it is
  event.waitUntil(
    clients
      .matchAll({
        type: "window",
      })
      .then((clientList) => {
        for (const client of clientList) {
          if (client.url === "/" && "focus" in client) return client.focus();
        }
        if (clients.openWindow) return clients.openWindow("/");
      }),
  );
});

Spezifikationen

Specification
Notifications API Standard
# notificationevent

Hinweis: Dieses Interface ist in der Notifications API spezifiziert, wird aber über ServiceWorkerGlobalScope aufgerufen.

Browser-Kompatibilität

BCD tables only load in the browser