PushEvent

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: Dieses Feature ist nur verfügbar in Service Workers.

Das PushEvent-Interface der Push-API repräsentiert eine empfangene Push-Nachricht. Dieses Ereignis wird an den globalen Bereich eines ServiceWorker gesendet. Es enthält die Informationen, die von einem Anwendungsserver an ein PushSubscription gesendet wurden.

Event ExtendableEvent PushEvent

Konstruktor

PushEvent()

Erstellt ein neues PushEvent-Objekt.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, ExtendableEvent. Zusätzliche Eigenschaften:

PushEvent.data Nur lesbar

Gibt eine Referenz auf ein PushMessageData-Objekt zurück, das Daten enthält, die an das PushSubscription gesendet wurden.

Instanz-Methoden

Erbt Methoden von seinem Elternteil, ExtendableEvent.

Beispiele

Das folgende Beispiel entnimmt Daten aus einem PushEvent und zeigt diese auf allen Clients des Service Workers an.

js
self.addEventListener("push", (event) => {
  if (!(self.Notification && self.Notification.permission === "granted")) {
    return;
  }

  const data = event.data?.json() ?? {};
  const title = data.title || "Something Has Happened";
  const message =
    data.message || "Here's something you might want to check out.";
  const icon = "images/new-notification.png";

  const notification = new self.Notification(title, {
    body: message,
    tag: "simple-push-demo-notification",
    icon,
  });

  notification.addEventListener("click", () => {
    clients.openWindow(
      "https://example.blog.com/2015/03/04/something-new.html",
    );
  });
});

Spezifikationen

Specification
Push API
# pushevent-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch