ServiceWorkerGlobalScope: push-Ereignis

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.

Das push-Ereignis wird an den globalen Kontext eines Service Workers gesendet (repräsentiert durch das ServiceWorkerGlobalScope-Interface), wenn der Service Worker eine Push-Nachricht empfangen hat.

Dieses Ereignis kann nicht abgebrochen werden und es blubbert nicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("push", (event) => { })

onpush = (event) => { }

Ereignistyp

Ein PushEvent. Erbt von Event.

Event ExtendableEvent PushEvent

Ereigniseigenschaften

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

PushEvent.data Schreibgeschützt

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

Beispiel

Dieses Beispiel richtet einen Handler für push-Ereignisse ein, der JSON-Daten entgegennimmt, sie analysiert und die Nachricht zur Weiterverarbeitung basierend auf den im Nachrichtentext enthaltenen Informationen weiterleitet.

js
self.addEventListener(
  "push",
  (event) => {
    let message = event.data.json();

    switch (message.type) {
      case "init":
        doInit();
        break;
      case "shutdown":
        doShutdown();
        break;
    }
  },
  false,
);

Spezifikationen

Specification
Push API
# extensions-to-the-serviceworkerglobalscope-interface
Push API
# dom-serviceworkerglobalscope-onpush

Browser-Kompatibilität

Siehe auch