PushEvent: data-Eigenschaft

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

Die schreibgeschützte Eigenschaft data des PushEvent-Interfaces gibt eine Referenz auf ein PushMessageData-Objekt zurück, das Daten enthält, die an die PushSubscription gesendet wurden.

Wert

Ein PushMessageData-Objekt oder null, wenn kein data-Mitglied beim Initialisieren der Ereignisinstanz übergeben wird.

Beispiele

Im folgenden Beispiel werden Daten von einem PushEvent genommen und allen Clients des Service Workers angezeigt.

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 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
# dom-pushevent-data

Browser-Kompatibilität

BCD tables only load in the browser