PushMessageData

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 PushMessageData Interface des Push API bietet Methoden, mit denen Sie die vom Server gesendeten Push-Daten in verschiedenen Formaten abrufen können.

Im Gegensatz zu den ähnlichen Methoden im Fetch API, die es nur erlauben, die Methode einmal aufzurufen, können diese Methoden mehrfach aufgerufen werden.

Nachrichten, die über das Push API empfangen werden, werden von Push-Diensten verschlüsselt gesendet und dann automatisch von Browsern entschlüsselt, bevor sie über die Methoden des PushMessageData Interfaces zugänglich gemacht werden.

Instanz-Eigenschaften

Keine.

Instanz-Methoden

PushMessageData.arrayBuffer()

Extrahiert die Daten als ein ArrayBuffer Objekt.

PushMessageData.blob()

Extrahiert die Daten als ein Blob Objekt.

PushMessageData.bytes()

Extrahiert die Daten als ein Uint8Array Objekt.

PushMessageData.json()

Extrahiert die Daten als ein JSON Objekt.

PushMessageData.text()

Extrahiert die Daten als einfacher Textstring.

Beispiele

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

  if (obj.action === "subscribe" || obj.action === "unsubscribe") {
    fireNotification(obj, event);
    port.postMessage(obj);
  } else if (obj.action === "init" || obj.action === "chatMsg") {
    port.postMessage(obj);
  }
});

Spezifikationen

Specification
Push API
# pushmessagedata-interface

Browser-Kompatibilität

BCD tables only load in the browser